AWS Identity Center

Use AWS IAM Identity Center to assign or revoke permission sets for AWS accounts, resolve users and groups, and inspect account access.

The same operations support the reverse direction — access review. Starting from an account, an agent can list its assignments, resolve the principals, expand groups into their members, and produce a written report of exactly who can reach that account and through which permission set.

One detail shapes how that review has to be built. AWS requires a permission set ARN alongside the account ID on this call, so List Assignments For Account returns only the assignments granted through that one permission set — not every assignment on the account. To cover an account completely, run List Permission Sets for the instance first, then call List Assignments For Account once per permission set and combine the results. Skipping that loop silently omits access granted through the permission sets you did not ask about.

Two AWS behaviors are worth knowing. Creating and deleting an account assignment are asynchronous: both return a request ID, and each has its own status poller — use Check Assignment Status for creations and Check Assignment Deletion Status for deletions, as the two request-ID types are not interchangeable. And the account-listing operations call AWS Organizations, which is global per partition; the block resolves the correct endpoint for commercial, GovCloud, and China regions automatically.

Usage Instructions

Provision and revoke temporary access to AWS accounts via IAM Identity Center (SSO). Assign permission sets to users or groups, look up users by email, and list accounts and permission sets for access request workflows.

Actions

Identity Center List Instances

List all AWS IAM Identity Center instances in your account

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
maxResultsnumberNoMaximum number of instances to return (1-100)
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
instancesarrayIdentity Center instances in the region
instanceArnstringARN of the Identity Center instance
identityStoreIdstringIdentity Store ID backing the instance
namestringInstance name
statusstringInstance status
statusReasonstringExplanation when the instance is not ACTIVE
ownerAccountIdstringAWS account that owns the instance
createdDatestringISO 8601 date the instance was created
nextTokenstringPagination token for the next page of results
countnumberNumber of instances returned

Identity Center List Accounts

List all AWS accounts in your organization

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
maxResultsnumberNoMaximum number of accounts to return (1-20; the AWS Organizations ceiling)
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
accountsarrayAccounts in the AWS organization
idstringAWS account ID
arnstringAWS account ARN
namestringAccount name
emailstringRoot email address of the account
statusstringAccount status (e.g., ACTIVE, SUSPENDED)
joinedTimestampstringISO 8601 date the account joined the organization
nextTokenstringPagination token for the next page of results
countnumberNumber of accounts returned

Identity Center Describe Account

Retrieve details about a specific AWS account by its ID

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
accountIdstringYesAWS account ID to describe

Output

ParameterTypeDescription
idstringAWS account ID
arnstringAWS account ARN
namestringAccount name
emailstringRoot email address of the account
statusstringAccount status (ACTIVE, SUSPENDED, etc.)
joinedTimestampstringDate the account joined the organization

Identity Center List Permission Sets

List all permission sets defined in an IAM Identity Center instance

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
instanceArnstringYesARN of the Identity Center instance
maxResultsnumberNoMaximum number of permission sets to return (1-100)
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
permissionSetsarrayPermission sets defined on the instance
permissionSetArnstringARN of the permission set
namestringPermission set name
descriptionstringPermission set description
sessionDurationstringISO 8601 session duration (e.g., PT1H)
createdDatestringISO 8601 date the permission set was created
nextTokenstringPagination token for the next page of results
countnumberNumber of permission sets returned

Identity Center Get User

Look up a user in the Identity Store by email address

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
identityStoreIdstringYesIdentity Store ID (from the Identity Center instance)
emailstringYesEmail address of the user to look up

Output

ParameterTypeDescription
userIdstringIdentity Store user ID (use as principalId)
userNamestringUsername in the Identity Store
displayNamestringDisplay name of the user
emailstringEmail address of the user

Identity Center Describe User

Resolve an Identity Store user ID to the user behind it. Use to turn the principalId on an account assignment into a name and email.

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
identityStoreIdstringYesIdentity Store ID (e.g., d-1234567890)
userIdstringYesIdentity Store user ID, such as the principalId on a USER account assignment

Output

ParameterTypeDescription
userIdstringIdentity Store user ID
userNamestringUsername in the Identity Store
displayNamestringDisplay name of the user, or null when the Identity Store omits it
emailstringPrimary email address, or null when the user has no email attribute
userStatusstringAccount status (ENABLED or DISABLED), or null when the Identity Store omits it
titlestringJob title, or null when the Identity Store omits it
externalIdsarrayExternal identity provider IDs linked to the user
issuerstringIdentity provider that issued the ID
idstringIdentifier at the issuer

Identity Center Get Group

Look up a group in the Identity Store by display name

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
identityStoreIdstringYesIdentity Store ID (from the Identity Center instance)
displayNamestringYesDisplay name of the group to look up

Output

ParameterTypeDescription
groupIdstringIdentity Store group ID (use as principalId)
displayNamestringDisplay name of the group
descriptionstringGroup description

Identity Center Describe Group

Resolve an Identity Store group ID to the group behind it. Use to turn the principalId on an account assignment into a group name.

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
identityStoreIdstringYesIdentity Store ID (e.g., d-1234567890)
groupIdstringYesIdentity Store group ID, such as the principalId on a GROUP account assignment

Output

ParameterTypeDescription
groupIdstringIdentity Store group ID
displayNamestringDisplay name of the group
descriptionstringGroup description
externalIdsarrayExternal identity provider IDs linked to the group
issuerstringIdentity provider that issued the ID
idstringIdentifier at the issuer

Identity Center List Groups

