Skip to main content

Specify Agent Server URL

Overview​

note

This procedure is optional for Linux agent v6.2, Windows agent v1.6, and later versions.

The Lacework agent uses a region-specific agent server URL to communicate with the Lacework platform. Lacework supports the following regions and URLs:

RegionURL
US (default)https://api.lacework.net
US-02 (US)https://aprodus2.agent.lacework.net
GPRODUS1 (US)https://agent.gprodus1.lacework.net
European Union (EU)https://api.fra.lacework.net
Australia and New Zealand (ANZ)https://auprodn1.agent.lacework.net

By default, agents use the https://api.lacework.net URL in the US region.

  • Starting with Linux agent v6.2 and Windows agent v1.6, it is optional for you to configure the agent server URL even if you install the agent outside the default region. The agent automatically discovers the agent server URL for your region. To automatically discover the agent server URL:
    • Linux agent v6.2 or later agents for which you have not configured the agent server URL will first communicate with https://api.lacework.net that is located in the US region to know the region they belong to, and then use only the region-specific URL.
    • Windows agent v1.6 or later agents for which you have not configured the agent server URL will first communicate with https://agent.lacework.net that is located in the US region to know the region they belong to, and then use only the region-specific URL.
    • The agents for which you have configured the agent server URL will first communicate with the configured server URL to know the region they belong to.
    Once the correct region is established, agents remember it and communicate only with the agent server URL for that region until you modify the URL.

Configure Agent Server URL​

You can configure the agent server URL in the Lacework Console or in the config.json agent configuration file.

Configure Agent Server URL in the Lacework Console (For Linux Agents Only)​

  1. Login to the Lacework Console.

  2. Go to Settings > Configuration > Agent Tokens.

  3. Click on the row for the token that the agent is using.

    The Access Token page appears.

  4. Click the Configure tab, then click the Edit icon Edit Icon.

  5. Click Agent administration settings.

  6. Specify the URL in the Agent server URL field.

Configure Agent Server URL in the config.json File (For both Linux and Windows Agents)​

You can configure the agent server URL using the serverurl property in the config.json file as shown below:

{ 
    "serverurl": "Your_Server_URL" 
}

Where Your_Server_URL is the agent server URL for your region.

Agent Server URL for Windows Server 2012 R2 and Windows Storage Server 2012 R2​

You must explicitly configure the agent server URL for Windows agents running on Windows Server 2012 R2 and Windows Storage Server 2012 R2.

Do the following to find the agent server URL to be used during installation:

  1. Login to the Lacework Console.

  2. Go to https://YourLacework.lacework.net/api/v1/profile/info.

    Replace YourLacework with your Lacework application name in the URL.

  3. Search for ENV_TYPE.

    If ENV_TYPE isUse the following agent server URL
    "ENV_TYPE":"prodn"https://api.lacework.net
    "ENV_TYPE":"aprodus2"https://aprodus2.agent.lacework.net
    "ENV_TYPE":"gprodus1"https://agent.gprodus1.lacework.net
    "ENV_TYPE":"euprodn"https://api.fra.lacework.net
    "ENV_TYPE":"auprodn1"https://auprodn1.agent.lacework.net
Last updated on