IdentityCredentialRequestOptions
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The IdentityCredentialRequestOptions
dictionary represents the object passed to CredentialsContainer.get()
as the value of the identity
option.
It is used to request an IdentityCredential
provided by a federated identity provider that supports the Federated Credential Management (FedCM) API.
Instance properties
context
Optional-
A string specifying the context in which the user is authenticating with FedCM. The browser uses this value to vary the text in its FedCM UI to better suit the context. Possible values are:
"continue"
-
Suitable for situations where the user is choosing an identity to continue to the next page in the flow, which requires a sign-in. Browsers will provide a text string similar to:
Continue to <page-origin> with <IdP>
"signin"
-
Suitable for general situations where the user is signing in with an IdP account they've already used on this origin. Browsers will provide a text string similar to:
Sign in to <page-origin> with <IdP>
"signup"
-
An option for situations where the user is signing in to the origin with a new IdP account they've not used here before. Browsers will provide a text string similar to:
Sign up to <page-origin> with <IdP>
"use"
-
Suitable for situations where a different action, such as validating a payment, is being performed. Browsers will provide a text string similar to:
Use <page-origin> with <IdP>
The default value is
"signin"
. providers
-
An array containing a single object specifying details of an IdP to be used to sign in. This object can contain the following properties:
configURL
-
A string specifying the URL of the IdP's config file. See Provide a config file for more information.
clientId
-
A string specifying the RP's client identifier. This information is issued by the IdP to the RP in a separate process that is specific to the IdP.
loginHint
Optional-
A string providing a hint about the account option(s) the browser should provide for the user to sign in with. This is useful in cases where the user has already signed in and the site asks them to reauthenticate. Otherwise, the reauthentication process can be confusing when a user has multiple accounts and can't remember which one they used to sign in previously. The value for the
loginHint
property can be taken from the user's previous sign-in, and is matched against thelogin_hints
values provided by the IdP in the array of user information returned from the IdP's accounts list endpoint. nonce
Optional-
A random string that can be included to ensure the response is issued specifically for this request and prevent replay attacks.
Note: Currently FedCM only allows the API to be invoked with a single IdP, i.e. the
providers
array has to have a length of 1. Multiple IdPs must be supported via differentget()
calls.
Specifications
Specification |
---|
Unknown specification # dictdef-identitycredentialrequestoptions |