Aller au contenu principal

Paramètres de l'écran d'accueil

Un ensemble de paramètres d'authentification personnalisés qui vous permettent d'adapter l'Expérience de l'écran d'accueil 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. (Ceci 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ètre identifier. 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ètre identifier. Ceci est utile lorsque vous avez plusieurs méthodes d'inscription par identifiant activées.

Paramètre de l'écran d'accueil

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]',
});
remarque

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.

remarque

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 à jour vers la dernière version.