AWS Identity Center

Manage temporary elevated access in AWS IAM Identity Center

AWS IAM Identity Center (formerly AWS Single Sign-On) is the recommended service for managing workforce access to multiple AWS accounts and applications. It provides a central place to assign users and groups temporary, permission-scoped access to AWS accounts using permission sets — without creating long-lived IAM credentials.

With AWS IAM Identity Center, you can:

  • Provision account assignments: Grant a user or group access to a specific AWS account with a specific permission set — the core primitive of temporary elevated access
  • Revoke access on demand: Delete account assignments to immediately remove elevated permissions when they are no longer needed
  • Look up users by email: Resolve a federated identity (email address) to an Identity Store user ID for programmatic access provisioning
  • List permission sets: Enumerate the available permission sets (e.g., ReadOnly, PowerUser, AdministratorAccess) defined in your Identity Center instance
  • Monitor assignment status: Poll the provisioning status of create/delete operations, which are asynchronous in AWS
  • List accounts in your organization: Enumerate all AWS accounts in your AWS Organizations structure to populate access request dropdowns
  • Manage groups: List groups and resolve group IDs by display name for group-based access grants

In Sim, the AWS Identity Center integration is designed to power TEAM (Temporary Elevated Access Management) workflows — automated pipelines where users request elevated access, approvers approve or deny it, access is provisioned with a time limit, and auto-revocation removes it when the window expires. This replaces manual console-based access management with auditable, agent-driven workflows that integrate with Slack, email, ticketing systems, and CloudTrail for full traceability.

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.

Tools

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
instancesjsonList of Identity Center instances with instanceArn, identityStoreId, name, status, statusReason
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
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
accountsjsonList of AWS accounts with id, arn, name, email, status
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
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
permissionSetsjsonList of permission sets with permissionSetArn, name, description, sessionDuration
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_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_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
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
groupsjsonList of groups with groupId, displayName, description
nextTokenstringPagination token for the next page of results
countnumberNumber of groups 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 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 or Delete Account Assignment

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

List all account assignments for a specific user or group across all accounts

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
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
assignmentsjsonList of account assignments with accountId, permissionSetArn, principalType, principalId
nextTokenstringPagination token for the next page of results
countnumberNumber of assignments returned

On this page