Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] Updates install endpoint doc for Guided Onboarding epic #2569

Merged
merged 35 commits into from
Oct 18, 2022
Merged
Show file tree
Hide file tree
Changes from 19 commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
7af938d
Updates install endpoint doc for Guided Onboarding epic
benironside Oct 12, 2022
1c88101
tests alternative list structure
benironside Oct 13, 2022
170edc8
Experiment with nested lists
benironside Oct 13, 2022
9925e89
list experimentation
benironside Oct 13, 2022
43140c4
Updates list spacing
benironside Oct 13, 2022
5f7baf3
adjusts list spacing
benironside Oct 13, 2022
22fa476
Minor tweak
benironside Oct 13, 2022
d3b1b6e
troubleshoot list
benironside Oct 13, 2022
029db94
troubleshoot list
benironside Oct 13, 2022
b122236
troubleshoot list
benironside Oct 13, 2022
7263644
troubleshoot list
benironside Oct 13, 2022
51d86b9
list troubleshooting
benironside Oct 13, 2022
dfb4ee3
troubleshoot list
benironside Oct 13, 2022
a4ed753
same
benironside Oct 13, 2022
b126eaf
same
benironside Oct 13, 2022
2311856
same
benironside Oct 13, 2022
3dad159
Update docs/getting-started/install-endpoint.asciidoc
benironside Oct 13, 2022
6425c70
Update docs/getting-started/install-endpoint.asciidoc
benironside Oct 13, 2022
fa72162
list update
benironside Oct 13, 2022
43e15c5
replaces list with table
benironside Oct 17, 2022
c3aa570
fixes table bug
benironside Oct 17, 2022
df6c078
improves table format
benironside Oct 17, 2022
de0f0fb
table format update
benironside Oct 17, 2022
48e4879
Adds info about linux focus of Cloud Workload presets
benironside Oct 17, 2022
30087e6
fixes table
benironside Oct 17, 2022
ee36567
fixes bullet points in table
benironside Oct 18, 2022
0087f8f
fixes table bullets
benironside Oct 18, 2022
f618d4c
Incorporates Joe's feedback
benironside Oct 18, 2022
5d6f4cc
fixes bug
benironside Oct 18, 2022
1f23326
fixes minor bug
benironside Oct 18, 2022
55db8aa
Update docs/getting-started/install-endpoint.asciidoc
benironside Oct 18, 2022
15cede5
Update docs/getting-started/install-endpoint.asciidoc
benironside Oct 18, 2022
c39426d
Incorporates Janeen's feedback.
benironside Oct 18, 2022
0483873
Merge branch 'main' into issue-2457-big
benironside Oct 18, 2022
3b2ef82
Merge branch 'main' into issue-2457-big
benironside Oct 18, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
30 changes: 27 additions & 3 deletions docs/getting-started/install-endpoint.asciidoc
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[[install-endpoint]]
= Configure and install the {elastic-defend} integration

Like other Elastic integrations, {elastic-defend} can be integrated into the {agent} through {fleet-guide}/fleet-overview.html[{fleet}]. Upon configuration, the integration allows the {agent} to monitor for events on your host and send data to the {security-app}.
Like other Elastic integrations, {elastic-defend} can be integrated into the {agent} using {fleet-guide}/fleet-overview.html[{fleet}]. Upon configuration, the integration allows the {agent} to monitor for events on your host and send data to the {security-app}.
benironside marked this conversation as resolved.
Show resolved Hide resolved

NOTE: To configure the {elastic-defend} integration on the {agent}, you must have permission to use {fleet} in {kib}. You must also have admin permissions in {kib} to access the **Endpoints** page in the {security-app}.

Expand All @@ -18,7 +18,7 @@ If you're using macOS, some versions may require you to grant Full Disk Access t
. Go to the *Integrations* page, which you can access in several ways:

* In {kib}: *Management* -> *Integrations*
* In the {security-app}: *Get started* -> *Add security integrations*
* In the {security-app}: *Security homepage* -> *Add security integrations*
benironside marked this conversation as resolved.
Show resolved Hide resolved

+
[role="screenshot"]
Expand All @@ -30,8 +30,32 @@ image::images/install-endpoint/endpoint-cloud-sec-integrations-page.png[Search r
image::images/install-endpoint/endpoint-cloud-security-configuration.png[Add {elastic-defend} integration page,75%]
benironside marked this conversation as resolved.
Show resolved Hide resolved
+
. Configure the {elastic-defend} integration with an **Integration name** and optional **Description**.
. Select the type of environment you want to protect, either *Traditional Endpoints* or *Cloud Workloads*.
. Next, select a configuration preset. Each preset comes with different default settings for {agent} — you can further customize these later. To learn more, refer to {fleet-guide}/agent-policy.html[{agent} policies].
benironside marked this conversation as resolved.
Show resolved Hide resolved
+
For Traditional Endpoints, there are three presets:
benironside marked this conversation as resolved.
Show resolved Hide resolved
+
* *Next Generation Antivirus:*
- Events collected: Process
- Active preventions: Malware, Ransomware, Memory Protection
* *Essential Endpoint Detection & Response:*
- Events collected: Process, Network, File
- Active preventions: Malware, Ransomware, Memory Protection
* *Complete Endpoint Detection & Response:*
- Events collected: Process, Network, File, Session Data
- Active preventions: Malware, Ransomware, Memory Protection
+
For Cloud Workloads, there are two presets:
benironside marked this conversation as resolved.
Show resolved Hide resolved
+
* *All events:*
benironside marked this conversation as resolved.
Show resolved Hide resolved
- Events collected: Process, Network, File, Session Data
benironside marked this conversation as resolved.
Show resolved Hide resolved
- Preventions: none
* *Interactive only:*
- Events collected: Process, Network, File, Session Data
- Preventions: none
- Event filter: filters out non-interactive sessions
. 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 {agent} configuration settings, refer to {fleet-guide}/agent-policy.html[{agent} policies].
. When the configuration is complete, click **Save and continue**.
. When you're ready, click **Save and continue**.
benironside marked this conversation as resolved.
Show resolved Hide resolved
. To complete the integration, continue to the next section to install the {agent} on your hosts.

[discrete]
Expand Down