Saltar al contenido principal

Parámetros de la primera pantalla

Un conjunto de parámetros de autenticación personalizados que te permiten adaptar la experiencia de la primera pantalla deseada para los usuarios finales.

  • first_screen: Especifica la primera pantalla que verá el usuario.
  • identifier: Especifica los tipos de identificador que aceptará el formulario de inicio de sesión o registro.
  • login_hint: Rellena el campo de identificador con la dirección de correo electrónico o el nombre de usuario del usuario. (Este es un parámetro estándar de OIDC)

first_screen

El parámetro first_screen es el parámetro clave que determina la primera pantalla que los usuarios verán cuando sean redirigidos a la página de inicio de sesión de Logto. Por defecto, se mostrará el formulario universal de inicio de sesión. Utiliza este parámetro para personalizar la primera pantalla según los requisitos de tu aplicación. Los valores admitidos son:

  • sign_in: Muestra el formulario de inicio de sesión. (Por defecto)
  • register: Muestra el formulario de registro.
  • reset_password: Muestra el formulario de restablecimiento de contraseña.
  • single_sign_on: Muestra el formulario de inicio de sesión de SSO empresarial. (Se solicitará una dirección de correo electrónico para determinar los proveedores de SSO habilitados)
  • identifier:sign-in: Muestra un formulario de inicio de sesión específico por identificador. El tipo de identificador se puede especificar usando el parámetro identifier. Esto es útil cuando tienes habilitados varios métodos de inicio de sesión por identificador.
  • identifier:register: Muestra un formulario de registro específico por identificador. El tipo de identificador se puede especificar usando el parámetro identifier. Esto es útil cuando tienes habilitados varios métodos de registro por identificador.
Parámetro de la primera pantalla

Por ejemplo, enviar a los usuarios directamente al formulario de inicio de sesión de SSO empresarial:

curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=single_sign_on'

identifier

El parámetro identifier se utiliza para especificar los tipos de identificador que aceptará el formulario de inicio de sesión o registro. Este parámetro solo es aplicable cuando el parámetro first_screen está configurado como identifier:sign-in, identifier:register o reset_password. Los valores admitidos son: username, email y phone. Separa varios valores con un espacio vacío para permitir múltiples tipos de identificador.

Por ejemplo, enviar a los usuarios directamente a la página de registro por correo electrónico o número de teléfono:

curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:register&identifier=email phone'

Todos los tipos de identificador especificados en este parámetro deben estar habilitados en tu configuración de inicio de sesión o registro en la Consola de Logto.

Cualquier tipo de identificador no admitido o deshabilitado será ignorado. Si todos los identificadores especificados no son compatibles, se utilizará la configuración predeterminada de la experiencia de inicio de sesión.

login_hint

El parámetro login_hint, definido en la especificación estándar de OpenID Connect, se utiliza para pre-rellenar el formulario de inicio de sesión con el identificador del usuario (como un correo electrónico, un número de teléfono o nombre de usuario). Con Logto, puede combinarse con otros parámetros de pantalla de inicio de sesión para mejorar la experiencia del usuario. Este parámetro es especialmente útil si tienes un formulario de pre-autenticación personalizado que recopila el identificador del usuario de antemano, permitiéndole omitir volver a ingresarlo durante el inicio de sesión.

Por ejemplo, pre-rellenar la dirección de correo electrónico recopilada en el formulario de inicio de sesión:

curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:sign_in&identifier=email&login_hint=[email protected]

Soporte en SDK

En los SDK de Logto compatibles, puedes establecer los parámetros al llamar al método signIn:

logtoClient.signIn({
redirectUri: 'https://your-app.com/callback',
firstScreen: 'identifier:register',
identifier: ['email', 'phone'],
loginHint: '[email protected]',
});
nota:

Estamos agregando gradualmente soporte para los parámetros first_screen, identifier y login_hint en todos los SDK de Logto. Si no los ves en tu SDK, por favor abre un issue o contáctanos.

Para los usuarios de Logto OSS, estos parámetros son compatibles desde la versión 1.15.0. Si estás usando una versión anterior, por favor actualiza a la última versión.