AWS Identity Center

AWS IAM Identity Center (anteriormente AWS Single Sign-On) é o serviço recomendado para gerenciar o acesso da força de trabalho a várias contas e aplicações AWS. Ele oferece um lugar central para atribuir a usuários e grupos acesso temporário e com escopo de permissão a contas AWS usando permission sets — sem criar credenciais IAM de longa duração.

Com o AWS IAM Identity Center, você pode:

  • Provisionar atribuições de conta: Conceder a um usuário ou grupo acesso a uma conta AWS específica com um permission set específico — o primitivo central do acesso elevado temporário
  • Revogar acesso sob demanda: Excluir atribuições de conta para remover imediatamente permissões elevadas quando não forem mais necessárias
  • Buscar usuários por e-mail: Resolver uma identidade federada (endereço de e-mail) para um ID de usuário do Identity Store para provisionamento de acesso programático
  • Listar permission sets: Enumerar os permission sets disponíveis (ex.: ReadOnly, PowerUser, AdministratorAccess) definidos na sua instância do Identity Center
  • Monitorar status de atribuição: Consultar o status de provisionamento de operações de create/delete, que são assíncronas na AWS
  • Listar contas na sua organização: Enumerar todas as contas AWS na estrutura do AWS Organizations para preencher dropdowns de solicitação de acesso
  • Gerenciar grupos: Listar grupos e resolver IDs de grupo pelo display name para concessões de acesso baseadas em grupo

No Zoen, a integração AWS Identity Center é projetada para alimentar fluxos de trabalho TEAM (Temporary Elevated Access Management) — pipelines automatizados em que usuários solicitam acesso elevado, aprovadores aprovam ou negam, o acesso é provisionado com limite de tempo e a auto-revogação o remove quando a janela expira. Isso substitui o gerenciamento manual de acesso via console por fluxos de trabalho auditáveis e orientados por agentes que se integram a Slack, e-mail, sistemas de tickets e CloudTrail para rastreabilidade completa.

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
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