View a markdown version of this page

El punto final de inicio de sesión gestionado: /login - Amazon Cognito

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.

El punto final de inicio de sesión gestionado: /login

El punto de conexión de inicio de sesión es un servidor de autenticación y un destino de redireccionamiento desde Autorizar punto de conexión. Es el punto de entrada al inicio de sesión administrado cuando no especifica un proveedor de identidades. Al generar un redireccionamiento al punto de conexión de inicio de sesión, se carga la página de inicio de sesión, que muestra al usuario las opciones de autenticación configuradas para el cliente.

nota

El punto de conexión de inicio de sesión es un componente del inicio de sesión administrado. En la aplicación, invoque las páginas de inicio de sesión administrado y de federación que redirigen al punto de conexión de inicio de sesión. El acceso directo de los usuarios al punto de conexión de inicio de sesión no es una práctica recomendada.

GET /login

El punto de conexión /login  solo admite HTTPS GET para la solicitud inicial del usuario. La aplicación invoca la página en un navegador como Chrome o Firefox. Cuando la redirecciona a /login desde el Autorizar punto de conexión, transmite todos los parámetros que ha proporcionado en la solicitud inicial. El punto de conexión de inicio de sesión admite todos los parámetros de solicitud del punto de conexión autorizado. También puede acceder directamente al punto de conexión de inicio de sesión. Como práctica recomendada, origine todas las sesiones de los usuarios en /oauth2/authorize.

Ejemplo: Pedir al usuario que inicie sesión

En este ejemplo se muestra la pantalla de inicio de sesión.

GET https://mydomain.auth.us-east-1.amazoncognito.com/login? response_type=code& client_id=1example23456789& redirect_uri=https://YOUR_APP/redirect_uri& state=STATE& scope=openid+profile+aws.cognito.signin.user.admin
Ejemplo: Respuesta

El servidor de autenticación redirige a la aplicación con el código y el estado de autorización. El servidor debe devolver el código y el estado en los parámetros de la cadena de consulta y no en el fragmento.

HTTP/1.1 302 Found Location: https://YOUR_APP/redirect_uri?code=AUTHORIZATION_CODE&state=STATE

User-initiated solicitud de inicio de sesión

Una vez que el usuario cargue el punto de conexión /login, podrá ingresar un nombre de usuario y una contraseña y elegir Iniciar sesión. Cuando lo hace, genera una solicitud HTTPS POST con los mismos parámetros de solicitud de encabezado que la solicitud GET y un cuerpo de solicitud con el nombre de usuario, contraseña y la huella digital del dispositivo.

Step-up solicitud de autenticación

El /login punto final acepta los siguientes parámetros de URL para la autenticación progresiva. Estos parámetros tienen el mismo comportamiento que en el punto final de autorización. Para obtener más información sobre los niveles de ACR y los valores de AMR, consulte. Niveles de autenticación con afirmaciones de ACR y AMR

acr_values

Una URL-encoded lista separada por espacios de los URI del nivel de autenticación ACR objetivo, del más alto al más bajo. Amazon Cognito evalúa la lista de izquierda a derecha, aplica el primer nivel válido que el usuario pueda cumplir e ignora los valores que no reconoce. Este parámetro se comporta igual que el parámetro de la API. TARGET_ACR_VALUES Requiere el plan de funciones Essentials o Plus.

max_age

Un entero no negativo que especifica el número máximo de segundos transcurridos desde la última vez que el usuario se autenticó. Si el tiempo actual negativo auth_time es mayor quemax_age, el usuario debe volver a autenticarse desde cero en lugar de limitarse a acelerar. Este comportamiento es idéntico al parámetro de la MAX_AGE API.

Para ver un ejemplo de solicitud que usa estos parámetros, consulta el punto final de autorización.

max_ageCombínelo acr_values con la exigencia de un nivel de autenticación específico con una autenticación reciente para una operación confidencial.

El comportamiento de un plan de funciones insuficiente difiere del de la API. El /login punto final de inicio de sesión gestionado ignora de forma silenciosa la autenticación normal acr_values y continúa con ella, sin que se produzca ningún error. La API devuelve un. FeatureUnavailableInTierException Para obtener más información, consulte Requisitos del plan de funciones.