Acciones, recursos y claves de condición para los grupos de usuarios de Amazon Cognito

Grupos de usuarios de Amazon Cognito (prefijo de servicio: cognito-idp) proporciona las siguientes claves de contexto de condición, acciones y recursos específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

• Obtenga información para configurar este servicio.

• Vea una lista de las operaciones de API disponibles para este servicio.

• Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos del IAM.

Acciones definidas por los grupos de usuarios de Amazon Cognito

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
AddCustomAttributes	Concede permiso para agregar atributos de usuario al esquema del grupo de usuarios	Escritura	userpool*
AdminAddUserToGroup	Concede permiso para agregar cualquier usuario a cualquier grupo	Escritura	userpool*
AdminConfirmSignUp	Concede permiso para confirmar el registro de cualquier usuario sin un código de confirmación	Escritura	userpool*
AdminCreateUser	Concede permiso para crear nuevos usuarios y enviar mensajes de bienvenida por correo electrónico o SMS	Escritura	userpool*
AdminDeleteUser	Concede permiso para eliminar cualquier usuario	Escritura	userpool*
AdminDeleteUserAttributes	Concede permiso para eliminar atributos de cualquier usuario	Escritura	userpool*
AdminDisableProviderForUser	Concede permiso para desvincular cualquier grupo de usuarios del grupo de usuarios de un proveedor de identidades (IdP) externo	Escritura	userpool*
AdminDisableUser	Concede permiso para desactivar cualquier usuario	Escritura	userpool*
AdminEnableUser	Concede permiso para activar cualquier usuario	Escritura	userpool*
AdminForgetDevice	Concede permiso para anular el registro de los dispositivos de cualquier usuario	Escritura	userpool*
AdminGetDevice	Concede permiso para obtener información sobre los dispositivos de cualquier usuario	Lectura	userpool*
AdminGetUser	Concede permiso para buscar cualquier usuario por nombre de usuario	Lectura	userpool*
AdminInitiateAuth	Concede permiso para autenticar cualquier usuario	Escritura	userpool*
AdminLinkProviderForUser	Concede permiso para vincular cualquier grupo de usuarios con un usuario de un IdP externo	Escritura	userpool*
AdminListDevices	Concede permiso para enumerar dispositivos recordados por cualquier usuario	Enumeración	userpool*
AdminListGroupsForUser	Concede permiso para enumerar los grupos a los que pertenece cualquier usuario	Enumeración	userpool*
AdminListUserAuthEvents	Concede permiso para enumerar eventos de inicio de sesión para cualquier usuario	Lectura	userpool*
AdminRemoveUserFromGroup	Concede permiso para eliminar un usuario de cualquier grupo	Escritura	userpool*
AdminResetUserPassword	Concede permiso para restablecer la contraseña de cualquier usuario	Escritura	userpool*
AdminRespondToAuthChallenge	Concede permiso para responder a un desafío de autenticación durante la autenticación de cualquier usuario	Escritura	userpool*
AdminSetUserMFAPreference	Concede permiso para establecer el método de MFA preferido de cualquier usuario	Escritura	userpool*
AdminSetUserPassword	Concede permiso para establecer la contraseña de cualquier usuario	Escritura	userpool*
AdminSetUserSettings	Concede permiso para establecer la configuración de usuario para cualquier usuario	Escritura	userpool*
AdminUpdateAuthEventFeedback	Concede permiso para actualizar los comentarios de seguridad avanzados para cualquier evento de autenticación de usuario	Escritura	userpool*
AdminUpdateDeviceStatus	Concede permiso para actualizar el estado de cualquier dispositivo recordado por cualquier usuario	Escritura	userpool*
AdminUpdateUserAttributes	Concede permiso para actualizar los atributos estándar o personalizados de cualquier usuario	Escritura	userpool*
AdminUserGlobalSignOut	Concede permiso para cerrar la sesión de cualquier usuario en todas las sesiones	Escritura	userpool*
AssociateSoftwareToken	Otorga permiso para devolver un código único de clave secreta compartida generado para el usuario	Escritura
AssociateWebACL [solo permiso]	Concede permiso para asociar el grupo de usuarios con una ACL web de AWS WAF	Escritura	userpool*
			webacl*
