Zum Hauptinhalt springen

Erste Bildschirmparameter

Ein Satz benutzerdefinierter Authentifizierungsparameter, der es dir ermöglicht, die gewünschte erste Bildschirmerfahrung für die Endbenutzer anzupassen.

  • first_screen: Gibt den ersten Bildschirm an, den der Benutzer sehen wird.
  • identifier: Gibt die Identifikatortypen an, die das Anmelde- oder Registrierungsformular akzeptieren wird.
  • 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 first_screen-Parameter ist der Schlüsselparameter, der bestimmt, welchen ersten Bildschirm die Benutzer sehen, wenn sie zur Anmeldeseite von Logto 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. (Eine E-Mail-Adresse wird abgefragt, um die aktivierten SSO-Anbieter zu bestimmen)
  • identifier:sign-in: Zeigt ein identifikatorspezifisches Anmeldeformular an. Der Identifikatortyp kann mit dem identifier-Parameter 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 identifier-Parameter angegeben werden. Dies ist nützlich, wenn du mehrere Identifikator-Registrierungsmethoden aktiviert hast.

Erste Bildschirmparameter

Zum Beispiel, um Benutzer direkt zum Enterprise SSO-Anmeldeformular zu senden:

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

identifier​

Der identifier-Parameter wird verwendet, um die Identifikatortypen anzugeben, die das Anmelde- oder Registrierungsformular akzeptieren wird. Dieser Parameter ist nur anwendbar, wenn der first_screen-Parameter 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.

Zum Beispiel, um Benutzer direkt zur E-Mail- oder Telefonnummer-Registrierungsseite zu senden:

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.

Alle nicht unterstützten oder deaktivierten Identifikatortypen werden ignoriert. Wenn alle angegebenen Identifikatoren nicht unterstützt werden, wird die Standardkonfiguration der Anmeldeerfahrung verwendet.

login_hint​

Der login_hint-Parameter, definiert in der Standard-OpenID Connect-Spezifikation, wird verwendet, um das Anmeldeformular mit dem Identifikator des Benutzers (wie einer E-Mail, einer Telefonnummer oder einem Benutzernamen) vorab auszufüllen. Mit Logto kann er mit anderen Anmeldebildschirmparametern kombiniert werden, um die Benutzererfahrung zu verbessern. Dieser Parameter ist besonders nützlich, wenn du ein benutzerdefiniertes Vor-Authentifizierungsformular hast, das den Identifikator des Benutzers im Voraus sammelt, sodass er ihn bei der Anmeldung nicht erneut eingeben muss.

Zum Beispiel, um die gesammelte E-Mail-Adresse im Anmeldeformular vorab auszufü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 festlegen:

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

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

hinweis

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