IdentityCredentialRequestOptions
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das IdentityCredentialRequestOptions
Wörterbuch stellt das Objekt dar, das an CredentialsContainer.get()
als Wert der identity
-Option übergeben wird.
Es wird verwendet, um ein IdentityCredential
von einem föderierten Identitätsanbieter anzufordern, der die Föderierte Anmeldeverwaltung (FedCM) API unterstützt.
Instanz-Eigenschaften
context
Optional-
Ein String, der den Kontext angibt, in dem sich der Benutzer mit FedCM authentifiziert. Der Browser verwendet diesen Wert, um den Text in seiner FedCM-Benutzeroberfläche besser an den Kontext anzupassen. Mögliche Werte sind:
"continue"
-
Geeignet für Situationen, in denen der Benutzer eine Identität auswählt, um zur nächsten Seite im Ablauf zu gelangen, die eine Anmeldung erfordert. Browser liefern einen Textstring ähnlich:
Weiter zu <page-origin> mit <IdP>
"signin"
-
Geeignet für allgemeine Situationen, in denen der Benutzer sich mit einem IdP-Konto anmeldet, das er bereits auf diesem Ursprung verwendet hat. Browser liefern einen Textstring ähnlich:
Anmelden bei <page-origin> mit <IdP>
"signup"
-
Eine Option für Situationen, in denen der Benutzer sich mit einem neuen IdP-Konto bei dem Ursprung anmeldet, das er hier zuvor nicht verwendet hat. Browser liefern einen Textstring ähnlich:
Registrieren bei <page-origin> mit <IdP>
"use"
-
Geeignet für Situationen, in denen eine andere Aktion, wie z.B. die Validierung einer Zahlung, durchgeführt wird. Browser liefern einen Textstring ähnlich:
Verwenden von <page-origin> mit <IdP>
Der Standardwert ist
"signin"
. providers
-
Ein Array, das ein einzelnes Objekt enthält, das Details eines IdP spezifiziert, der zum Anmelden verwendet werden soll. Dieses Objekt kann die folgenden Eigenschaften enthalten:
configURL
-
Ein String, der die URL der Konfigurationsdatei des IdP angibt. Weitere Informationen finden Sie unter Bereitstellen einer Konfigurationsdatei.
clientId
-
Ein String, der die Clientkennung des RP angibt. Diese Information wird vom IdP an das RP in einem separaten, idp-spezifischen Prozess ausgegeben.
loginHint
Optional-
Ein String, der einen Hinweis auf die Kontooption(en) gibt, die der Browser für die Anmeldung des Benutzers bereitstellen soll. Dies ist nützlich in Fällen, in denen der Benutzer bereits angemeldet ist und die Seite ihn auffordert, sich erneut zu authentifizieren. Andernfalls kann der Reauthentifizierungsprozess verwirrend sein, wenn ein Benutzer mehrere Konten hat und sich nicht erinnern kann, welches er zuvor zur Anmeldung verwendet hat. Der Wert für die
loginHint
-Eigenschaft kann aus der vorherigen Anmeldung des Benutzers übernommen werden und wird mit denlogin_hints
-Werten abgeglichen, die vom IdP im Array der Benutzerinformation zurückgegeben werden, das vom Kontenlisten-Endpunkt des IdP zurückgegeben wird. nonce
Optional-
Ein zufälliger String, der enthalten sein kann, um sicherzustellen, dass die Antwort speziell für diese Anfrage ausgestellt wird und Replay-Angriffe verhindert.
Hinweis: Derzeit erlaubt FedCM nur die API mit einem einzelnen IdP aufzurufen, d.h. das
providers
-Array muss eine Länge von 1 haben. Mehrere IdPs müssen über verschiedeneget()
-Aufrufe unterstützt werden.
Spezifikationen
Specification |
---|
Federated Credential Management API # dictdef-identitycredentialrequestoptions |