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
7 changes: 6 additions & 1 deletion config/_default/menus/main.en.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -7510,11 +7510,16 @@ menu:
url: /security/code_security/secret_scanning/generic_ci_providers/
parent: sec_secret_scanning
weight: 2
- name: Rule Configuration
identifier: sec_secret_scanning_configuration
url: /security/code_security/secret_scanning/rule_configuration/
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
url: /security/code_security/secret_scanning/rule_configuration/
url: /security/code_security/secret_scanning/configuration/

parent: sec_secret_scanning
weight: 3
- name: Secret Validation
identifier: sec_secret_scanning_secret_validation
url: /security/code_security/secret_scanning/secret_validation/
parent: sec_secret_scanning
weight: 3
weight: 4
- name: Runtime Code Analysis (IAST)
identifier: sec_iast
url: /security/code_security/iast/
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
---
title: Rule Configuration
algolia:
tags: ['static analysis', 'ci pipeline', 'SAST', 'secret scanning']
description: Reference documentation for Datadog Secret Scanning (SAST) configuration, covering rule CRUD.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
description: Reference documentation for Datadog Secret Scanning (SAST) configuration, covering rule CRUD.
description: Configure rules for Datadog Secret Scanning, including managed default rules and custom regex rules.

---

By default, Datadog Secret Scanning scans enabled repositories with all [rules in the Secrets & Credentials category of Sensitive Data Scanner](https://docs.datadoghq.com/security/sensitive_data_scanner/scanning_rules/library_rules/?category=Secrets+and+credentials). You can customize which rules run, modify default rules, and create custom rules in the ['Code' configuration page](https://app.datadoghq.com/sensitive-data-scanner/configuration/code) in SDS.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
By default, Datadog Secret Scanning scans enabled repositories with all [rules in the Secrets & Credentials category of Sensitive Data Scanner](https://docs.datadoghq.com/security/sensitive_data_scanner/scanning_rules/library_rules/?category=Secrets+and+credentials). You can customize which rules run, modify default rules, and create custom rules in the ['Code' configuration page](https://app.datadoghq.com/sensitive-data-scanner/configuration/code) in SDS.
By default, Datadog Secret Scanning scans enabled repositories with all [rules in the Secrets & Credentials category of Sensitive Data Scanner][1]. You can customize which rules run, modify default rules, and create custom rules on the [**Code** configuration page][2] in SDS.

## Scanning groups
There are 2 scanning groups that configure Secret Scanning rules.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
There are 2 scanning groups that configure Secret Scanning rules.
There are two scanning groups that configure Secret Scanning rules.

### Managed scanning group
The managed scanning group is managed by Datadog's security team. It automatically receives new rules and updates to rules, and is enabled by default for all organizations.

{{< img src="/code_security/secret_scanning/managed_scanning_group_not_customized.png" alt="Managed scanning group" style="width:100%;">}}

### Custom rule scanning group
The custom scanning group is managed by user orgs. You can [create and test custom regex rules](https://docs.datadoghq.com/security/sensitive_data_scanner/scanning_rules/custom_rules/) or add rules from the SDS rules library.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
The custom scanning group is managed by user orgs. You can [create and test custom regex rules](https://docs.datadoghq.com/security/sensitive_data_scanner/scanning_rules/custom_rules/) or add rules from the SDS rules library.
The custom scanning group is managed by user orgs. You can [create and test custom regex rules][3] or add rules from the SDS rules library.


{{< img src="/code_security/secret_scanning/custom_scanning_group.png" alt="Managed scanning group" style="width:100%;">}}
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
{{< img src="/code_security/secret_scanning/custom_scanning_group.png" alt="Managed scanning group" style="width:100%;">}}
{{< img src="/code_security/secret_scanning/custom_scanning_group.png" alt="Custom scanning group" style="width:100%;">}}


## Configuring rules
### Customizing default rules
You can customize the severity and keywords of managed default rules by hovering over the specific rule, then clicking the pencil icon at the right.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
You can customize the severity and keywords of managed default rules by hovering over the specific rule, then clicking the pencil icon at the right.
To customize the severity and keywords of a managed default rule, hover over the rule and click the pencil icon on the right.

{{< img src="/code_security/secret_scanning/customize_default_rule.png" alt="Edit rule" style="width:100%;">}}

The edit dialog will pop up.

Check warning on line 26 in content/en/security/code_security/secret_scanning/configuration.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.tense

Avoid temporal words like 'will'.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
The edit dialog will pop up.
The edit dialog opens.

{{< img src="/code_security/secret_scanning/configure_default_rule.png" alt="Edit rule popup" style="width:100%;">}}

After editing the rule and pressing **Update** at the bottom right, the modified rule appears as **Customized** in the managed scanning group.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
After editing the rule and pressing **Update** at the bottom right, the modified rule appears as **Customized** in the managed scanning group.
After editing the rule and clicking **Update** at the bottom right, the modified rule appears as **Customized** in the managed scanning group.


{{< img src="/code_security/secret_scanning/disable_rule.png" alt="Customized secret scanning rule in managed group" style="width:100%;">}}

<div class="alert alert-info">Customized rules do not automatically receive severity/default keyword updates from Datadog's security team. To restore a rule to its managed state, hover over a customized rule and click the restore icon at the right. </div>

### Creating custom rules
You can create custom rules in the custom scanning group. Click 'Add scanning rule' at the bottom or 'Add rule' at the top right, create your regex rule, then configure the severity and keywords. After they're enabled, new rules are scanned for in your repositories upon the next commit.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
You can create custom rules in the custom scanning group. Click 'Add scanning rule' at the bottom or 'Add rule' at the top right, create your regex rule, then configure the severity and keywords. After they're enabled, new rules are scanned for in your repositories upon the next commit.
To create a custom rule, go to the custom scanning group and click **Add scanning rule** at the bottom or **Add rule** at the top right. Create your regex rule, then configure the severity and keywords. After they're enabled, your repositories are scanned with the new rules on the next commit.


{{< img src="/code_security/secret_scanning/add_to_custom.png" alt="Add rule to custom group" style="width:100%;">}}

You can update custom rules by hovering over the rule, then clicking the pencil icon at the right.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
You can update custom rules by hovering over the rule, then clicking the pencil icon at the right.
To update a custom rule, hover over the rule and click the pencil icon on the right.


### Disabling rules
Disable a rule by clicking the blue toggle on the right.

<div class="alert alert-info">Once a specific rule is disabled, existing findings from that rule are auto-closed in Secret Scanning upon the next commit.</div>

Check warning on line 45 in content/en/security/code_security/secret_scanning/configuration.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.words_case_sensitive

Use 'After' instead of 'Once'.
Copy link
Copy Markdown
Contributor

@drichards-87 drichards-87 May 14, 2026

Choose a reason for hiding this comment

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

Suggested change
<div class="alert alert-info">Once a specific rule is disabled, existing findings from that rule are auto-closed in Secret Scanning upon the next commit.</div>
<div class="alert alert-info">After a specific rule is disabled, existing findings from that rule are auto-closed in Secret Scanning on the next commit.</div>
[1]: /security/sensitive_data_scanner/scanning_rules/library_rules/?category=Secrets+and+credentials
[2]: https://app.datadoghq.com/sensitive-data-scanner/configuration/code
[3]: /security/sensitive_data_scanner/scanning_rules/custom_rules/

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading