Skip to content

Add common security acronyms and brand nouns to SIEM-Names namecase exceptions#94

Closed
zmackie-datadog wants to merge 1 commit into
mainfrom
zmackie/expand-siem-namecase-exceptions
Closed

Add common security acronyms and brand nouns to SIEM-Names namecase exceptions#94
zmackie-datadog wants to merge 1 commit into
mainfrom
zmackie/expand-siem-namecase-exceptions

Conversation

@zmackie-datadog

@zmackie-datadog zmackie-datadog commented May 22, 2026

Copy link
Copy Markdown

Summary

Adds Anthropic, API, Claude, CLI, DNS, IP, MFA, RBAC, SSO, URL to the SIEM-Names/namecase.yml exceptions list so the namecase check no longer flags rule names that follow the team's established naming convention.

Why this matters

The SIEM-Names.namecase vale rule extends capitalization with match: $sentence, requiring rule names to be in sentence case unless a substring appears in the exceptions list. The current list is heavily phrase-oriented (e.g., Auth0 Guardian MFA, AWS Console login without MFA, Auth0 Suspicious IP Throttling) and lacks generic acronym entries. As a result, scores of production SIEM rules in DataDog/security-monitoring would fail this check if re-validated today — they don't get re-checked because the pre-commit hook only runs on modified files.

Survey of cloud-siem/log-detection/production/ rule names (861 total):

Acronym Production occurrences In exceptions before this PR?
IP 40 ❌ (only as part of Auth0 Suspicious IP Throttling)
MFA 19 ❌ (only as part of phrases)
API 14 ❌ (only API calls)
DNS 5
URL 4
SSO 3
CLI 2
RBAC 0 (new term, needed for incoming Anthropic Compliance rules)

Examples that currently pass CI on prod but would be blocked from any modification until this PR lands:

  • "Activity observed from malicious IP"
  • "Atlassian administrative API token activity observed"
  • "Slack CLI login from suspicious IP address"
  • "Azure AD MFA disabled"
  • "Gitlab SSO disabled"
  • "GitHub IP allow list"

Concrete impact (motivating case)

Authoring the new Anthropic Compliance SIEM rule pack (zmackie/anthropic-compliance-scaffold) hit this wall: 9 of 21 scaffold rules tripped SIEM-Names.namecase for using SSO, API, IP, RBAC, or Claude — the same acronyms that production Slack, Atlassian, GitHub, Azure, and Auth0 packs use without expansion. With these exceptions added, the 9 rule names pass validation unchanged.

Brand nouns

Anthropic and Claude are added alongside the acronyms because the new SaaS audit-log integration ("Claude Compliance") will use both in rule names. This follows the existing convention of registering single-word product brands (Cloudflare, GitHub, Okta, JumpCloud, 1Password, TruffleHog, Tor).

Verification

Local vale run before this change, against the 9 failing Anthropic-Compliance rule names plus 5 production examples that would also fail:

✖ 14 errors, 0 warnings and 0 suggestions

After this change, all 14 pass:

✔ 0 errors, 0 warnings and 0 suggestions

Test plan

  • Confirm vale still flags genuinely incorrect sentence case (e.g., a name like "Anthropic Compliance Foo Bar" where Foo and Bar aren't proper nouns)
  • Confirm pre-commit rule-validation in DataDog/security-monitoring passes for the Anthropic Compliance scaffold once this lands

🤖 Generated with Claude Code

Adds Anthropic, API, Claude, CLI, DNS, IP, MFA, RBAC, SSO, URL to the
exceptions list. These appear unmodified in scores of production SIEM
detection rule names today and need to be allowed by the namecase
check so that new rule authoring is consistent with established
convention.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
@zmackie-datadog zmackie-datadog marked this pull request as ready for review May 22, 2026 17:33
@zmackie-datadog zmackie-datadog requested review from a team as code owners May 22, 2026 17:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant