Skip to content

DOC-311 Update IAM docs for descriptive enforcement denial messages#798

Open
blkgrlcto wants to merge 12 commits into
mainfrom
doc-311-doc-iam-actionable-denial-messages-and-log
Open

DOC-311 Update IAM docs for descriptive enforcement denial messages#798
blkgrlcto wants to merge 12 commits into
mainfrom
doc-311-doc-iam-actionable-denial-messages-and-log

Conversation

@blkgrlcto

@blkgrlcto blkgrlcto commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Updates the IAM security-testing docs to reflect the new descriptive denial messages from the enforcement engine. Denials now surface in both the API response and the LocalStack logs, naming the denied action, the responsible policy type and document, and whether the denial was explicit or implicit — replacing the old generic Access to the specified resource is denied message.
This PR closes DOC-311 and DOC-271
explainable-iam.md

  • Rewrote the intro to cover both the API response and log output.
  • Replaced the generic error and the old multi-line DEBUG:localstack_ext… breakdown with the new descriptive error and single Policy Engine log line.
  • Added a Reading denial messages section (message anatomy + explicit/implicit distinction) and an Inline policies subsection showing that LocalStack names the specific inline policy, unlike AWS.
  • Fixed a pre-existing showshowLineNumbers → showLineNumbers typo.

iam-policy-enforcement.md

  • Added an intro note + cross-link to Explainable IAM.
  • Replaced the generic error and the old l.s.i.p.handler … denied. log line in the bucket example with the new descriptive forms.
  • New Service Control Policies section: concept + walkthrough where a
    Deny SCP overrides an identity-based Allow.

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>
- explainable-iam.md

- Rewrote the intro to cover both the API response and log output.
- Replaced the generic error and the old multi-line DEBUG:localstack_ext… breakdown with the new descriptive error and single Policy Engine log line.
- Added a Reading denial messages section (message anatomy + explicit/implicit distinction) and an Inline policies subsection showing that LocalStack names the specific inline policy, unlike AWS.
- Fixed a pre-existing showshowLineNumbers → showLineNumbers typo.

- iam-policy-enforcement.md

- Added an intro note + cross-link to Explainable IAM.
- Replaced the generic error and the old l.s.i.p.handler … denied. log line in the bucket example with the new descriptive forms.
CP enforcement: add a "Service Control Policies" section to
the enforcement guide explaining SCP guardrails and walking through an
SCP that overrides an identity-based Allow.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 20, 2026

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6f818e5
Status: ✅  Deploy successful!
Preview URL: https://43e5a58d.localstack-docs.pages.dev
Branch Preview URL: https://doc-311-doc-iam-actionable-d-7jm9.localstack-docs.pages.dev

View logs

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