Core lesson 9 of 18Topic: IAM: identity and permissions
How to read IAM policy JSON: Effect, Action and Resource
An IAM policy describes permissions in JSON. Start with a Statement, an individual rule, and compare its Effect, Action and Resource with one request. Valid JSON syntax does not establish that AWS will authorize the intended operation.
Match a statement to a request, identify a mismatched element and explain what the snippet cannot determine.
Know principal, action, resource and authentication versus authorization. No real policy input is required.
Read one small statement
{
"Version": "2012-10-17",
"Statement": [{
"Sid": "ReadOneReport",
"Effect": "Allow",
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::demo-bucket/report.csv"
}]
}Braces group properties and brackets enclose an array. This Statement array contains one rule. Version identifies the policy language version, not the creation date. Sid is an optional statement identifier; its name does not grant permission.
| Element | Value in the example | Question to ask |
|---|---|---|
| Effect | Allow | Does this rule allow or explicitly deny? |
| Action | s3:GetObject | Does the requested API operation match? |
| Resource | The ARN for demo-bucket/report.csv | Does the target resource match? |
Match the action and resource separately
- Allow statement → GetObject / report.csvMatches this statement
- Allow statement → PutObject / report.csvNot covered by this statement
- Allow statement
- This example names GetObject and report.csv.
- GetObject / report.csv
- Both elements match this statement; effective authorization still needs review.
- PutObject / report.csv
- The resource is the same, but the action does not match.
An Amazon Resource Name (ARN) identifies an AWS resource. This example includes the object key report.csv, not just a bucket name. Bucket-level operations and object-level operations can require different resource types. Check which resource the requested action supports.
| Request | Relationship to this statement |
|---|---|
| GetObject for report.csv | Action and Resource match |
| PutObject for report.csv | Action does not match |
| GetObject for other.csv | Resource does not match |
A matching Allow is not the complete decision
This snippet teaches how to read one rule. Real authorization can involve other statements, resource policies, permissions limits, organization controls and request conditions. Adding an Allow does not override an applicable explicit Deny.
Condition adds criteria for a statement to apply. It is not optional to inspect an existing condition just because a basic example omits it. Elements such as NotAction and NotResource have their own meanings and must not be silently treated as Action and Resource.
Check a changed request
Choose an option to see the result and explanation.
After reading, change one condition at a time
- Write the requested action and target first.
- Read each statement’s Effect, Action, Resource and any conditions.
- Separate statement matching from effective permission; inspect one-condition changes in the IAM lab.
Check, then explain in your own words
- Identify whether the action is GetObject or PutObject.
- Check whether the resource is the same object.
- Explain statement matching separately from effective authorization.
Check your understanding: Should Version be changed to today’s date?
No. Version identifies the policy language version.
It is not a creation or modification date. Establish what an element means before changing its value.
Sources and conditions checked
The official references used in this lesson are collected here with their scope, conditions and corresponding sections. Independent expert review and live AWS comparison have not been performed.
- IAM JSON policy elementsChecked:
Scope and conditionsAWS policy syntax is broader than the educational input schema
Used in this lessonRead one small statement Match the action and resource separately A matching Allow is not the complete decision Check a changed request
- IAM policy evaluation logicChecked:
Scope and conditionsPolicy types and context matter; identity-only lab is a subset
Used in this lessonRead one small statement Match the action and resource separately A matching Allow is not the complete decision Check a changed request
Scope and conditionsPolicy language version, distinct from a managed policy revision and a creation date.
Used in this lessonRead one small statement
- IAM JSON policy elements: SidChecked:
Scope and conditionsOptional statement identifier; naming a statement does not grant an operation.
Used in this lessonRead one small statement
Scope and conditionsResource ARNs, wildcard scope and service-specific resource support; not a complete permission decision.
Used in this lessonMatch the action and resource separately