Skip to content

DOC: Create new IAM Policy Grammar Page#799

Open
blkgrlcto wants to merge 11 commits into
mainfrom
doc-iam-policy-grammar
Open

DOC: Create new IAM Policy Grammar Page#799
blkgrlcto wants to merge 11 commits into
mainfrom
doc-iam-policy-grammar

Conversation

@blkgrlcto

Copy link
Copy Markdown
Contributor

Summary

Adds a new IAM Policy Grammar reference page under Security Testing,
documenting the condition operators and condition keys the LocalStack IAM
policy engine can evaluate. The same engine backs IAM Policy Enforcement
and the IAM Policy Simulator, so the page applies to both.

New page: src/content/docs/aws/capabilities/security-testing/iam-policy-grammar.md

Documents: localstack-pro#7232, localstack-pro#7209
Closes: DOC-276, DOC-277

Contents

  • Condition operators — tables for String, Numeric, and ARN categories.
    Confirmed as supported: the six numeric operators, the negated string
    operators (StringNotEquals, StringNotEqualsIgnoreCase, StringNotLike),
    and the negated ARN operators (ArnNotEquals, ArnNotLike).
  • Condition keysiam:PolicyArn and s3:max-keys.
  • Examples — a worked s3:max-keys numeric guardrail.
  • Known limitations — notes that grammar support is incremental.

Draft — blockers before this can merge

  • Operator support matrix. Rows marked Verify in the String and ARN
    tables (StringEquals, StringEqualsIgnoreCase, StringLike, ArnEquals,
    ArnLike) and the entire "Other categories" set (Date, Bool, BinaryEquals,
    IpAddress/NotIpAddress, Null, the ...IfExists variants, and
    ForAllValues/ForAnyValue) need confirming against the policy engine. The
    release notes only tell us what was added, not the complete supported set.
  • Frontmatter — confirm tags tier and sidebar.order relative to the
    other Security Testing pages.
  • Verify the s3:max-keys example end-to-end under ENFORCE_IAM=1.

Reviewer notes

  • Author-note HTML comments (the DRAFT header and VERIFY markers) must be
    removed before merge.
  • The page links to an IAM Policy Simulator page that doesn't exist yet
    (tracked separately as DOC-302). Either land that first or drop the two links
    to it until it exists.

Out of scope

  • S3 ABAC tag condition keys and the EC2 IMDSv2 metadata key — owned by a
    separate ticket and intentionally not documented here.

quetzalliwrites and others added 11 commits June 30, 2026 14:14
…soft Entra ID (#722)

Co-authored-by: Brian Rinaldi <brian.rinaldi@gmail.com>
…nedPollerConfig, FunctionResponseTypes) (#750)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add a reference page listing the condition operators and condition keys
the LocalStack IAM policy engine evaluates. Covers the newly supported
numeric operators, negated string operators, and negated ARN operators,
plus the iam:PolicyArn and s3:max-keys condition keys, with a worked
s3:max-keys example.

Operators whose support is not yet confirmed are marked as pending a
check against the policy engine.
order: 5
---

<!--

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

hey @blkgrlcto there are several notes here mentioning this being in draft mode. Also several parts where it says TO DO. Is this ready to review or should we move this PR to draft mode?

Base automatically changed from aws-docs-release-july to main July 22, 2026 11:29
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.

8 participants