ChangePassword	Otorga permiso para cambiar la contraseña de un usuario específico en un grupo de usuarios	Escritura
ConfirmDevice	Otorga permiso para confirmar el seguimiento del dispositivo. Esta llamada a la API es la llamada que comienza el seguimiento de dispositivos	Escritura
ConfirmForgotPassword	Otorga permiso para permitir a un usuario ingresar un código de confirmación a fin de restablecer una contraseña olvidada	Escritura
ConfirmSignUp	Otorga permiso para confirma el registro de un usuario y gestiona el alias existente de un usuario anterior	Escritura
CreateGroup	Concede permiso para crear nuevos grupos de usuarios	Escritura	userpool*
CreateIdentityProvider	Concede permiso para agregar proveedores de identidad a grupos de usuarios	Escritura	userpool*
CreateResourceServer	Concede permiso para crear y configurar ámbitos para los servidores de recursos de OAuth 2.0	Escritura	userpool*
CreateUserImportJob	Concede permiso para crear trabajos de importación CSV de usuario	Escritura	userpool*
CreateUserPool	Concede permiso para crear y establecer políticas de contraseñas para grupos de usuarios	Escritura		aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateUserPoolClient	Concede permiso para crear clientes de aplicaciones para grupos de usuarios	Escritura	userpool*
CreateUserPoolDomain	Concede permiso para agregar dominios de grupos de usuarios	Escritura	userpool*
DeleteGroup	Concede permiso para eliminar cualquier grupo de usuarios vacío	Escritura	userpool*
DeleteIdentityProvider	Concede permiso para eliminar cualquier proveedor de identidades de grupos de usuarios	Escritura	userpool*
DeleteResourceServer	Concede permiso para eliminar cualquier servidor de recursos de OAuth 2.0 de grupos de usuarios	Escritura	userpool*
DeleteUser	Otorga permiso para permitir que un usuario se elimine a sí mismo	Escritura
DeleteUserAttributes	Otorga permiso para eliminar los atributos de un usuario	Escritura
DeleteUserPool	Concede permiso para eliminar grupos de usuario	Escritura	userpool*
DeleteUserPoolClient	Concede permiso para eliminar cualquier cliente de aplicación de grupos de usuarios	Escritura	userpool*
DeleteUserPoolDomain	Concede permiso para eliminar cualquier dominio de grupos de usuarios	Escritura	userpool*
DescribeIdentityProvider	Concede permiso para describir cualquier proveedor de identidades de grupos de usuarios	Lectura	userpool*
DescribeResourceServer	Concede permiso para describir cualquier servidor de recursos de OAuth 2.0	Lectura	userpool*
DescribeRiskConfiguration	Concede permiso para describir la configuración de riesgos de los grupos de usuarios y los clientes de aplicaciones	Lectura	userpool*
DescribeUserImportJob	Concede permiso para describir cualquier trabajo de importación de usuarios	Lectura	userpool*
DescribeUserPool	Concede permiso para describir grupos de usuarios	Lectura	userpool*
DescribeUserPoolClient	Concede permiso para describir cualquier cliente de aplicación de grupos de usuarios	Lectura	userpool*
DescribeUserPoolDomain	Concede permiso para describir cualquier dominio de grupos de usuarios	Lectura
DisassociateWebACL [solo permiso]	Concede permiso para desasociar el grupo de usuarios de una ACL web de AWS WAF	Escritura	userpool*
ForgetDevice	Otorga permiso para olvidar el dispositivo especificado	Escritura
ForgotPassword	Otorga permiso para enviar un mensaje al usuario final con un código de confirmación que es necesario a fin de cambiar la contraseña del usuario	Escritura
GetCSVHeader	Concede permiso para generar encabezados para un archivo .csv de importación de usuarios	Lectura	userpool*
GetDevice	Otorga permiso para obtener el dispositivo	Lectura
GetGroup	Concede permiso para describir un grupo de usuarios	Lectura	userpool*
GetIdentityProviderByIdentifier	Concede permiso para correlacionar un identificador de IdP de grupo de usuarios con el nombre del IdP	Lectura	userpool*
GetLogDeliveryConfiguration	Otorga permiso para obtener la configuración detallada del registro de actividades de un grupo de usuarios	Lectura	userpool*
GetSigningCertificate	Concede permiso para buscar certificados de firma para grupos de usuarios	Lectura	userpool*
GetUICustomization	Concede permiso para obtener información de personalización de la IU para la IU alojada de cualquier cliente	Lectura	userpool*
GetUser	Otorga permiso para obtener los atributos de usuario y los metadatos de un usuario	Lectura
GetUserAttributeVerificationCode	Otorga permiso para obtener el código de verificación del atributo de usuario del nombre de atributo especificado	Lectura
GetUserPoolMfaConfig	Concede permiso para buscar la configuración MFA de grupos de usuarios	Lectura	userpool*
GetWebACLForResource [solo permiso]	Concede permiso para obtener la ACL web de AWS WAF asociada a un grupo de usuarios de Amazon Cognito	Lectura	userpool*
GlobalSignOut	Otorga permiso para cerrar la sesión de los usuarios en todos los dispositivos	Escritura
InitiateAuth	Otorga permiso para iniciar el flujo de autenticación	Escritura
ListDevices	Otorga permiso para enumerar los dispositivos	Enumeración
ListGroups	Concede permiso para enumerar todos los grupos en grupos de usuarios	Enumeración	userpool*
ListIdentityProviders	Concede permiso para enumerar todos los proveedores de identidad en grupos de usuarios	Enumeración	userpool*
ListResourceServers	Concede permiso para enumerar todos los servidores de recursos en grupos de usuarios	Enumeración	userpool*
ListResourcesForWebACL [solo permiso]	Concede permiso para enumerar los grupos de usuarios asociados a una ACL web de AWS WAF	Enumeración	webacl*
ListTagsForResource	Concede permiso para enumerar las etiquetas asignadas a un grupo de usuarios de Amazon Cognito	Enumeración	userpool
ListUserImportJobs	Concede permiso para enumerar todos los trabajos de importación de usuarios	Enumeración	userpool*
ListUserPoolClients	Concede permiso para enumerar todos los clientes de aplicaciones en grupos de usuarios	Enumeración	userpool*
ListUserPools	Concede permiso para enumerar todos los grupos de usuarios	Enumeración
ListUsers	Concede permiso para enumerar todos los usuarios de grupos de usuarios	Enumeración	userpool*
ListUsersInGroup	Concede permiso para enumerar a los usuarios de cualquier grupo	Enumeración	userpool*
ResendConfirmationCode	Otorga permiso para reenviar la confirmación (del registro) a un usuario específico en el grupo de usuarios	Escritura
RespondToAuthChallenge	Otorga permiso para responder al desafío de autenticación	Escritura
RevokeToken	Otorga permiso para invalidar todos los tokens de acceso generados por el token de actualización especificado	Escritura
SetLogDeliveryConfiguration	Otorga permiso para configurar o modificar la configuración detallada del registro de actividades de un grupo de usuarios	Escritura	userpool*
SetRiskConfiguration	Concede permiso para establecer la configuración de riesgos para grupos de usuarios y clientes de aplicaciones	Escritura	userpool*
SetUICustomization	Concede permiso para personalizar la IU alojada para cualquier cliente de aplicación	Escritura	userpool*
SetUserMFAPreference	Otorga permiso para establecer la preferencia de MFA del usuario del grupo de usuarios	Escritura
SetUserPoolMfaConfig	Concede permiso para actualizar la configuración MFA de un grupo de usuarios	Escritura	userpool*
SetUserSettings	Otorga permiso para establecer la configuración del usuario como autenticación multifactor (MFA)	Escritura
SignUp	Otorga permiso para registra al usuario en el grupo de usuarios especificado y crea un nombre de usuario, contraseña y atributos de usuario	Escritura
StartUserImportJob	Concede permiso para iniciar cualquier trabajo de importación de un usuario	Escritura	userpool*
StopUserImportJob	Concede permiso para detener cualquier trabajo de importación de un usuario	Escritura	userpool*
TagResource	Concede permiso para etiquetar un grupo de usuarios	Etiquetado	userpool
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Concede permiso para eliminar la etiqueta de un grupo de usuarios	Etiquetado	userpool
				aws:TagKeys
