Skip to content
Open
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
5 changes: 5 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -612,6 +612,11 @@ plaid/assets/logs/ @DataDog/saa
/klaviyo/manifest.json @DataDog/saas-integrations @DataDog/documentation
/klaviyo/assets/logs/ @DataDog/saas-integrations @DataDog/documentation @DataDog/logs-integrations-reviewers

/zerofox_cloud_platform/ @DataDog/saas-integrations
/zerofox_cloud_platform/*.md @DataDog/saas-integrations @DataDog/documentation
/zerofox_cloud_platform/manifest.json @DataDog/saas-integrations @DataDog/documentation
/zerofox_cloud_platform/assets/logs/ @DataDog/saas-integrations @DataDog/documentation @DataDog/logs-backend

/beyondtrust_password_safe/ @DataDog/saas-integrations @DataDog/agent-integrations
/beyondtrust_password_safe/*.md @DataDog/saas-integrations @DataDog/agent-integrations @DataDog/documentation
/beyondtrust_password_safe/manifest.json @DataDog/saas-integrations @DataDog/agent-integrations @DataDog/documentation
Expand Down
2 changes: 2 additions & 0 deletions .github/workflows/config/labeler.yml
Original file line number Diff line number Diff line change
Expand Up @@ -749,6 +749,8 @@ integration/zeek:
- zeek/**/*
integration/zero_networks:
- zero_networks/**/*
integration/zerofox_cloud_platform:
- zerofox_cloud_platform/**/*
integration/zk:
- zk/**/*
qa/skip-qa:
Expand Down
7 changes: 7 additions & 0 deletions zerofox_cloud_platform/CHANGELOG.md
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
47 changes: 47 additions & 0 deletions zerofox_cloud_platform/README.md
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.
Copy link
Contributor

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?

Copy link
Contributor Author

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.


### 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
Copy link
Contributor

Choose a reason for hiding this comment

The 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
1. Add your Username and Password.
| Parameters | Description |
| -------- | ---------------------------------------------- |
| Username | The Username of your ZeroFox Platform account. |
| Password | The Password of your ZeroFox Platform account. |
1. Add the Username and Password of your ZeroFox Platform account.

Copy link
Contributor Author

Choose a reason for hiding this comment

The 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.
CC: @torosmassa

2. Click the Save button to save your settings.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Click the Save button to save your settings.
2. Click **Save**.

Copy link
Contributor Author

Choose a reason for hiding this comment

The 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.

66 changes: 66 additions & 0 deletions zerofox_cloud_platform/assets/logs/zerofox-cloud-platform.yaml
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(""))}
Loading
Loading