Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Niveles de autenticación con afirmaciones de ACR y AMR
Amazon Cognito puede registrar el nivel de autenticación de un usuario y los métodos que ha utilizado. Usted proporciona un nivel de autenticación objetivo como entrada cuando un usuario inicia sesión, y Amazon Cognito informa del nivel alcanzado por el usuario y los métodos que ha completado como reclamaciones en los tokens que emite. Estas afirmaciones se aplican a cualquier inicio de sesión, incluido el inicio de sesión inicial de un usuario.
Solicita un nivel de autenticación con el acr_values parámetro de los puntos finales de inicio de sesión, autorización e inicio de sesión administrados, o con el TARGET_ACR_VALUES parámetro equivalente en el flujo de la USER_AUTH API. Ambos aceptan una lista ordenada de niveles de autenticación objetivo. Puede añadir el max_age parámetro opcional (MAX_AGEen la API) para exigir que el usuario se autentique dentro de un período de tiempo reciente. En respuesta a estas entradas, Amazon Cognito añade dos reclamos a los tokens que emite:
-
La
acrafirmación es una cadena que indica el nivel de autenticación que satisfizo el usuario, por ejemplourn:cognito:loa:3. -
La
amrafirmación es un conjunto de cadenas que indica los métodos de autenticación que ha completado el usuario, por ejemplo["pwd", "otp", "mfa"].
Las amr afirmaciones acr y siguen las definiciones de la especificación OpenID Connect Core. Amazon Cognito utiliza sus propios URI de nivel ACR. Puede traducir los niveles de Amazon Cognito a cualquier estándar que requiera su aplicación.
Step-up la autenticación es un caso de uso común para estas afirmaciones. En la autenticación progresiva, la aplicación requiere que el usuario se autentique con un método más seguro antes de realizar una operación confidencial. Para decidir si se debe realizar una solicitud, la aplicación compara el acr nivel y la auth_time afirmación del token de identificación del usuario con el nivel y la actualidad que requiere la operación, y solicita el aumento solo cuando aún no se haya cumplido. Cuando sea necesario dar un paso adelante, redirige al usuario al punto de inicio de sesión, autorización o inicio de sesión gestionadoacr_values, o llama al flujo de USER_AUTH API con. TARGET_ACR_VALUES Para ver un ejemplo, consulta el escenario de Step-up autenticación.
Puede solicitar ACR y AMR desde cualquier punto de entrada de inicio de sesión de Amazon Cognito. La mecánica de cada punto de entrada se documenta con ese punto de entrada.
-
Inicio de sesión en el SDK y la API: solicite un nivel objetivo en el
USER_AUTHflujo con losMAX_AGEparámetrosTARGET_ACR_VALUESy. Para ver los parámetros y el comportamiento de aceleración, consulte. Step-up autenticación con el flujo USER_AUTH -
Inicio de sesión gestionado e interfaz de usuario alojada: transfiera los
max_ageparámetrosacr_valuesy a los puntos finales de autorización e inicio de sesión. Para obtener más información, consulte el punto final de autorización y el punto final de inicio de sesión. -
Inicio de sesión federado: Amazon Cognito obtiene los valores de ACR y AMR de un usuario federado a partir de la respuesta del proveedor de identidad (IdP) y los asigna al campo.
AcrMappingPara obtener información sobre Step-up autenticación para usuarios federados los proveedores de identidad del OIDC, consulte.
Para solicitar una autenticación intensificada se requiere el plan de funciones Essentials o Plus. Para obtener más información, consulte Requisitos del plan de funciones.
Temas
Niveles y métodos de autenticación
Amazon Cognito evalúa los factores de autenticación que completa un usuario y expresa el resultado como un nivel de autenticación en la acr declaración y una lista de métodos de autenticación en la notificación. amr
Niveles de autenticación ACR
Amazon Cognito define cuatro niveles de autenticación fijos. Las combinaciones de factores de autenticación que satisfacen cada nivel son fijas y no se pueden cambiar. Solo puede personalizar el nombre URI de cada nivel para su grupo de usuarios. Para obtener más información, consulte Configuración de los nombres de los niveles de ACR.
Amazon Cognito asigna el nivel de autenticación más alto que satisfagan plenamente los factores completados por el usuario.
| Nivel ACR | Valor ACR predeterminado | Combinaciones de factores satisfactorias |
|---|---|---|
| 1 | urn:cognito:loa:1 |
Solo contraseña |
| 2 | urn:cognito:loa:2 |
Una única contraseña de un solo uso entregada por SMS o correo electrónico. El nivel 2 no incluye las claves de acceso |
| 3 | urn:cognito:loa:3 |
Una clave de paso (de plataforma o de itinerancia) propia; o una contraseña con un código de un solo uso por SMS; o una contraseña con un código de un solo uso por correo electrónico |
| 4 | urn:cognito:loa:4 |
Una contraseña con una contraseña de un solo uso (TOTP) basada en el tiempo de una aplicación de autenticación |
El nivel 1 representa la autenticación solo con contraseña. La federación no satisface ninguno de los niveles de esta tabla. En cambio, Amazon Cognito deriva el nivel de autenticación de un usuario federado a partir de la respuesta del proveedor de identidad (IdP). Para obtener más información, consulte Step-up autenticación para usuarios federados.
Valores de AMR
La amr afirmación es una lista de cadenas. Cada factor de autenticación que completa el usuario añade su valor a la lista. Amazon Cognito puede añadir los siguientes valores.
| Método de autenticación | Valor AMR | Notas |
|---|---|---|
| Contraseña | pwd |
Password-family inicio de sesión, incluida la contraseña remota segura (SRP) |
| TOTP desde una aplicación de autenticación | otp |
Una contraseña de un solo uso basada en el tiempo de una aplicación, como una aplicación de autenticación |
| Código de un solo uso por SMS | sms |
Un código de un solo uso enviado por SMS |
| Código de un solo uso por correo | email_otp |
Un código de un solo uso enviado por correo electrónico |
| Clave de paso con un autenticador de plataforma | swk |
Una clave vinculada a un software, por ejemplo, una clave de paso asegurada por un dispositivo biométrico |
| Clave de paso con un autenticador móvil | hwk |
Una clave vinculada al hardware, por ejemplo, una clave de seguridad |
| Multi-factor combinación | mfa |
Se agrega cuando el usuario completa dos o más factores distintos |
| Inicio de sesión federado | fed |
Un marcador de posición predeterminado que Amazon Cognito añade cuando un usuario se federa a través de un IdP que no admite ACR ni AMR, o no devuelve valores que Amazon Cognito reconozca |
Declaraciones sobre los tokens ACR y AMR
Amazon Cognito añade los tokens acr y los identificadores de identificación y amr afirma tener acceso a ellos. Su aplicación inspecciona el token de acceso o el token de identificación acr y las amr reclamaciones que contienen para evaluar el nivel de autenticación. Cuando un usuario actualiza sus tokens, Amazon Cognito conserva los acr mismos amr y los valores de los nuevos tokens de acceso e ID, por lo que no se le pide al usuario que vuelva a dar un paso adelante después de cada actualización. Para obtener más información sobre el contenido de los tokens, consulte Uso del token de ID y Uso del token de acceso.
El siguiente ejemplo muestra un token de ID después de que un usuario se autentique con una contraseña y un TOTP.
{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "abc123def456", "exp": 1759348800, "iat": 1759345200, "auth_time": 1759345200, "token_use": "id", "acr": "urn:cognito:loa:4", "amr": ["pwd", "otp", "mfa"], "email": "user@example.com", "cognito:username": "a1b2c3d4-5678-90ab-cdef-1234567890ab" }
Cuando un usuario actualiza sus tokens, Amazon Cognito establece los acr mismos amr valores en los nuevos tokens de acceso e ID. Los valores se transfieren sin modificaciones. Este comportamiento proporciona una experiencia más fluida, ya que no se pide a los usuarios que vuelvan a dar un paso adelante después de cada actualización.
Actualizar un token no restablece la auth_time reclamación. Si quieres obligar a un usuario a volver a autenticarse después de un período de tiempo, usa el max_age parámetro, que compara la hora actual con auth_time independencia del número de veces que el usuario haya actualizado sus tokens.
Cuando un usuario completa la autenticación escalonada, Amazon Cognito emite nuevos tokens de acceso, ID y actualización con los registros acr actualizados amr y un nuevo período de validez.
Configuración de los nombres de los niveles de ACR
Puede personalizar el nombre URI de cada nivel de autenticación para su grupo de usuarios con el AcrConfiguration campo. Configure este campo al crear o actualizar un grupo de usuarios con la UpdateUserPooloperación CreateUserPoolo. Las combinaciones de factores que satisfacen cada nivel permanecen fijas. Solo personalizas los nombres.
La configuración de los nombres de los niveles de ACR personalizados con el AcrConfiguration campo requiere el plan de funciones Essentials o Plus. Para obtener más información, consulte Requisitos del plan de funciones.
El AcrConfiguration campo es un mapa con las teclas pulsadasLevel1. Level4 Cada valor es un objeto con una sola AcrValue cadena. Solo puede anular los niveles que desee personalizar. El siguiente ejemplo de solicitud personaliza los nombres de los niveles 2 y 3.
{ "AcrConfiguration": { "Level2": { "AcrValue": "urn:my-standard:loa:2" }, "Level3": { "AcrValue": "urn:my-standard:loa:3" } } }
La respuesta siempre devuelve la configuración efectiva, con los nombres predeterminados combinados para los niveles que no haya personalizado.
{ "AcrConfiguration": { "Level1": { "AcrValue": "urn:cognito:loa:1" }, "Level2": { "AcrValue": "urn:my-standard:loa:2" }, "Level3": { "AcrValue": "urn:my-standard:loa:3" }, "Level4": { "AcrValue": "urn:cognito:loa:4" } } }
Las siguientes reglas de validación se aplican a cada uno de ellosAcrValue.
-
Cada uno
AcrValuedebe ser único en los cuatro niveles. Esto incluye los nombres predeterminados que se utilizan para rellenar los niveles que no se personalizan. Se rechaza un valor que choca con el valor predeterminado de un nivel no personalizado. -
Cada uno
AcrValuees una cadena de 1 a 64 caracteres. -
Cada una no
AcrValuepuede contener espacios, comillas dobles ni barras invertidas.
Si cambias los nombres de los niveles de ACR, es posible que un usuario presente más adelante un token de acceso cuyo acr valor ya no coincide con ningún nivel configurado. Amazon Cognito no respeta el valor obsoleto y lo trata como un nivel no reconocido, pero no se trata de un error. Amazon Cognito sigue respetando los amr valores del token y solo solicita factores que aún no figuran en la amr reclamación, sin acreditar ningún nivel en particular.
Requisitos del plan de funciones
Las siguientes funciones requieren el plan de funciones Essentials o Plus.
-
Solicitar una autenticación escalonada. Esto se aplica al
TARGET_ACR_VALUESparámetro activadoInitiateAuthy alacr_valuesparámetro del inicio de sesión gestionado. -
Configurar nombres de niveles de ACR personalizados con el
AcrConfigurationcampo activadoCreateUserPooloUpdateUserPool.
El comportamiento al solicitar una autenticación intensificada con un plan de funciones insuficiente depende del punto de entrada.
-
La
InitiateAuthAPI devuelve unFeatureUnavailableInTierException. -
El punto final de autorización de inicio de sesión gestionado ignora silenciosamente
acr_valuesy continúa con la autenticación normal, sin ningún error.
Para obtener más información sobre los planes de funciones, consulte. Planes de características de grupo de usuarios
Sus responsabilidades a la hora de aumentar la autenticación
Amazon Cognito emite tokens con el nivel de autenticación alcanzado por el usuario. Su aplicación es responsable de lo siguiente.
-
Comprueba el identificador actual del usuario antes de redirigirlo.
auth_timeEvalúe sumax_agenivel y elacrnivel del token de identificación con el nivel que requiere la operación, con los tokens que ya posee su aplicación. Redirija al usuario a Amazon Cognito para ampliarlo solo si aún no se ha alcanzado el nivel o la frescura requeridos. -
Establezca el
TARGET_ACR_VALUESo correctoacr_valuesy el o correctoMAX_AGE.max_ageAmazon Cognito actúa únicamente en función de lo que usted proporciona. No deduce el nivel o la frescura que pretende. Si solicita un nivel incorrecto u omite los parámetros, Amazon Cognito no mejora el nivel de usuario como pretendía. -
Valide la
acrreclamación en su solicitud. Una vez que Amazon Cognito devuelva los tokens, la aplicación debe comprobar que laacrreclamación coincide con el nivel que requiere la operación antes de conceder el acceso. Amazon Cognito emite el token con el nivel alcanzado. La aplicación es responsable de hacer cumplir que una operación requiera un nivel determinado. -
Traduzca los niveles de Amazon Cognito a otros estándares ajenos al token. Amazon Cognito calcula el flujo de autenticación
acry lasamrreclamaciones a partir del mismo. No puede personalizar, anular, añadir o suprimir estas notificaciones con un activador Lambda previo a la generación del token ni con ningún otro activador de Lambda. Si necesita traducir los niveles de Amazon Cognito a otro estándar, como NIST o eIDAS, hágalo en su capa de aplicación.