Skip to content

Conversation

@shubhamvekariya-crest
Copy link
Contributor

What does this PR do?

This is a initial release PR of Cato Networks integration including all the required assets.

Integration Logo Source: https://www.catonetworks.com/wp-content/uploads/2024/07/cato-green-logo-2.svg

Additional Notes

  • Crawler code for this integration has been committed in its respective repo
  • OOTB detection rules JSON would be shared separately with the required teams as a part of separate repository.
  • Since during the standard attribute remapping we are not preserving the source attributes as per suggested best practices, it would result in filters using these standard attributes populating the values of other integrations as well as per current Datadog behaviour.

Review checklist (to be filled by reviewers)

  • Feature or bugfix MUST have appropriate tests (unit, integration, e2e)
  • Add the qa/skip-qa label if the PR doesn't need to be tested during QA.
  • If you need to backport this PR to another branch, you can add the backport/<branch-name> label to the PR and it will automatically open a backport PR once this one is merged

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment on lines +2 to +5
"manifest_version": "2.0.0",
"app_uuid": "4139f2e2-ba87-4e17-bcda-73bdade3ed8f",
"app_id": "cato-networks",
"display_on_public_website": false,

Choose a reason for hiding this comment

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

P1 Badge Add manifest owner field

The new manifest omits the required owner field even though this is a v2.0.0 integration manifest; every other v2 manifest includes it for validation and ownership routing. Leaving it out will cause the manifest validator to fail and block publishing the integration.

Useful? React with 👍 / 👎.

Comment on lines +115 to +119
- groups:
- User
name: User Name
path: usr.name
source: log

Choose a reason for hiding this comment

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

P1 Badge Facet fields used by events dashboard filters

The log config only facets DNS, geoip, and user fields here and never declares facets for the attributes the events dashboard filters on (event_sub_type, action, threat_type, application_name). Because unfaceted attributes are not indexed for search or group-bys, the dashboard’s template variables and widgets referencing those fields will stay empty even when relevant logs arrive.

Useful? React with 👍 / 👎.

@buraizu buraizu added the editorial review Waiting on a more in-depth review from a docs team editor label Dec 17, 2025
@buraizu
Copy link
Contributor

buraizu commented Dec 17, 2025

Created DOCS-12937 for documentation team review


This integration ingests the following logs:

- **Audit Logs**: This logs provide detailed information on admin actions performed within the system.
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
- **Audit Logs**: This logs provide detailed information on admin actions performed within the system.
- **Audit Logs**: These logs provide detailed information on admin actions performed within the system.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

This integration ingests the following logs:

- **Audit Logs**: This logs provide detailed information on admin actions performed within the system.
- **Events**: This logs provide detailed insights into security, detection and response, connectivity, and system events within the Cato Networks platform.
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
- **Events**: This logs provide detailed insights into security, detection and response, connectivity, and system events within the Cato Networks platform.
- **Events**: These logs provide detailed insights into security, detection and response, connectivity, and system events within the Cato Networks platform.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

Copy link
Contributor

@rtrieu rtrieu left a comment

Choose a reason for hiding this comment

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

left some minor feedback to comply with style guidelines.

3. Click **Apply** button and copy the **Token**.
4. Navigate to **Account** > **Account Info** and copy the **Account ID**.
5. Identify your Cato Networks Region by checking the prefix of your URL:
- cc.us1.catonetworks.com - us1
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
- cc.us1.catonetworks.com - us1
- `cc.us1.catonetworks.com` - us1

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

4. Navigate to **Account** > **Account Info** and copy the **Account ID**.
5. Identify your Cato Networks Region by checking the prefix of your URL:
- cc.us1.catonetworks.com - us1
- cc.catonetworks.com - Keep region as empty
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
- cc.catonetworks.com - Keep region as empty
- `cc.catonetworks.com` - Keep region as empty

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

### Event Log collection

#### Configure AWS S3 Bucket
**Note**: Please use **cato-networks** as the **S3 prefix**.
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
**Note**: Please use **cato-networks** as the **S3 prefix**.
When configuring the AWS bucket, use **cato-networks** as the **S3 prefix**.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍


#### Configure AWS S3 Bucket
**Note**: Please use **cato-networks** as the **S3 prefix**.
Please refer the [Configuring the AWS S3 Bucket][2]
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
Please refer the [Configuring the AWS S3 Bucket][2]
For more information, see [Configuring the AWS S3 Bucket][2].

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

Please refer the [Configuring the AWS S3 Bucket][2]

#### Configure Event Integration in CATO Network
Please refer the [Adding Amazon S3 Integration for Events][3]
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
Please refer the [Adding Amazon S3 Integration for Events][3]
For more information on configuring the event integration in a CATO network, see [Adding Amazon S3 Integration for Events][3].

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

Please refer the [Adding Amazon S3 Integration for Events][3]

#### Configure Datadog Forwarder
Please refer the [Datadog Forwarder][4]
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
Please refer the [Datadog Forwarder][4]
See information on configuring the [Datadog Forwarder][4].

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

Please refer the [Datadog Forwarder][4]


## Data Collected
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
## Data Collected
## Data collected

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

**Note**: Please use **cato-networks** as the **S3 prefix**.
Please refer the [Configuring the AWS S3 Bucket][2]

#### Configure Event Integration in CATO Network
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
#### Configure Event Integration in CATO Network
#### Set up event integration in CATO networks

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants