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

add extrahop and redirect for agent #1934

Merged
merged 1 commit into from
Aug 1, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
uuid: 1df44c62-33d3-41d4-8176-f1fa13589eea
name: ExtraHop Reveal(x) 360
type: intake

## Overview

ExtraHop Reveal(x) 360 is a cloud-based network detection and response platform offering protection and detections for on-premises and cloud environments.

In this documenation we will explain how to collect and send Reveal(x) 360 events to Sekoia.io.

{!_shared_content/operations_center/detection/generated/suggested_rules_1df44c62-33d3-41d4-8176-f1fa13589eea_do_not_edit_manually.md!}

{!_shared_content/operations_center/integrations/generated/1df44c62-33d3-41d4-8176-f1fa13589eea.md!}

## Configure

### Prerequisites
- System and access administration privileges for ExtraHop Reveal(x) 360
- Access to Sekoia.io Intakes and Playbook pages with write permissions

### How to create REST API credentials
1. Log in to Reveal(x) 360.
2. Click the System Settings icon at the top right of the page and then click **All Administration**.
3. Click **API Access**.
4. Click **Create Credentials**.
5. In the **Name** field, type a name for the credentials.
6. In the **Privileges** field, specify a privilege level for the credentials.

!!! Note
The privilege level determines which actions can be performed with the credential. Do not grant more privileges to REST API credentials than needed because it can create a security risk. For example, applications that only retrieve metrics should not be granted credentials that grant administrative privileges. For more information about each privilege level, see [User privileges](https://docs.extrahop.com/9.5/users-overview/#user-privileges).

!!! Note
System and Access Administration privileges are similar to Full write privileges and allow the credentials to connect self-managed sensors and Trace appliances to Reveal(x) 360.

7. In the **Packet Access** field, specify whether you can retrieve packets and session keys with the credentials.
8. Click **Save**.
The Copy REST API Credentials pane appears.
9. Under ID, click **Copy to Clipboard** and save the ID to your local machine.
10. Under Secret, click **Copy to Clipboard** and save the secret to your local machine.

!!! Important
The secret cannot be viewed or retrieved later.

12. Click **Done**.


### Create your intake

1. Go to the [intake page](https://app.sekoia.io/operations/intakes) and create a new intake from the `ExtraHop Reveal(x) 360`.
2. Copy the associated Intake key

### Pull the logs to collect them on Sekoia.io

Go to the Sekoia.io [playbook page](https://app.sekoia.io/operations/playbooks), and follow these steps:

- Click on **+ PLAYBOOK** button to create a new one
- Select **Create a playbook from scratch**
- Give it a name in the field **Name**
- Open the left panel, click **ExtraHop** then select the trigger `Fetch new alerts from ExtraHop Reveal(x) 360`
- Click on **Create**

- Create a **Module configuration** using your REST API credentials created on the *How to create REST API credentials* step. Name the module configuration as you wish
- Create a **Trigger configuration** and Type the `Intake key` created on the previous step
- Click on the **Save** button
- **Activate the playbook** with the toggle button on the top right corner of the page

### Enjoy your events on the [Events page](https://app.sekoia.io/operations/events)
5 changes: 4 additions & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -447,6 +447,7 @@ nav:
- Datadome Protection: integration/categories/network_security/datadome_protection.md
- Daspren Parad: integration/categories/network_security/daspren_parad.md
- Digital Shadows SearchLight: integration/categories/network_security/digital_shadows.md
- ExtraHop Reveal(x) 360: integration/categories/network_security/extrahop_revealx_360.md
- Fastly Next-Gen WAF: integration/categories/network_security/fastly_waf.md
- Forcepoint Secure Web Gateway: integration/categories/network_security/forcepoint_web_gateway.md
- FortiProxy: integration/categories/network_security/fortiproxy.md
Expand Down Expand Up @@ -525,7 +526,7 @@ nav:
- RSS: integration/action_library/generic/rss.md
- Sekoia: integration/action_library/generic/sekoia-io.md
- Utils: integration/action_library/generic/utils.md
- IAM SASE:
- IAM:
- Duo: integration/action_library/iam/duo.md
- Jumpcloud Directory Insights: integration/action_library/iam/jumpcloud-directory-insights.md
- Microsoft Active Directory: integration/action_library/iam/microsoft-active-directory.md
Expand Down Expand Up @@ -667,6 +668,7 @@ plugins:
xdr/features/collect/integrations/cloud_and_saas/cloudflare/cloudflare-http-requests.md: integration/categories/network/cloudflare-http-requests.md
xdr/features/collect/integrations/cloud_and_saas/datadome_protection.md: integration/categories/network_security/datadome_protection.md
xdr/features/collect/integrations/cloud_and_saas/digital_shadows.md: integration/categories/network_security/digital_shadows.md
xdr/features/collect/integrations/cloud_and_saas/extrahop_revealx_360.md: integration/categories/network_security/extrahop_revealx_360.md
xdr/features/collect/integrations/cloud_and_saas/fastly/fastly_audit_waf.md: integration/categories/applicative/fastly_audit_waf.md
xdr/features/collect/integrations/cloud_and_saas/fastly/fastly_waf.md: integration/categories/network_security/fastly_waf.md
xdr/features/collect/integrations/cloud_and_saas/github_audit_logs.md: integration/categories/applicative/github_audit_logs.md
Expand Down Expand Up @@ -779,6 +781,7 @@ plugins:
xdr/features/collect/integrations/network/watchguard_firebox.md: integration/categories/network_security/watchguard_firebox.md
xdr/features/collect/integrations/endpoint/sekoiaio/sekoiaio.md: integration/categories/endpoint/sekoiaio.md
xdr/features/collect/integrations/index.md: integration/categories/index.md
xdr/features/collect/integrations/endpoint/sekoiaio.md: integration/categories/endpoint/sekoiaio.md
getting_started/2fa.md: getting_started/account_security.md
getting_started/apikey_creation.md: getting_started/manage_api_keys.md
getting_started/first_steps.md: getting_started/index.md
Expand Down
Loading