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 Configure the Endpoint Security integration policy »
Elastic Docs ›Elastic Security Solution [7.16] ›Get started with Elastic Security

Configure and install the Endpoint Security integration

edit

Configure and install the Endpoint Security integration

edit

Like other Elastic integrations, Endpoint Security can be integrated into the Elastic Agent through Fleet. Upon configuration, the integration allows the Elastic Agent to monitor for events on your host and send data to the Elastic Security app.

To configure the Endpoint Security integration on the Elastic Agent, you must have permission to use Fleet in Kibana. You must also have admin permissions in Kibana 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. See Enable Full Disk Access for more information.

Add the Endpoint Security integration

edit

  1. In Kibana, select Security → Endpoints. If this is not your first time using Elastic Security, select Management → Integrations, then search for and select Endpoint Security.

    Search result for "Endpoint Security" on the Integrations page.

  2. Select Add Endpoint Security on either the Endpoints page of the Elastic Security app or the Endpoint Security integration page (Management → Integrations). The integration configuration page appears.

    Add Endpoint Security integration page.
  3. Configure the Endpoint Security integration with a name and optional description.
  4. Select an agent policy for the Elastic Agent. You can select the default policy, an existing custom policy, or select Create agent policy to create a new one. For more details on Elastic Agent configuration settings, see 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 configure the Elastic Agent, Endpoint Security requires enrollment through Fleet to enable the integration.

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

Important information about the new 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 the new Fleet Server (>=7.13.0), 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 agent on the machine. This will also uninstall the endpoint. See Uninstall Elastic Agent.
  • In the rare event that the Elastic Agent fails to uninstall, you might need to manually uninstall the endpoint. See Uninstall an endpoint at the end of this topic.

Endpoint Security cannot be integrated with an Elastic Agent in Standalone mode.

  1. Go to Fleet → Agents → Add agent.

    Add agent flyout on the Fleet page.
  2. In the Add agent pane, download the Elastic Agent on your host’s machine.

  3. After the download is complete, select the Endpoint Security integration.

    Detail of Add agent flyout with Endpoint Security integration highlighted.
  4. After the Elastic Agent is installed on your host machine, open a command-line interface and navigate to the directory where the agent is located. Copy the commands from Fleet for your OS to enroll and run the agent.
  5. After you have enrolled the Elastic Agent on your host, select Close. The host now appears on the Endpoints page in the Elastic Security app.

Enable Elastic Endpoint kernel

edit

If you are running the Elastic Agent with the Elastic Endpoint integrated on macOS 10.13, 10.14 and 10.15, you will be prompted to approve a kernel extension from "Endgame, Inc". To approve the extension:

  1. Select Open Security Preferences. The Security and Privacy pane opens.

    macOS notification with Open Security Preferences button highlighted.

  2. Select the Lock icon at the bottom left of the window to make changes to your security settings.

    Detail of Security and Privacy pane with Lock icon highlighted.

  3. Allow "Endgame, Inc" by clicking the Allow button.

    Security and Privacy pane with Allow button highlighted.

Endgame Sensor users can approve the kernel the same way for the Elastic Endgame app.

If the prompt does not appear because you’re using a version earlier than macOS Big Sur (11.0), enable the extension by doing the following:

  1. Open a Terminal application.
  2. Enter kextload /Library/Extension/kendpoint.kext. Prepend the command with sudo if necessary.
  3. To confirm the kernel extension has loaded, enter kextstat | grep co.elastic.kendpoint.
  4. You should receive an output similar to 149 0 0xffffff7f82e7b000 0x21000 0x21000 co.elastic.kendpoint (7.11.0) BD152A57-ABD3-370A-BBE8-D15A0FCBD19A <6 5 2 1>. If you receive this output, the kernel extension is enabled.

Configure an integration policy (optional)

edit

After the Elastic Agent is installed with the Endpoint Security integration, several protections features — including preventions against malware, ransomware, memory threats, and malicious behavior — are automatically enabled on protected hosts (a Platinum or Enterprise license feature). If needed, you can update the integration policy to configure protection settings, event collection, antivirus settings, and trusted applications to meet your organization’s security needs.

See Configure the Endpoint Security integration policy for more information on configuring these settings in an Endpoint Security integration policy.

« Ingest data to Elastic Security Configure the Endpoint Security integration policy »