List all groups in the Identity Store

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
identityStoreIdstringYesIdentity Store ID (from the Identity Center instance)
maxResultsnumberNoMaximum number of groups to return (1-100)
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
groupsarrayGroups in the Identity Store
groupIdstringIdentity Store group ID (use as principalId)
displayNamestringGroup display name
descriptionstringGroup description
externalIdsarrayExternal identity provider IDs linked to the group
issuerstringIdentity provider that issued the ID
idstringIdentifier at the issuer
nextTokenstringPagination token for the next page of results
countnumberNumber of groups returned

Identity Center List Group Memberships

List the users who belong to an Identity Store group

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
identityStoreIdstringYesIdentity Store ID (e.g., d-1234567890)
groupIdstringYesIdentity Store group ID whose members to list
maxResultsnumberNoMaximum number of memberships to return (1-100)
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
membershipsarrayMembers of the group
membershipIdstringIdentity Store membership ID
groupIdstringIdentity Store group ID
userIdstringIdentity Store user ID of the member — resolve with Describe User. Null when the member is not a user.
nextTokenstringPagination token for the next page of results
countnumberNumber of memberships returned

Identity Center Create Account Assignment

Grant a user or group access to an AWS account via a permission set (temporary elevated access)

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
instanceArnstringYesARN of the Identity Center instance
accountIdstringYesAWS account ID to grant access to
permissionSetArnstringYesARN of the permission set to assign
principalTypestringYesType of principal: USER or GROUP
principalIdstringYesIdentity Store ID of the user or group

Output

ParameterTypeDescription
messagestringStatus message
statusstringProvisioning status: IN_PROGRESS, FAILED, or SUCCEEDED
requestIdstringRequest ID to use with Check Assignment Status
accountIdstringTarget AWS account ID
permissionSetArnstringPermission set ARN
principalTypestringPrincipal type (USER or GROUP)
principalIdstringPrincipal ID
failureReasonstringReason for failure if status is FAILED
createdDatestringDate the request was created

Identity Center Delete Account Assignment

Revoke a user or group access to an AWS account by removing a permission set assignment

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
instanceArnstringYesARN of the Identity Center instance
accountIdstringYesAWS account ID to revoke access from
permissionSetArnstringYesARN of the permission set to remove
principalTypestringYesType of principal: USER or GROUP
principalIdstringYesIdentity Store ID of the user or group

Output

ParameterTypeDescription
messagestringStatus message
statusstringDeprovisioning status: IN_PROGRESS, FAILED, or SUCCEEDED
requestIdstringRequest ID to use with Check Assignment Deletion Status
accountIdstringTarget AWS account ID
permissionSetArnstringPermission set ARN
principalTypestringPrincipal type (USER or GROUP)
principalIdstringPrincipal ID
failureReasonstringReason for failure if status is FAILED
createdDatestringDate the request was created

Identity Center Check Assignment Status

Check the provisioning status of an account assignment creation request

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
instanceArnstringYesARN of the Identity Center instance
requestIdstringYesRequest ID returned from Create Account Assignment. Deletion request IDs are not accepted — use Check Assignment Deletion Status for those.

Output

ParameterTypeDescription
messagestringHuman-readable status message
statusstringCurrent status: IN_PROGRESS, FAILED, or SUCCEEDED
requestIdstringThe request ID that was checked
accountIdstringTarget AWS account ID
permissionSetArnstringPermission set ARN
principalTypestringPrincipal type (USER or GROUP)
principalIdstringPrincipal ID
failureReasonstringReason for failure if status is FAILED
createdDatestringDate the request was created

Identity Center Check Assignment Deletion Status

Check the deprovisioning status of an account assignment deletion request

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
instanceArnstringYesARN of the Identity Center instance
requestIdstringYesRequest ID returned from Delete Account Assignment

Output

ParameterTypeDescription
messagestringHuman-readable status message
statusstringCurrent deletion status: IN_PROGRESS, FAILED, or SUCCEEDED
requestIdstringThe deletion request ID that was checked
accountIdstringTarget AWS account ID
permissionSetArnstringPermission set ARN
principalTypestringPrincipal type (USER or GROUP)
principalIdstringPrincipal ID
failureReasonstringReason for failure if status is FAILED
createdDatestringDate the request was created

Identity Center List Account Assignments For Principal

List every account and permission set a specific user or group is assigned. Use List Assignments For Account to go the other way, from an account to its principals.

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
instanceArnstringYesARN of the Identity Center instance
principalIdstringYesIdentity Store ID of the user or group
principalTypestringYesType of principal: USER or GROUP
maxResultsnumberNoMaximum number of assignments to return (1-100)
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
assignmentsarrayAccounts and permission sets the principal is assigned
accountIdstringAWS account ID
permissionSetArnstringPermission set ARN
principalTypestringPrincipal type (USER or GROUP)
principalIdstringIdentity Store user or group ID
nextTokenstringPagination token for the next page of results
countnumberNumber of assignments returned

Identity Center List Assignments For Account

List every principal assigned a specific permission set on a specific AWS account. Use for per-account access reviews.

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
instanceArnstringYesARN of the Identity Center instance
accountIdstringYesAWS account ID to list assignments for (12 digits)
permissionSetArnstringYesARN of the permission set to list assignments for
maxResultsnumberNoMaximum number of assignments to return (1-100)
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
assignmentsarrayPrincipals assigned this permission set on the account
accountIdstringAWS account ID
permissionSetArnstringPermission set ARN
principalTypestringPrincipal type (USER or GROUP)
principalIdstringIdentity Store user or group ID — resolve with Describe User or Describe Group
nextTokenstringPagination token for the next page of results
countnumberNumber of assignments returned