IdentityCredentialRequestOptions
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das IdentityCredentialRequestOptions
Dictionary stellt das Objekt dar, das an CredentialsContainer.get()
als Wert der identity
Option übergeben wird.
Es wird verwendet, um ein IdentityCredential
anzufordern, das von einem föderierten Identitätsanbieter bereitgestellt wird, der die Federated Credential Management (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-Oberflä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 zum nächsten Schritt im Ablauf zu gelangen, der eine Anmeldung erfordert. Browser bieten eine Textzeichenfolge ä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 Ursprungsserver verwendet hat. Browser bieten eine Textzeichenfolge ähnlich:
Anmelden bei <page-origin> mit <IdP>
"signup"
-
Eine Option für Situationen, in denen der Benutzer sich mit einem neuen IdP-Konto anmeldet, das er hier zuvor nicht verwendet hat. Browser bieten eine Textzeichenfolge ä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 bieten eine Textzeichenfolge ähnlich:
Verwenden Sie <page-origin> mit <IdP>
Der Standardwert ist
"signin"
. providers
-
Ein Array, das ein einzelnes Objekt enthält, das Details eines IdP spezifiziert, der zur Anmeldung 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 Konfigurationsdatei bereitstellen.
clientId
-
Ein String, der die Client-ID des RP angibt. Diese Information wird vom IdP in einem separaten, idp-spezifischen Prozess an das RP ausgegeben.
loginHint
Optional-
Ein String, der einen Hinweis auf die Kontooption(en) gibt, die der Browser dem Benutzer zur Anmeldung bieten 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 erneute Authentifizierungsprozess verwirrend sein, wenn ein Benutzer mehrere Konten hat und sich nicht daran erinnern kann, welches er bei der vorherigen Anmeldung verwendet hat. Der Wert für die
loginHint
-Eigenschaft kann von der vorherigen Anmeldung des Benutzers übernommen werden und wird mit denlogin_hints
-Werten abgeglichen, die vom IdP im Array der vom IdP zurückgegebenen Benutzerinformationswerte bereitgestellt werden, das vom Accounts-Listen-Endpunkt bereitgestellt wird. nonce
Optional-
Eine zufällige Zeichenfolge, die eingefügt werden kann, um sicherzustellen, dass die Antwort speziell für diese Anfrage ausgestellt wird und um Replay-Angriffe zu verhindern.
Hinweis: Derzeit erlaubt FedCM nur, dass die API mit einem einzigen IdP aufgerufen wird, d.h. das
providers
-Array muss die Länge 1 haben. Mehrere IdPs müssen über verschiedeneget()
-Aufrufe unterstützt werden.
Spezifikationen
Specification |
---|
Federated Credential Management API # dictdef-identitycredentialrequestoptions |