UpdateAuthEventFeedback	Otorga permiso para actualizar los comentarios del evento de autenticación de usuario	Escritura	userpool*
UpdateDeviceStatus	Otorga permiso para actualizar el estado del dispositivo	Escritura
UpdateGroup	Concede permiso para actualizar la configuración de cualquier grupo	Escritura	userpool*
UpdateIdentityProvider	Concede permiso para actualizar la configuración de cualquier IdP de grupo de usuarios	Escritura	userpool*
UpdateResourceServer	Concede permiso para actualizar la configuración de cualquier servidor de recursos OAuth 2.0	Escritura	userpool*
UpdateUserAttributes	Otorga permiso para permitir a un usuario actualizar un atributo específico (uno a la vez)	Escritura
UpdateUserPool	Concede permiso para actualizar la configuración de grupos de usuarios	Escritura	userpool*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateUserPoolClient	Concede permiso para actualizar cualquier cliente de grupos de usuarios	Escritura	userpool*
UpdateUserPoolDomain	Concede permiso para reemplazar el certificado por cualquier dominio personalizado	Escritura	userpool*
VerifySoftwareToken	Otorga permiso para registrar el código TOTP ingresado del usuario y marca el estado MFA del token de software del usuario como verificado si es correcto	Escritura
VerifyUserAttribute	Otorga permiso para verificar un atributo de usuario mediante un código de verificación de un solo uso	Escritura

Tipos de recurso definidos por los grupos de usuarios de Amazon Cognito

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
userpool	arn:${Partition}:cognito-idp:${Region}:${Account}:userpool/${UserPoolId}	aws:ResourceTag/${TagKey}
webacl	arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/webacl/${Name}/${Id}

Claves de condición de los grupos de usuarios de Amazon Cognito

Amazon Cognito User Pools define las siguientes claves de condición que se pueden utilizar en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Claves de condición.

Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.

Claves de condición	Descripción	Tipo
aws:RequestTag/${TagKey}	Filtra el acceso según si hay pares de clave-valor de etiqueta en la solicitud.	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso por los pares de clave-valor de etiqueta adjuntados al recurso	Cadena
aws:TagKeys	Filtra el acceso por una clave que está presente en la solicitud.	ArrayOfString