Skip to main content

Create Agent Access Tokens and Download Linux Agent Installers

You create agent access tokens and download the agent installers from the Lacework Console.

The Lacework agent requires a valid access token to successfully authenticate with the Lacework server (API endpoint). You can use the Lacework console to create a new access token or use an existing access token.

Create a New Access Token​

To create a new access token in the Lacework Console:

  1. In the Lacework Console, go to Settings > Configuration > Agent Tokens.

  2. Click + Add New.

  3. In the Name field, enter a unique name for the access token. You can use the agent access token name to logically separate your deployments, for example, by environment types (QA, Dev, etc.) or system types (CentOS, RHEL, etc.).

  4. In the Description field, you can optionally specify a description.

  5. Select Linux as the Operating System.

  6. Select the Lacework license subscription you want to associate with the token.

    Every Lacework license subscription has a default agent configuration that enables the features supported by the license subscription. The default configuration will be applied to all the agents that use that token.

    tip

    To know the license subscriptions for your Lacework account, go to Settings > License in the Lacework Console.

  7. Click Save to create the new access token.

  8. Verify the new token in the Agents list.

  9. Click the ... icon in the row for the new token and select Copy to copy the access token.

Use an Existing Access Token​

To use an existing access token from the Lacework Console:

  1. In the Lacework Console, go to Settings > Configuration > Agent Tokens.
  2. View the list of access tokens and sort by OS type (either Windows or Linux) under the OS column.
  3. Click the ... icon in the row for the access token you want to use to install the agent and select Copy to copy the access token. An access token can be re-used for multiple agent installations.

You can also create an agent access token via the Lacework API. For more information, see Access the Lacework API.

Install an Agent from the Lacework Console​

To install an agent from the Lacework Console:

  1. In the Lacework Console, go to Settings > Configuration > Agent Tokens.

  2. Click on the row for the access token you want to use to install the agent.

    The Access Token page appears.

  3. Click the Install tab.

  4. Click the script or package you want to install.

  5. Follow the instructions in the appropriate documentation at Install the Agent to install the agent.

Install an Agent from the Lacework Agent GitHub Repository​

To install an agent from the Lacework Agent GitHub repository:

  1. Download a release package (YourRelease.tgz file) from the Lacework Agent Release GitHub repository.
  2. Unpack the YourRelease.tgz file into a temporary directory such as /tmp.
  3. In the Lacework Console, go to Settings > Configuration > Agent Tokens and create a new access token or use an existing access token by following the instructions above.
  4. Click the ... icon in the row for the access token you want to use to install the agent and select Copy to copy the access token.
  5. Follow the instructions in the appropriate documentation at Install the Agent to install the agent.