IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Ingest data to Elastic Security Install Elastic Endpoint manually »
Elastic Docs ›Elastic Security Solution [8.4] ›Get started with Elastic Security

Configure and install the Endpoint and Cloud Security integration

edit

Configure and install the Endpoint and Cloud Security integration

edit

Like other Elastic integrations, Endpoint and Cloud Security is integrated into the Elastic Agent using Fleet. Upon configuration, the integration allows the Elastic Agent to monitor events on your host and send data to the Elastic Security app.

Requirements

  • Fleet is required for Endpoint and Cloud Security.
  • To configure the Endpoint and Cloud Security integration on the Elastic Agent, you must have permission to use Fleet in Kibana.
  • You must have the superuser built-in user role to configure an integration policy and to access the Endpoints page in the Elastic Security app.

Before you begin

edit

If you’re using macOS, some versions may require you to grant Full Disk Access to different kernels, system extensions, or files. Refer to requirements for Elastic Endpoint if you’re installing the Elastic Endpoint or requirements for the Endgame sensor for more information.

Add the Endpoint and Cloud Security integration

edit

  1. Go to the Integrations page, which you can access in several ways:

    • In Kibana: Management → Integrations
    • In the Elastic Security app: Get started → Add security integrations
    Search result for "Endpoint and Cloud Security" on the Integrations page.

  2. Search for and select Endpoint and Cloud Security, then select Add Endpoint and Cloud Security. The integration configuration page appears.

    Add Endpoint and Cloud Security integration page
  3. Configure the Endpoint and Cloud Security integration with an Integration name and optional Description.
  4. Enter a name for the agent policy in New agent policy name. If other agent policies already exist, you can click the Existing hosts tab and select an existing policy instead. For more details on Elastic Agent configuration settings, refer to Elastic Agent policies.
  5. When the configuration is complete, click Save and continue.
  6. To complete the integration, continue to the next section to install the Elastic Agent on your hosts.

Configure and enroll the Elastic Agent

edit

To enable the Endpoint and Cloud Security integration, you must enroll agents in the relevant policy using Fleet.

Before you add an Elastic Agent, a Fleet Server must be running. Refer to Add a Fleet Server.

Endpoint and Cloud Security cannot be integrated with an Elastic Agent in standalone mode.

Important information about Fleet Server

edit

If you are running an Elastic Stack version earlier than 7.13.0, you can skip this section.

If you have upgraded to an Elastic Stack version that includes Fleet Server 7.13.0 or newer, you will need to redeploy your agents. Review the following scenarios to ensure you take the appropriate steps.

  • If you redeploy the Elastic Agent to the same machine through the Fleet application after you upgrade, a new agent will appear.
  • If you want to remove the Elastic Agent entirely without transitioning to the Fleet Server, then you will need to manually uninstall the Elastic Agent on the machine. This will also uninstall the endpoint. Refer to Uninstall Elastic Agent.
  • In the rare event that the Elastic Agent fails to uninstall, you might need to manually uninstall the endpoint. Refer to Uninstall an endpoint at the end of this topic.

Add the Elastic Agent

edit

  1. Go to Fleet → Agents → Add agent.

    Add agent flyout on the Fleet page.

  2. Select an agent policy for the Elastic Agent. You can select an existing policy, or select Create new agent policy to create a new one. For more details on Elastic Agent configuration settings, refer to Elastic Agent policies.

    The selected agent policy should include Endpoint and Cloud Security.

    Add agent flyout with Endpoint and Cloud Security integration highlighted.
  3. Ensure that the Enroll in Fleet option is selected. Endpoint and Cloud Security cannot be integrated with Elastic Agent in standalone mode.
  4. Select the appropriate platform or operating system for the host, then copy the provided commands.
  5. On the host, open a command-line interface and navigate to the directory where you want to install Elastic Agent. Paste and run the commands from Fleet to download, extract, enroll, and start Elastic Agent.
  6. (Optional) Return to the Add agent flyout in Fleet, and observe the Confirm agent enrollment and Confirm incoming data steps automatically checking the host connection. It may take a few minutes for data to arrive in Elasticsearch.

  7. After you have enrolled the Elastic Agent on your host, you can click View enrolled agents to access the list of agents enrolled in Fleet. Otherwise, select Close.

    The host will now appear on the Endpoints page in the Elastic Security app. It may take another minute or two for endpoint data to appear in Elastic Security.

  8. For macOS, continue with these instructions to grant Elastic Endpoint the access it needs.
« Ingest data to Elastic Security Install Elastic Endpoint manually »