Security in Identity and Access Management
The IAM actions, which of them amount to administrator rights, what is recorded, and how credentials are kept.
IAM actions
IAM is not regional: its resource names leave the region empty, such as
rn:ews::org-EXAMPLE1234:iam:user/<user id>, …:iam:group/<id>, …:iam:role/<id>,
…:iam:policy/<id> and …:iam:access-key/<id>.
| Action | Access | What it allows |
|---|---|---|
iam:ListUsers | Read | List IAM users |
iam:GetUser | Read | Describe an IAM user |
iam:CreateUser | Write | Create IAM users |
iam:DeleteUser | Write · destructive | Delete IAM users |
iam:AttachUserPolicy | Write | Attach a policy directly to a user |
iam:DetachUserPolicy | Write · destructive | Detach a policy from a user |
iam:AssignUserRole | Write | Assign a role to a user |
iam:RemoveUserRole | Write · destructive | Remove a role from a user |
iam:GetLoginProfile | Read | Show an IAM user's console access: on or off, last sign-in, locked until |
iam:CreateLoginProfile | Write | Give an IAM user a console password (sign-in with organization, user name, password) |
iam:UpdateLoginProfile | Write · destructive | Reset an IAM user's console password, unlock it, or turn console access off and on |
iam:DeleteLoginProfile | Write · destructive | Remove an IAM user's console password and end their console sessions |
iam:DeactivateMfaDevice | Write · destructive | Remove an IAM user's second factors (authenticator app, recovery codes, passkeys), e.g. after a lost phone |
iam:GetPasswordPolicy | Read | Show the organization's password policy for IAM-user console passwords |
iam:UpdatePasswordPolicy | Write · destructive | Set the organization's password policy for IAM-user console passwords (length, lockout, session length, on/off) |
iam:DeletePasswordPolicy | Write · destructive | Return the organization's password policy to the defaults |
iam:GetCliAuthPolicy | Read | Show the organization's CLI sign-in policy (Touch ID or passkey required, personal access key age) and what a change would affect |
iam:UpdateCliAuthPolicy | Write · destructive | Set the organization's CLI sign-in policy: require Touch ID or a passkey for people's CLI sessions, and refuse people's access keys past an age |
iam:ListGroups | Read | List IAM groups |
iam:GetGroup | Read | Describe an IAM group |
iam:CreateGroup | Write | Create IAM groups |
iam:UpdateGroup | Write · destructive | Update an IAM group |
iam:DeleteGroup | Write · destructive | Delete IAM groups |
iam:AddUserToGroup | Write | Add a user to a group |
iam:RemoveUserFromGroup | Write · destructive | Remove a user from a group |
iam:AttachGroupPolicy | Write | Attach a policy to a group |
iam:DetachGroupPolicy | Write · destructive | Detach a policy from a group |
iam:ListRoles | Read | List IAM roles |
iam:GetRole | Read | Describe an IAM role |
iam:CreateRole | Write | Create IAM roles |
iam:DeleteRole | Write · destructive | Delete IAM roles |
iam:AttachRolePolicy | Write | Attach a policy to a role |
iam:DetachRolePolicy | Write · destructive | Detach a policy from a role |
iam:UpdateAssumeRolePolicy | Write · destructive | Change which federated workloads (e.g. GitHub Actions jobs) may assume a role |
iam:RevokeRoleSessions | Write · destructive | Invalidate every temporary credential issued for a role |
iam:AssumeRoleWithWebIdentity | Write | Exchange an OIDC token for temporary credentials (decided by the role trust policy) |
iam:AssumeRoleForInstance | Write | An instance gets temporary credentials for its instance role (decided by its identity and iam:PassRole at launch) |
iam:PassRole | Write | Hand a role to a service that will act as it, such as a Kubernetes node group |
iam:ListOpenIdConnectProviders | Read | List OIDC identity providers |
iam:GetOpenIdConnectProvider | Read | Describe an OIDC identity provider |
iam:CreateOpenIdConnectProvider | Write | Register an OIDC identity provider such as GitHub Actions |
iam:UpdateOpenIdConnectProvider | Write · destructive | Change the accepted audiences of an OIDC identity provider |
iam:DeleteOpenIdConnectProvider | Write · destructive | Remove an OIDC identity provider |
iam:ListSsoConnections | Read | List single sign-on connections and their domains |
iam:GetSsoConnection | Read | Describe a single sign-on connection |
iam:CreateSsoConnection | Write | Connect an OIDC or SAML identity provider for console sign-in |
iam:UpdateSsoConnection | Write · destructive | Change a single sign-on connection: settings, enable, enforce, domains, default role |
iam:DeleteSsoConnection | Write · destructive | Remove a single sign-on connection |
iam:VerifySsoDomain | Write | Check a domain's DNS record and mark it verified for single sign-on |
iam:ListPolicies | Read | List IAM policies |
iam:GetPolicy | Read | Describe an IAM policy |
iam:CreatePolicy | Write | Create IAM policies |
iam:UpdatePolicy | Write · destructive | Update an IAM policy |
iam:DeletePolicy | Write · destructive | Delete IAM policies |
iam:SimulatePrincipalPolicy | Read | Test whether a user or role may perform an action on a resource, and see which statement of which attached policy decides it |
iam:SimulateCustomPolicy | Read | Test a policy document that is not saved or attached yet against an action and resource |
iam:ListAccessKeys | Read | List access keys |
iam:CreateAccessKey | Write | Create access keys |
iam:UpdateAccessKey | Write · destructive | Activate or deactivate an access key |
iam:DeleteAccessKey | Write · destructive | Delete access keys |
iam:UpdateOrganization | Write · destructive | Rename the organization |
iam:UpdateOrganizationInfrastructure | Write | Choose where the organization's servers are made: managed, or the customer's own cloud project |
iam:UpdateOrganizationAuthPolicy | Write · destructive | Require two-factor sign-in for the organization's members, or stop requiring it |
iam:GetOrganizationDeletion | Read | View the closure request and what still blocks it |
iam:RequestOrganizationDeletion | Write · destructive | Start the 30-day closure window for the organization |
iam:CancelOrganizationDeletion | Write | Cancel a pending closure request and keep the organization |
iam:DeleteOrganization | Write · destructive | Close the organization once the window has passed and nothing is left running |
iam:ListMembers | Read | List org members |
iam:UpdateMember | Write · destructive | Change an org member role |
iam:RemoveMember | Write · destructive | Remove an org member |
iam:ListInvitations | Read | List pending invitations |
iam:InviteUser | Write | Invite a user to the org |
iam:GetInvitationLink | Read · sensitive | Get the join link of a pending invitation, to pass on by hand |
iam:ResendInvitation | Write | Send a pending invitation again and extend its expiry |
iam:CancelInvitation | Write · destructive | Cancel a pending invitation |
iam:GetAuditLogs | Read | View, search, export and verify the audit log; read its signed digests and settings |
iam:UpdateAuditLogSettings | Write · destructive | Change how long audit log entries are kept (90 days to 10 years) |
iam:ListAuditDestinations | Read | List where the audit log is exported to and which alarms watch it |
iam:CreateAuditDestination | Write | Export the audit log to S3, a webhook or syslog, or alarm by email on matches |
iam:UpdateAuditDestination | Write · destructive | Change, pause, resume or replay an audit log export or alarm |
iam:DeleteAuditDestination | Write · destructive | Remove an audit log export or alarm |
iam:TestAuditDestination | Write | Send a test event to an audit log export or alarm |
iam:ListUserSessions | Read | List a member's console sessions: device, address, sign-in method |
iam:RevokeUserSessions | Write · destructive | Sign a member out of the console everywhere (ends every session they have) |
iam:BlockUserDeviceKey | Write · destructive | Block one of a member's CLI devices (Touch ID key) in this organization: it signs in here no more and its sessions here end |
iam:UnblockUserDeviceKey | Write | Lift this organization's block on one of a member's CLI devices |
iam:ListScimTokens | Read | List the SCIM provisioning tokens of single sign-on connections |
iam:CreateScimToken | Write | Create a SCIM token so an identity provider can provision users and groups |
iam:DeleteScimToken | Write · destructive | Revoke a SCIM provisioning token |
iam:ListAgentSessions | Read | List the AI agent sessions of every member, with what they may do |
iam:UpdateAgentSession | Write | Allow another member’s AI agent session to make changes, or approve one destructive call it planned |
iam:EndAgentSession | Write · destructive | End another member’s AI agent session or revoke its connection |
iam:UpdateAgentSettings | Write · destructive | Change the AI agent rate limits, or switch off changes by every AI agent |
Generated from the service’s IAM descriptor. Sensitive reads hand over secret material or source code and are recorded in the audit log like writes; destructive writes delete, overwrite or revoke.
Actions that amount to administrator rights
iam:CreatePolicyoriam:UpdatePolicytogether withiam:AttachUserPolicy(or the group and role variants) lets a principal write any document and attach it, also to itself. Give them only to administrators.- A grant made on a resource's Access panel is checked against your own permissions: you cannot hand out an action you are not allowed yourself. Attaching a policy you wrote is not checked this way.
iam:AssignUserRolegives the user every policy of the role, andiam:AddUserToGroupevery policy of the group.iam:CreateAccessKeyon another user creates a credential that acts as that user.
PowerUserAccess and DeveloperAccess include no IAM action, so neither can change anybody's
permissions.
Audit
Every IAM write is recorded in the audit log with its outcome, allowed or refused, and so are
sensitive reads such as iam:GetInvitationLink. A refused ordinary read that ends in 403 is
recorded at most once a minute per principal and action. Sign-ins, sign-in failures, CLI sign-in
approvals (auth:ApproveDeviceLogin), organization switches, single sign-on group changes
(auth:SsoGroupSync) and token exchanges for a role that exists
(iam:AssumeRoleWithWebIdentity, with the token's claims once the token is verified) are recorded
too. See Monitoring.
Credentials
- Access keys. The secret is shown once, at creation, and cannot be read again. A SHA-256 hash of it checks API requests; an encrypted copy lets S3 requests signed with it be checked. A key can be made inactive or deleted, and expires; see Manage access keys.
- Console passwords of IAM users follow the organization's password policy and lock after wrong attempts; see Set the password policy.
- Second factors. An authenticator app or a passkey, which an organization can require; see Turn on two-factor sign-in.
- Single sign-on. An OIDC connection's client secret is stored encrypted and never returned. SCIM tokens are shown once and stored as a hash.
- Role sessions. A token exchange mints a key that lasts at most one hour. Exchanges are limited to 30 a minute per client address and 60 a minute per role.
Isolation between organizations
A credential belongs to one organization, and every request acts in that organization. An organization id in a request body or path is never used to decide access. A grant or a simulation that names another organization's resource is refused.