-
Notifications
You must be signed in to change notification settings - Fork 228
DOCS-873 - Remove duplicate information from Cloud SIEM ingestion articles #5376
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
Merged
Merged
Changes from 13 commits
Commits
Show all changes
18 commits
Select commit
Hold shift + click to select a range
f115b5c
Add Auth0
jpipkin1 f82e9d1
Remove extra examples article
jpipkin1 d1d559f
Add Load Balancer, CloudTrail, and GuardDuty
jpipkin1 d0fa1c3
Add AWS VPC Flow
jpipkin1 87057d5
Add C ingetions
jpipkin1 3c56274
Add Google sources
jpipkin1 aab0f83
Add Microsoft ingestions
jpipkin1 ff37fb7
Fix broken link
jpipkin1 d410d0a
Add O-P ingestions
jpipkin1 44c8256
Add SentinelOne and Signal Sciences
jpipkin1 0170dd6
Add Symantec and Zscaler
jpipkin1 5c03a9f
Add log search examples
jpipkin1 3bf53f6
Fix redirects
jpipkin1 073b75e
Update docs/cse/ingestion/ingestion-sources-for-cloud-siem/aws-cloudt…
jpipkin1 cc5f876
Update docs/cse/ingestion/ingestion-sources-for-cloud-siem/aws-networ…
jpipkin1 b1389c7
Update cid-redirects.json
jpipkin1 89bbbba
Update docs/cse/ingestion/ingestion-sources-for-cloud-siem/fortigate-…
jpipkin1 fc4a8d6
Merge branch 'main' into docs-873-cloud-siem-ingestion-articles
jpipkin1 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
64 changes: 11 additions & 53 deletions
64
docs/cse/ingestion/ingestion-sources-for-cloud-siem/auth0.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 |
|---|---|---|
| @@ -1,60 +1,18 @@ | ||
| --- | ||
| id: auth0 | ||
| title: Auth0 - Cloud SIEM | ||
| sidebar_label: Auth0 system parser | ||
| title: Ingest Auth0 Data into Cloud SIEM | ||
| sidebar_label: Auth0 | ||
| description: Configure an HTTP source to ingest Auth0 log messages and send them to Cloud SIEM’s Auth0 system parser. | ||
| --- | ||
|
|
||
| import useBaseUrl from '@docusaurus/useBaseUrl'; | ||
|
|
||
| ## Step 1: Configure collection | ||
|
|
||
| In this step, you configure an HTTP Source to collect Auth0 log messages. You can configure the source on an existing Hosted Collector or create a new collector. If you’re going to use an existing collector, jump to [Configure an HTTP Source](#configure-an-http-source) below. Otherwise, create a new collector as described in [Configure a Hosted Collector](#configure-a-hosted-collector) below, and then create the HTTP Source on the collector. | ||
|
|
||
| ### Configure a Hosted Collector | ||
|
|
||
| 1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > Collection**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the top menu select **Configuration**, and then under **Data Collection** select **Collection**. You can also click the **Go To...** menu at the top of the screen and select **Collection**. | ||
| 1. Click **Add Collector**. | ||
| 1. Click **Hosted Collector.** | ||
| 1. The **Add Hosted Collector** popup appears.<br/><img src={useBaseUrl('img/cse/add-hosted-collector.png')} alt="Add hosted image collector" style={{border: '1px solid gray'}} width="500" /> | ||
| 1. **Name**. Provide a Name for the Collector. | ||
| 1. **Description**. (Optional) | ||
| 1. **Category**. Enter a string to tag the output collected from the source. The string that you supply will be saved in a metadata field called `_sourceCategory`. | ||
| 1. **Fields**. | ||
| 1. If you are planning that all the sources you add to this collector will forward log messages to Cloud SIEM, click the **+Add Field** link, and add a field whose name is `_siemForward` and value is *true*. This will cause the collector to forward all of the logs collected by all of the sources on the collector to Cloud SIEM. | ||
| 1. If all sources in this collector will be Auth0 sources, add an additional field with key `_parser` and value */Parsers/System/Auth0/Auth0*. | ||
|
|
||
| :::note | ||
| It’s also possible to configure individual sources to forward to Cloud SIEM, as described in the following section. | ||
| ::: | ||
|
|
||
| ### Configure an HTTP Source | ||
|
|
||
| 1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > Collection**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the top menu select **Configuration**, and then under **Data Collection** select **Collection**. You can also click the **Go To...** menu at the top of the screen and select **Collection**. | ||
| 1. Navigate to the Hosted Collector where you want to create the source. | ||
| 1. On the **Collectors** page, click **Add Source** next to a Hosted Collector. | ||
| 1. Select **HTTP Logs & Metrics**. | ||
| 1. The page refreshes.<br/><img src={useBaseUrl('img/cse/http-source.png')} alt="HTTP source" style={{border: '1px solid gray'}} width="600" /> | ||
| 1. **Name**. Enter a name for the source. | ||
| 1. **Description**. (Optional) | ||
| 1. **Source Host.** (Optional) Enter a string to tag the messages collected from the source. The string that you supply will be saved in a metadata field called `_sourceHost.` | ||
| 1. **Source Category**. Enter a string to tag the output collected from the source. The string that you supply will be saved in a metadata field called `_sourceCategory`. | ||
| 1. **SIEM Processing**. Click the checkbox to configure the source to forward log messages to Cloud SIEM. | ||
| 1. **Fields.** If you are not parsing all sources in the hosted collector with the same parser, click the **+Add Field** link, and add a field whose name is `_parser` with value */Parsers/System/Auth0/Auth0*. | ||
| 12. **Advanced Options for Logs**. For information about the optional advance options you can configure, see [HTTP Logs and Metrics Source](/docs/send-data/hosted-collectors/http-source/logs-metrics/). | ||
| 13. Click **Save**. | ||
| 14. Make a note of the HTTP Source URL that is displayed. You’ll supply it in Step 2 below. | ||
|
|
||
| ## Step 2: Configure Auth0 | ||
|
|
||
| In this step you configure Auth0 to send log messages to the Sumo Logic platform. For instructions, see [Stream Logs to Sumo Logic](https://auth0.com/docs/logs/streams/stream-logs-to-sumo-logic) | ||
| in Auth0 help. | ||
|
|
||
| ## Step 3: Verify ingestion | ||
|
|
||
| In this step, you verify that your logs are successfully making it into | ||
| Cloud SIEM. | ||
|
|
||
| 1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the top menu select **Configuration**, and then under **Incoming Data** select **Log Mappings**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Integrations** select **Log Mappings**. You can also click the **Go To...** menu at the top of the screen and select **Log Mappings**. | ||
| 1. On the **Log Mappings** tab search for Auth0 and check the **Records** columns.<br/><img src={useBaseUrl('img/cse/auth0-reocrd-volume.png')} alt="Record volume" style={{border: '1px solid gray'}} style={{border: '1px solid gray'}} width="800" /> | ||
| 1. For a more granular look at the incoming records, you can also use the Sumo Logic platform to search for Auth0 security records.<br/><img src={useBaseUrl('img/cse/auth0-search.png')} alt="Auth0 search" style={{border: '1px solid gray'}} style={{border: '1px solid gray'}} width="500" /> | ||
| To ingest Auth0 data into Cloud SIEM: | ||
| 1. [Configure a source for Auth0](/docs/integrations/saml/auth0/#configure-a-source) on a collector. When you configure the source, do the following: | ||
| 1. Select the **Forward to SIEM** option in the source configuration UI. This will ensure all logs for this source are forwarded to Cloud SIEM. | ||
| 1. Click the **+Add** link to add a field whose name is `_parser` with value */Parsers/System/Auth0/Auth0*. This ensures that the Auth0 logs are parsed and normalized into structured records in Cloud SIEM. | ||
| 1. Configure Auth0 to send log messages to the Sumo Logic platform. For instructions, see [Sumo Logic](https://marketplace.auth0.com/integrations/sumo-logic-log-streaming) in the Auth0 help. | ||
| 1. To verify that your logs are successfully making it into Cloud SIEM: | ||
| 1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the top menu select **Configuration**, and then under **Incoming Data** select **Log Mappings**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Integrations** select **Log Mappings**. You can also click the **Go To...** menu at the top of the screen and select **Log Mappings**. | ||
| 1. On the **Log Mappings** tab search for Auth0 and check the **Records** columns.<br/><img src={useBaseUrl('img/cse/auth0-reocrd-volume.png')} alt="Record volume" style={{border: '1px solid gray'}} style={{border: '1px solid gray'}} width="800" /> | ||
| 1. For a more granular look at the incoming records, you can also use the Sumo Logic platform to search for Auth0 security records: <br/>`_index=sec_record* and metadata_product = "Auth0"` |
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.