Zum Hauptinhalt springen

First-Screen-Parameter

Eine Reihe von benutzerdefinierten Authentifizierungsparametern, mit denen du das gewünschte First-Screen-Erlebnis für die Endbenutzer anpassen kannst.

  • first_screen: Gibt den ersten Bildschirm an, den der Benutzer sehen wird.
  • identifier: Gibt die Identifikatortypen an, die das Anmelde- oder Registrierungsformular akzeptiert.
  • login_hint: Füllt das Identifikatorfeld mit der E-Mail-Adresse oder dem Benutzernamen des Benutzers aus. (Dies ist ein OIDC-Standardparameter)

first_screen​

Der Parameter first_screen ist der Schlüsselparameter, der bestimmt, welchen ersten Bildschirm die Benutzer sehen, wenn sie zur Logto-Anmeldeseite weitergeleitet werden. Standardmäßig wird das universelle Anmeldeformular angezeigt. Verwende diesen Parameter, um den ersten Bildschirm basierend auf den Anforderungen deiner Anwendung anzupassen. Unterstützte Werte sind:

  • sign_in: Zeigt das Anmeldeformular an. (Standard)
  • register: Zeigt das Registrierungsformular an.
  • reset_password: Zeigt das Formular zum Zurücksetzen des Passworts an.
  • single_sign_on: Zeigt das Enterprise SSO-Anmeldeformular an. (Es wird eine E-Mail-Adresse abgefragt, um die aktivierten SSO-Anbieter zu bestimmen)
  • identifier:sign-in: Zeigt ein identifikatorspezifisches Anmeldeformular an. Der Identifikatortyp kann mit dem Parameter identifier angegeben werden. Dies ist nützlich, wenn du mehrere Identifikator-Anmeldemethoden aktiviert hast.
  • identifier:register: Zeigt ein identifikatorspezifisches Registrierungsformular an. Der Identifikatortyp kann mit dem Parameter identifier angegeben werden. Dies ist nützlich, wenn du mehrere Identifikator-Registrierungsmethoden aktiviert hast.
First screen parameter

Beispiel: Benutzer direkt zum Enterprise SSO-Anmeldeformular weiterleiten:

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

identifier​

Der Parameter identifier wird verwendet, um die Identifikatortypen anzugeben, die das Anmelde- oder Registrierungsformular akzeptiert. Dieser Parameter ist nur anwendbar, wenn der Parameter first_screen auf identifier:sign-in, identifier:register oder reset_password gesetzt ist. Unterstützte Werte sind: username, email und phone. Trenne mehrere Werte mit einem Leerzeichen, um mehrere Identifikatortypen zuzulassen.

Beispiel: Benutzer direkt zur Registrierungsseite für E-Mail oder Telefonnummer weiterleiten:

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

Alle in diesem Parameter angegebenen Identifikatortypen müssen in deinen Anmelde- oder Registrierungseinstellungen in der Logto-Konsole aktiviert sein.

Nicht unterstützte oder deaktivierte Identifikatortypen werden ignoriert. Wenn alle angegebenen Identifikatoren nicht unterstützt werden, wird die Standardkonfiguration für das Anmeldeerlebnis verwendet.

login_hint​

Der Parameter login_hint, definiert in der Standard-OpenID Connect-Spezifikation, wird verwendet, um das Anmeldeformular mit dem Identifikator des Benutzers (wie eine E-Mail, Telefonnummer oder Benutzername) vorab auszufüllen. Mit Logto kann er mit anderen Anmeldebildschirm-Parametern kombiniert werden, um das Benutzererlebnis zu verbessern. Dieser Parameter ist besonders nützlich, wenn du ein benutzerdefiniertes Pre-Authentifizierungsformular hast, das den Identifikator des Benutzers im Voraus abfragt, sodass dieser ihn beim Anmelden nicht erneut eingeben muss.

Beispiel: Die gesammelte E-Mail-Adresse im Anmeldeformular vorab ausfüllen:

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]

SDK-Unterstützung​

In unterstützten Logto SDKs kannst du die Parameter beim Aufruf der signIn-Methode setzen:

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

Wir fügen nach und nach Unterstützung für die Parameter first_screen, identifier und login_hint zu allen Logto SDKs hinzu. Wenn du sie in deinem SDK nicht findest, öffne bitte ein Issue oder kontaktiere uns.

Für Logto OSS-Nutzer sind diese Parameter seit Version 1.15.0 unterstützt. Wenn du eine ältere Version verwendest, aktualisiere bitte auf die neueste Version.