Skip to content

Update IaC Security configuration documentation#36468

Open
whitemerch wants to merge 1 commit intomasterfrom
chakib_hamie/update_iac_security_configuration_docs
Open

Update IaC Security configuration documentation#36468
whitemerch wants to merge 1 commit intomasterfrom
chakib_hamie/update_iac_security_configuration_docs

Conversation

@whitemerch
Copy link
Copy Markdown
Contributor

@whitemerch whitemerch commented May 4, 2026

What does this PR do? What is the motivation?

This PR updates the IaC Security configuration docs to align with the shared Code Security configuration model. The new page documents the iac section of code-security.datadog.yaml, including default rule behavior, use-rules and ignore-rules, global path/severity/category filters, and inline dd-iac-scan exclusions.

This also moves the page from the older exclusions-focused URL to the SAST-style configuration URL, while keeping the previous exclusions URL as an alias for existing links. The shared Code Security configuration reference now includes IaC in the schema and merge examples.

Preview links:

Merge instructions

Merge readiness:

  • Ready for merge

Note

This PR is not ready to be merged as the feature is not released yet, but it is to be ready once the feature is released

Additional notes

The legacy dd-iac-scan.config section now links to a future reference in the datadog-iac-scanner repository.

@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label May 4, 2026
@whitemerch whitemerch force-pushed the chakib_hamie/update_iac_security_configuration_docs branch 6 times, most recently from c6f2073 to eeee1ce Compare May 5, 2026 13:53
Copy link
Copy Markdown
Contributor

@ChouraquiBen ChouraquiBen left a comment

Choose a reason for hiding this comment

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

Niiiiiice! Looks already really neat!

Comment thread content/en/security/code_security/iac_security/configuration/_index.md Outdated
Comment thread content/en/security/code_security/iac_security/configuration/_index.md Outdated
Comment thread content/en/security/code_security/iac_security/configuration/_index.md Outdated
Comment thread content/en/security/code_security/iac_security/configuration/_index.md Outdated
Comment thread content/en/security/code_security/iac_security/configuration/_index.md Outdated
Comment thread content/en/security/code_security/iac_security/configuration/_index.md Outdated
Comment thread content/en/security/code_security/iac_security/configuration/_index.md Outdated
Comment thread content/en/security/code_security/iac_security/configuration/_index.md Outdated
@whitemerch whitemerch force-pushed the chakib_hamie/update_iac_security_configuration_docs branch from eeee1ce to 2ef6ce4 Compare May 5, 2026 21:07
@whitemerch whitemerch marked this pull request as ready for review May 6, 2026 12:57
@whitemerch whitemerch requested a review from a team as a code owner May 6, 2026 12:57
Copy link
Copy Markdown

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

Reviewed commit: 2ef6ce40fb

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

- name: Configuration
identifier: code_security_iac_security_exclusions
url: /security/code_security/iac_security/exclusions/
url: /security/code_security/iac_security/configuration/
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Keep localized menu links on existing pages

In localized builds this menu URL is passed through relLangURL in layouts/partials/nav/left-nav.html, so the Spanish sidebar points to /es/security/code_security/iac_security/configuration/. I checked the content tree and this commit only adds the English configuration page; Spanish and Korean still only have content/{es,ko}/security/code_security/iac_security/exclusions.md, so this sidebar item becomes a 404 for those locales instead of linking to the existing translated exclusions page.

Useful? React with 👍 / 👎.

@michellesdawg michellesdawg self-requested a review May 6, 2026 13:55
@buraizu
Copy link
Copy Markdown
Contributor

buraizu commented May 6, 2026

Created DOCS-14315 for documentation team review

@buraizu buraizu added the editorial review Waiting on a more in-depth review label May 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants