AWS 044: IAM roles and temporary credentials
The problem
A team uses IAM roles and temporary credentials as a label or Console setting without proving the identity, scope, behavior, failure boundary, cost, or operational result. The configuration appears complete but the real requirement remains untested.
Final outcome
The learner will inspect, explain, test, and document IAM roles and temporary credentials. The submission must connect the Console and CLI view to the same AWS control, state what the evidence proves, diagnose one likely failure, and make a requirement-based architecture decision.
Learning outcomes
You will be able to:
- explain a role has no standard long-term credentials;
- explain trust and permission policies differ;
- explain service roles delegate to aws services;
- explain instance profiles deliver roles to ec2;
- explain session duration is bounded;
- distinguish successful configuration from successful workload behavior;
- preserve redacted evidence and complete the stated cleanup or retention decision.
Mental model
requirement
-> identity and permission
-> account, Region, and resource scope
-> configuration or request
-> observable state
-> workload result
-> failure evidence
-> cleanup or controlled retention
Never begin with a create button or a copied command. Start with the result that must be proven and the boundary that must remain protected.
Core facts
| Concept | What it means in practice |
|---|---|
| A role has no standard long-term credentials | A trusted principal assumes the role and AWS STS returns an access key ID, secret access key, and session token that expire. |
| Trust and permission policies differ | The trust policy controls who may assume the role and under which conditions. Identity policies on the role control what an established role session can do. |
| Service roles delegate to AWS services | A service role lets a service act for the customer. A service-linked role is predefined for one service and has a lifecycle controlled partly by that service. |
| Instance profiles deliver roles to EC2 | An instance profile is the container associated with an EC2 instance. The application retrieves temporary role credentials from instance metadata through the AWS credential provider chain. |
| Session duration is bounded | A role maximum session duration can be configured from one to twelve hours. Role chaining limits the chained role session to a maximum of one hour. |
| Regional STS endpoints improve resilience | AWS recommends regional STS endpoints where supported to reduce dependency on one endpoint and align session token behavior with the workload Region. |
How to reason about it
Temporary credentials reduce the value and lifetime of leaked secrets, but they do not make an overpowered role safe. Limit who can assume the role, what the role can do, session duration, session tags, external IDs where appropriate, and the networks or organizations from which assumption is allowed.
Passing a role and assuming a role are different. iam:PassRole lets a principal configure an AWS service to use a role and is not an API call itself. sts:AssumeRole creates a new role session for the caller. Both should be restricted to approved roles and services.
Use the following decision table as a starting point, then change the answer when the scenario changes.
| Requirement | Preferred direction | Why |
|---|---|---|
| AWS compute needs API permissions | Service-appropriate IAM role | The platform supplies and rotates temporary credentials. |
| A user needs temporary elevated access | Assume a tightly scoped role | Elevation becomes time-bound and auditable instead of changing permanent user permissions. |
| EC2 must use a role | Attach an instance profile | EC2 associates the profile, and the profile contains the role. |
| A chained session must last four hours | Redesign the credential path | Role chaining is limited to one hour even if the target role maximum is longer. |
Prerequisites, permissions, Region, and cost
Run this lesson as the approved non-root course identity. Begin with aws sts get-caller-identity, confirm the private account record, and set the fixed project Region before any regional query. IAM resources are global within an account, while STS endpoints and the services reached by an identity can be regional.
Use only the read or change actions required for this lesson. An AccessDenied result is evidence to analyse, not permission to switch to root or attach AdministratorAccess. Record the action, resource, principal type, request context, and smallest justified correction.
The listed cost tier is T0 - no resource creation. Free Tier eligibility and credits are account-specific. Before a mutating lab, identify every resource that can charge, estimate its duration, start a timer, and write the reverse cleanup order. A budget reports cost after billing data arrives and is not a real-time stop control.
AWS Management Console method
- Open IAM Roles and select a role.
- Inspect Trust relationships to identify who can assume it, then inspect Permissions to identify what a role session can do.
- Inspect Maximum session duration and, for EC2, confirm which instance profile supplies the role.
For every step record the service page, selected account and Region, exact object, visible state, and why that state matters. A Console label or green status is not enough unless it is tied to the final workload outcome.
AWS CLI or API evidence
Inspect a role trust policy, maximum session duration, and attached permissions as separate items.
aws iam get-role --role-name ExampleRole --query 'Role.{MaxSeconds:MaxSessionDuration,Trust:AssumeRolePolicyDocument}'
aws iam list-attached-role-policies --role-name ExampleRole
The trust document answers who can establish a session. Attached and inline role policies answer what the session might do, subject to every other limiting policy.
Before running the command, replace every placeholder, explain each option, and decide whether the operation is read-only or mutating. Capture the exit code immediately. Redact account IDs, ARNs, public addresses, request identifiers, and personal data before sharing.
The CLI and Console are clients of AWS APIs. Matching state across them increases confidence, but neither substitutes for data-plane or application verification.
Practical work
Create iam-roles-and-temporary-credentials-evidence.md. Record the problem, account and Region preflight, observed Console state, matching CLI result, every decision in the table, one intentional misconception, one failure diagnosis, and the retained-state or cleanup result.
The evidence package must include:
- non-root principal type, account verified privately, and Region;
- exact intended and observed state;
- one Console observation and the matching CLI or API result;
- one successful result and one denied, failed, or counterexample result;
- what each result does not prove;
- cost state and elapsed lab time;
- cleanup evidence or a named retained-state owner and next lesson.
Verification standard
Use three levels of proof:
- Control plane: the object or policy exists with the intended configuration.
- Data plane or behavior: the request, packet, session, storage path, or application does what the requirement states.
- Operations: monitoring, failure diagnosis, cost, ownership, and cleanup are known.
A control-plane response can precede final readiness. Use waiters or state polling where supported, then test the actual behavior. If a request times out, do not assume it failed. Inspect state and use documented idempotency before retrying a mutation.
Troubleshooting method
| Symptom | Evidence first | Smallest safe response |
|---|---|---|
| command cannot authenticate | credential source, expiry, caller preflight | restore approved temporary login |
| access is denied | action, resource, principal, all policy layers | correct only the missing or conflicting control |
| object appears missing | account, Region, filters, pagination, permission | align scope before creating anything |
| configured state exists but behavior fails | route, identity, dependency, logs, service state | test the next boundary in the path |
| cleanup is blocked | dependency inventory and owning service | remove dependants in reviewed reverse order |
Keep the original symptom and timestamp. State one hypothesis, make one reversible change, repeat the original test, and record rollback. Never open a management port to the world, expose credentials, disable TLS verification, format an unknown disk, or add broad permissions as a generic fix.
Architecture and certification decisions
Professional-level questions provide competing valid features. Identify the requirement that decides between them: human or workload identity, same-account or cross-account access, regional or zonal scope, stateful or stateless filtering, durable or ephemeral data, latency, RTO/RPO, cost, or operational ownership.
Explain why the selected option fits and why each plausible alternative fails one stated requirement. Do not rely on feature memorization or reproduce protected certification questions.
Knowledge check
- Does granting sts:AssumeRole to a user complete cross-account access?
Expected direction: No. The target role trust policy must also trust the caller, and organization controls must allow the operation.
- Can one EC2 instance profile contain multiple roles?
Expected direction: No. An instance profile can contain one role, although a role can be associated through instance profiles as supported.
- What happens when temporary credentials expire?
Expected direction: Requests fail and the credential provider must refresh or obtain a new session.
- Does iam:PassRole let the caller use the role credentials directly?
Expected direction: No. It authorizes passing the role to a supported AWS service.
Cost, cleanup, and retained state
No workload resource should remain unless this lesson explicitly creates and retains one for the next numbered lab.
Cleanup evidence includes the final state query, not only a successful delete response. Search related resources, other Regions used by the lab, retained storage, public IPv4 addresses, logging destinations, and service-managed dependencies. Schedule a later billing review because cost data can lag.
Completion gate
Pass when the practical artifact explains the real problem, matches Console and CLI evidence, answers every knowledge check, diagnoses one failure without broadening access, records cost, and proves cleanup or approved retention. The learner must defend one decision orally and name the requirement that would change it.