-
Notifications
You must be signed in to change notification settings - Fork 1.5k
[SAASINT-4564] DDS: ZeroFox Cloud Platform: Crawler Integration v1.0.0 #21118
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
base: master
Are you sure you want to change the base?
Changes from all commits
99cfd90
b8f8d9e
4dad444
879db02
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
# CHANGELOG - ZeroFox Cloud Platform | ||
|
||
## 1.0.0 / 2025-08-20 | ||
|
||
***Added***: | ||
|
||
* Initial Release |
Original file line number | Diff line number | Diff line change | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@@ -0,0 +1,47 @@ | ||||||||||||||
## Overview | ||||||||||||||
|
||||||||||||||
[ZeroFox Cloud Platform][1] is a digital risk protection platform that monitors social, dark web, domains, apps, and collaboration channels to identify brand, executive, and attack surface threats. | ||||||||||||||
|
||||||||||||||
This integration ingests the following logs: | ||||||||||||||
- **Platform Alerts**: Provides information about malicious or suspicious activity that violates defined ZeroFox rules. | ||||||||||||||
|
||||||||||||||
Integrate ZeroFox Cloud Platform with Datadog to gain insights into Alerts using pre-built dashboard visualizations. Datadog uses its built-in log pipelines to parse and enrich these logs, facilitating easy search and detailed insights. Additionally, the integration includes ready-to-use Cloud SIEM detection rules for enhanced monitoring and security. | ||||||||||||||
|
||||||||||||||
## Setup | ||||||||||||||
|
||||||||||||||
### Prerequisites | ||||||||||||||
|
||||||||||||||
- Username | ||||||||||||||
- Password | ||||||||||||||
|
||||||||||||||
Note: User account that is associated with a ZeroFox customer enterprise. | ||||||||||||||
|
||||||||||||||
### Connect your ZeroFox Cloud Platform Account to Datadog | ||||||||||||||
|
||||||||||||||
1. Add your Username and Password. | ||||||||||||||
| Parameters | Description | | ||||||||||||||
| -------- | ---------------------------------------------- | | ||||||||||||||
| Username | The Username of your ZeroFox Platform account. | | ||||||||||||||
| Password | The Password of your ZeroFox Platform account. | | ||||||||||||||
Comment on lines
+21
to
+25
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I removed the table and consolidated the parameter descriptions into a single sentence to reduce redundancy.
Suggested change
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. As per discussion with our PM @dpoint01, We keep this format consistent across all our integrations. |
||||||||||||||
2. Click the Save button to save your settings. | ||||||||||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. As mentioned in above comment(link), We keep this format consistent across all our integrations |
||||||||||||||
|
||||||||||||||
## Data Collected | ||||||||||||||
|
||||||||||||||
### Logs | ||||||||||||||
|
||||||||||||||
ZeroFox Cloud Platform collects and forwards alerts to Datadog. | ||||||||||||||
|
||||||||||||||
### Metrics | ||||||||||||||
|
||||||||||||||
ZeroFox Cloud Platform does not include any metrics. | ||||||||||||||
|
||||||||||||||
### Events | ||||||||||||||
|
||||||||||||||
ZeroFox Cloud Platform does not include any events. | ||||||||||||||
|
||||||||||||||
## Troubleshooting | ||||||||||||||
|
||||||||||||||
Need help? Contact [Datadog support][2]. | ||||||||||||||
|
||||||||||||||
[1]: https://www.zerofox.com/platform/ | ||||||||||||||
[2]: https://docs.datadoghq.com/help/ |
Large diffs are not rendered by default.
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,66 @@ | ||
id: zerofox-cloud-platform | ||
metric_id: zerofox-cloud-platform | ||
backend_only: false | ||
facets: null | ||
pipeline: | ||
type: pipeline | ||
name: ZeroFox Cloud Platform | ||
enabled: true | ||
filter: | ||
query: source:zerofox-cloud-platform | ||
processors: | ||
- type: date-remapper | ||
name: Define `last_modified` as the official date of the log | ||
enabled: true | ||
sources: | ||
- last_modified | ||
- name: Lookup on `severity` to `risk_rating` | ||
enabled: true | ||
source: severity | ||
target: risk_rating | ||
lookupTable: |- | ||
5,Critical | ||
4,High | ||
3,Medium | ||
2,Low | ||
1,Info | ||
type: lookup-processor | ||
- name: Lookup on `severity` to `severity_to_status` | ||
enabled: true | ||
source: severity | ||
target: severity_to_status | ||
lookupTable: |- | ||
5,Alert | ||
4,Critical | ||
3,Warning | ||
2,Notice | ||
1,Info | ||
type: lookup-processor | ||
- type: status-remapper | ||
name: Define `severity_to_status` as the official status of the log | ||
enabled: true | ||
sources: | ||
- severity_to_status | ||
- type: string-builder-processor | ||
name: Build ZeroFox Platform Alert Link | ||
enabled: true | ||
template: https://cloud.zerofox.com/alerts/%{id} | ||
target: alert_link | ||
replaceMissing: true | ||
- type: string-builder-processor | ||
name: Extract actors from logs | ||
enabled: true | ||
template: "%{logs.actor}" | ||
target: actors | ||
replaceMissing: true | ||
- type: grok-parser | ||
name: Convert actors string to array | ||
enabled: true | ||
source: actors | ||
samples: | ||
- " ,,ZeroFox Platform Specialist, " | ||
- "ZeroFox Platform Specialist,, " | ||
grok: | ||
supportRules: "" | ||
matchRules: extract_actors (%{regex("\\s*"):},)*%{data:actor:array(",", | ||
nullIf(""))} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just to confirm—should the note indicate that the username and password must come from an account that's associated with a ZeroFox customer enterprise?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, the note indicate that the username and password must come from an account that's associated with a ZeroFox customer enterprise.