Introducción a los grupos de identidades de Amazon Cognito

Los grupos de identidades de Amazon Cognito permiten crear identidades únicas y asignar permisos a los usuarios. Su grupo de identidades puede incorporar identidades de los siguientes tipos de servicios de autenticación:

• Usuarios de un grupo de usuarios de Amazon Cognito

• Usuarios que se autentican con proveedores de identidad externos, como Facebook, Google, Apple OIDC o un proveedor de SAML identidad.

• Usuarios que se autentican de acuerdo con el proceso de autenticación existente.

Una vez que los usuarios se autentican con su proveedor y presentan la autorización a un grupo de identidades, obtienen credenciales temporales AWS . Las credenciales de los usuarios tienen permisos que usted define para acceder a otros Servicios de AWS.

Creación de un grupo de identidades en Amazon Cognito

Puede crear un grupo de identidades a través de la consola de Amazon Cognito o puede usar AWS Command Line Interface (CLI) o Amazon Cognito. APIs El siguiente procedimiento es una guía general para crear un nuevo grupo de identidades en la consola. También puedes ir directamente a la consola y seguir la experiencia guiada y el contenido de la ayuda integrada.

Para crear un grupo de identidades nuevo en la consola

1. Inicie sesión en la consola de Amazon Cognito y seleccione Grupos de identidades.

2. Elija Crear grupo de identidades.

3. En Configurar confianza de grupo de identidades, elija configurar el grupo de identidades para el acceso autenticado, el acceso de invitado o ambos.

   1. Si elige Acceso autenticado, seleccione uno o más tipos de identidades que desee establecer como origen de identidades autenticadas en el grupo de identidades. Si configura un Proveedor de desarrolladores personalizado, no podrá modificarlo ni eliminarlo después de crear el grupo de identidades.

4. En Configurar permisos, elige un IAM rol predeterminado para los usuarios autenticados o invitados de tu grupo de identidades.

   1. Elija Crear un nuevo IAM rol si quiere que Amazon Cognito cree un nuevo rol para usted con permisos básicos y una relación de confianza con su grupo de identidades. Introduzca un nombre de IAM rol para identificar su nuevo rol, por ejemplomyidentitypool_authenticatedrole. Seleccione Ver documento de política para revisar los permisos que Amazon Cognito asignará a su nueva IAM función.

   2. Puede optar por utilizar un IAM rol existente si ya tiene uno Cuenta de AWS que desee utilizar. Debe configurar su política de confianza de IAM roles para incluirlacognito-identity.amazonaws.com. Configure la política de confianza del rol para que solo permita que Amazon Cognito asuma el rol cuando presente pruebas de que la solicitud proviene de un usuario autenticado del grupo de identidades específico. Para obtener más información, consulte Confianza y permisos de rol.

5. En Connect Identity Providers, introduzca los detalles de los proveedores de identidad (IdPs) que eligió en Configurar la confianza del grupo de identidades. Es posible que se le pida que proporcione información sobre el cliente de la OAuth aplicación, que elija un grupo de usuarios de Amazon Cognito, que elija un IAM IdP o que introduzca un identificador personalizado para un proveedor desarrollador.

   1. Elija la Configuración del rol para cada IdP. Puede asignar a los usuarios de ese IdP el Rol predeterminado que configuró al configurar el Rol autenticado o puede Elegir el rol con reglas. Con un IdP del grupo de usuarios de Amazon Cognito, también puede Elegir un rol con preferred_role en los tokens. Para obtener más información acerca de la reclamación de cognito:preferred_role, consulte Asignación de valores de prioridad a los grupos.

      1. Si eligió Elegir rol con reglas, ingrese la Reclamación de origen de la autenticación del usuario, el Operador con el que desea comparar la afirmación, el Valor que hará que coincida con esta elección de rol y el Rol que desea asignar cuando la Asignación del rol coincida. Seleccione Agregar otra para crear una regla adicional en función de una condición diferente.

      2. Elija una Resolución de rol. Cuando las reclamaciones del usuario no coinciden con las reglas, puede denegar las credenciales o emitir credenciales para el Rol autenticado.

   2. Configure Atributos para el control de acceso para cada IdP. Los atributos del control de acceso asignan las reclamaciones de los usuarios a las Etiquetas de las entidades principales que Amazon Cognito aplica a la sesión temporal. Puede crear IAM políticas para filtrar el acceso de los usuarios en función de las etiquetas que aplique a su sesión.

      1. Para no aplicar ninguna etiqueta de entidad principal, elija Inactivo.

      2. Para aplicar etiquetas de entidades principales en función de las reclamaciones sub y aud, elija Usar mapeos predeterminados.

      3. Para crear su propio esquema personalizado de atributos para las etiquetas de la entidades principales, elija Usar mapeos personalizados. A continuación, ingrese una Clave de etiqueta que desee obtener de cada Reclamación que desee representar en una etiqueta.

6. En Configurar propiedades, ingrese un Nombre en Nombre de grupo de identidades.

7. En Autenticación básica (clásica), elija si desea Activar el flujo básico. Con el flujo básico activo, puedes omitir las funciones que seleccionaste para ti IdPs y llamar AssumeRoleWithWebIdentitydirectamente. Para obtener más información, consulte Flujo de autenticación de grupos de identidades.

8. En Etiquetas, elija Agregar etiqueta si quiere aplicar etiquetas al grupo de identidades.

9. En Revisar y crear, confirme las selecciones que realizó para el nuevo grupo de identidades. Seleccione Editar para volver al asistente y cambiar cualquier configuración. Cuando haya acabado, seleccione Crear grupo de identidades.

Configuración de una SDK

Para usar los grupos de identidades de Amazon Cognito, configure AWS Amplify AWS SDK for Java, el o el. AWS SDK for .NET Para obtener más información, consulte los siguientes temas.

• Configuración del formulario JavaScript en la guía SDK para AWS SDK for JavaScript desarrolladores

• Documentación de Amplify en el Amplify Dev Center

• Proveedor de credenciales de Amazon Cognito en la Guía para desarrolladores de AWS SDK for .NET

Integración de los proveedores de identidad

Los grupos de identidades de Amazon Cognito (identidades federadas) admiten la autenticación de usuarios a través de grupos de usuarios de Amazon Cognito, proveedores de identidades federadas (incluidos Amazon, Facebook, Google, Apple y proveedores de identidad) e identidades no autenticadas. SAML Esta característica también es compatible con Identidades autenticadas por el desarrollador, que le permite registrar y autenticar usuarios siguiendo su propio proceso de autenticación de backend.

Si desea obtener más información sobre el uso de un grupo de usuarios de Amazon Cognito para crear su propio directorio de usuarios, consulte Grupos de usuarios de Amazon Cognito y Acceder Servicios de AWS mediante un grupo de identidades después de iniciar sesión.

Para obtener más información acerca del uso de proveedores de identidad externos, consulte Grupos de identidades y proveedores de identidades de terceros.

Para obtener más información acerca de la integración de su propio proceso de autenticación de backend, consulte Identidades autenticadas por el desarrollador.

Obtención de credenciales

Los grupos de identidades de Amazon Cognito proporcionan AWS credenciales temporales para los usuarios que son invitados (sin autenticar) y para los usuarios que se han autenticado y recibido un token. Con esas AWS credenciales, tu aplicación puede acceder de forma segura a un backend interno AWS o externo AWS a través de Amazon API Gateway. Consulte Obtención de credenciales.