-
Notifications
You must be signed in to change notification settings - Fork 152
[Security] [Serverless: Oct 7] Automatic troubleshooting updates #3318
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
Open
natasha-moore-elastic
wants to merge
6
commits into
main
Choose a base branch
from
issue-2968-a-t
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+83
−54
Open
Changes from 4 commits
Commits
Show all changes
6 commits
Select commit
Hold shift + click to select a range
72a1faf
[Security] Automatic troubleshooting updates
natasha-moore-elastic 373b600
replace links
natasha-moore-elastic 22b5f14
adds redirect
natasha-moore-elastic 17a02a2
Merge branch 'main' into issue-2968-a-t
natasha-moore-elastic 74c7dd8
address feedback
natasha-moore-elastic fbea2f7
Update solutions/security/ai/use-cases.md
natasha-moore-elastic File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
76 changes: 76 additions & 0 deletions
76
solutions/security/manage-elastic-defend/automatic-troubleshooting.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,76 @@ | ||
--- | ||
mapped_pages: | ||
- https://www.elastic.co/guide/en/serverless/current/identify-third-party-av-products.html | ||
applies_to: | ||
stack: ga 9.2, preview 9.0 | ||
serverless: | ||
security: ga | ||
products: | ||
- id: security | ||
- id: cloud-serverless | ||
--- | ||
|
||
# Automatic troubleshooting | ||
|
||
Automatic troubleshooting helps you identify and resolve issues that could prevent {{elastic-defend}} from working as intended. This feature provides actionable insights into the following common problem areas: | ||
|
||
* {applies_to}`stack: ga 9.2` {applies_to}`serverless: ga` **Policy responses**: Detect warnings or failures in {{elastic-defend}}’s integration policies. | ||
* **Third-party antivirus (AV) software**: Identify installed third-party antivirus (AV) products that may conflict with {{elastic-defend}}. | ||
|
||
With these checks, you can resolve configuration errors, address incompatibilities, and ensure that your hosts remain protected. | ||
|
||
::::{admonition} Requirements | ||
To use this feature, you need: | ||
|
||
* In serverless, a project with the Security Analytics Complete [feature tier](https://www.elastic.co/pricing/serverless-security). | ||
* The **Automatic Troubleshooting: Read** or **Automatic Troubleshooting: All** security [sub-feature privilege](/solutions/security/configure-elastic-defend/elastic-defend-feature-privileges.md). | ||
:::{note} | ||
In {{stack}} 9.0.0, this privilege is called **Endpoint Insights**. | ||
::: | ||
* A working [LLM connector](../ai/set-up-connectors-for-large-language-models-llm.md) for AI Assistant. | ||
:::: | ||
|
||
## Troubleshoot policy issues | ||
```yaml {applies_to} | ||
stack: ga 9.2 | ||
serverless: ga | ||
``` | ||
{{elastic-defend}}'s integration policy statuses indicate whether protections are applied successfully to your hosts. Warnings or failures in these policies can weaken your security posture. Automatic troubleshooting helps you detect any issues and suggests remediation steps. | ||
::::{admonition} Requirements | ||
To use this functionality, you need to enable [AI Assistant Knowledge Base](/solutions/security/ai/ai-assistant-knowledge-base.md). | ||
:::: | ||
### Scan your hosts for policy issues | ||
1. Find **Endpoints** in the navigation menu or use the global search field. | ||
2. Click on an endpoint to open its details flyout. | ||
3. Under **Automatic Troubleshooting**, select an LLM connector, or [add](../ai/set-up-connectors-for-large-language-models-llm.md) a new one. | ||
4. If you don't already have AI Assistant Knowledge Base enabled, click **Setup Knowledge Base**. | ||
5. Once Knowledge Base is enabled, click **Scan**. After a brief processing period, any detected warnings or failures in policy responses will appear under **Insights**. | ||
### Resolve policy issues | ||
After a scan has completed, automatic troubleshooting suggests recommended next steps for each policy issue. These may include adjusting specific {{elastic-defend}} policy settings or reviewing conflicting host configurations. Click **Learn more** to the right of a result to open Elastic documentation, which provides more context and guidance for resolving the issue. | ||
|
||
## Identify antivirus software on your hosts [identify-third-party-av-products] | ||
Third-party antivirus software installed on your hosts can interfere with {{elastic-defend}}. To mitigate issues with running third-party AV alongside {{elastic-defend}}, you first have to identify which AV is present. | ||
After you’ve installed {{elastic-defend}} on one or more hosts, you can use automatic troubleshooting to check whether your endpoints have third-party AV software installed. Using the same kinds of large language model (LLM) connectors as Elastic AI Assistant, automatic troubleshooting can analyze file event logs from your hosts to determine whether antivirus software is present. From there, you can address any incompatibilities to make sure your endpoints are protected. | ||
### Scan your hosts for AV software [_scan_your_hosts_for_av_software] | ||
1. Find **Endpoints** in the navigation menu or use the global search field. | ||
2. Click on an endpoint to open its details flyout. | ||
3. Under **Automatic Troubleshooting**, select an LLM connector, or [add](../ai/set-up-connectors-for-large-language-models-llm.md) a new one. | ||
4. Click **Scan**. After a brief processing period, any detected AV products will appear under **Insights**. | ||
### Resolve incompatibilities [_resolve_incompatibilities] | ||
After a scan has completed, you can click the **Create trusted app** button to the right of a result to quickly add the associated AV program to {{elastic-defend}}'s trusted applications list. If the button is not clickable, you don’t have the [required privilege](trusted-applications.md). | ||
::::{important} | ||
If you plan to use {{elastic-defend}} alongside third-party AV software, we recommend you that you both [allowlist {{elastic-endpoint}} in your AV](allowlist-elastic-endpoint-in-third-party-antivirus-apps.md) and [make the AV a trusted application](trusted-applications.md). | ||
:::: |
51 changes: 0 additions & 51 deletions
51
solutions/security/manage-elastic-defend/identify-antivirus-software-on-hosts.md
This file was deleted.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.