Paramètres de l'écran de démarrage
Un ensemble de paramètres d'authentification personnalisés qui vous permettent d'adapter l'expérience de l'écran de démarrage souhaitée pour les utilisateurs finaux.
first_screen
: Spécifie le premier écran que l'utilisateur verra.identifier
: Spécifie les types d'identifiants que le formulaire de connexion ou d'inscription acceptera.login_hint
: Remplit le champ identifiant avec l'adresse e-mail ou le nom d'utilisateur de l'utilisateur. (C'est un paramètre standard OIDC)
first_screen
Le paramètre first_screen
est le paramètre clé qui détermine le premier écran que les utilisateurs verront lorsqu'ils seront redirigés vers la page de connexion de Logto. Par défaut, le formulaire de connexion universel sera affiché. Utilisez ce paramètre pour personnaliser le premier écran en fonction des besoins de votre application. Les valeurs prises en charge sont :
sign_in
: Affiche le formulaire de connexion. (Par défaut)register
: Affiche le formulaire d'inscription.reset_password
: Affiche le formulaire de réinitialisation du mot de passe.single_sign_on
: Affiche le formulaire de connexion SSO d’entreprise. (Une adresse e-mail sera demandée pour déterminer les fournisseurs SSO activés)identifier:sign-in
: Affiche un formulaire de connexion spécifique à un identifiant. Le type d'identifiant peut être spécifié à l'aide du paramètreidentifier
. Ceci est utile lorsque vous avez plusieurs méthodes de connexion par identifiant activées.identifier:register
: Affiche un formulaire d'inscription spécifique à un identifiant. Le type d'identifiant peut être spécifié à l'aide du paramètreidentifier
. Ceci est utile lorsque vous avez plusieurs méthodes d'inscription par identifiant activées.
Par exemple, envoyer les utilisateurs directement au formulaire de connexion SSO d’entreprise :
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=single_sign_on'
identifier
Le paramètre identifier
est utilisé pour spécifier les types d'identifiants que le formulaire de connexion ou d'inscription acceptera. Ce paramètre n'est applicable que lorsque le paramètre first_screen
est défini sur identifier:sign-in
, identifier:register
, ou reset_password
. Les valeurs prises en charge sont : username
, email
, et phone
. Séparez plusieurs valeurs par un espace vide pour autoriser plusieurs types d'identifiants.
Par exemple, envoyer les utilisateurs directement à la page d'inscription par e-mail ou numéro de téléphone :
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:register&identifier=email phone'
Tous les types d'identifiants spécifiés dans ce paramètre doivent être activés dans vos paramètres de connexion ou d'inscription dans la Logto Console.
Tout type d'identifiant non pris en charge ou désactivé sera ignoré. Si tous les identifiants spécifiés ne sont pas pris en charge, la configuration par défaut de l'expérience de connexion sera utilisée.
login_hint
Le paramètre login_hint
, défini dans la spécification standard OpenID Connect, est utilisé pour pré-remplir le formulaire de connexion avec l'identifiant de l'utilisateur (tel qu'un e-mail, un numéro de téléphone ou un nom d'utilisateur). Avec Logto, il peut être combiné avec d'autres paramètres d'écran de connexion pour améliorer l'expérience utilisateur. Ce paramètre est particulièrement utile si vous avez un formulaire de pré-authentification personnalisé qui collecte l'identifiant de l'utilisateur à l'avance, lui permettant de ne pas avoir à le ressaisir lors de la connexion.
Par exemple, pré-remplir l'adresse e-mail collectée dans le formulaire de connexion :
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]
Support SDK
Dans les SDK Logto pris en charge, vous pouvez définir les paramètres lors de l'appel de la méthode signIn
:
logtoClient.signIn({
redirectUri: 'https://your-app.com/callback',
firstScreen: 'identifier:register',
identifier: ['email', 'phone'],
loginHint: '[email protected]',
});
Nous ajoutons progressivement la prise en charge des paramètres first_screen
, identifier
, et login_hint
à tous les SDK Logto. Si vous ne les voyez pas dans votre SDK, veuillez ouvrir un problème ou nous contacter.
Pour les utilisateurs de Logto OSS, ces paramètres sont pris en charge depuis la version 1.15.0. Si vous utilisez une version antérieure, veuillez mettre à niveau vers la dernière version.