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 Parameter first_screen 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 Passwort-Zurücksetzungsformular 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 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.

Erster 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 Parameter identifier wird verwendet, um die Identifikatortypen anzugeben, die das Anmelde- oder Registrierungsformular akzeptieren wird. 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.

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 Standard-Anmeldeerfahrungskonfiguration 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, eine Telefonnummer oder einen 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.

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