IdentityCredential: configURL property
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The configURL read-only property of the IdentityCredential interface returns a string specifying the config file URL of the identity provider (IdP) used for sign-in.
See Provide a config file for more information.
Value
A string.
Examples
Basic federated sign-in and configURL access
Relying parties (RPs) can call navigator.credentials.get() with the identity option to make a request for users to sign in to the RP via an identity provider (IdP), using identity federation. A request indicating a single provider would look like this:
async function signIn() {
const identityCredential = await navigator.credentials.get({
identity: {
providers: [
{
configURL: "https://accounts.idp.example/config.json",
clientId: "********",
params: {
/* IdP-specific parameters */
},
},
],
},
});
console.log(identityCredential.configURL);
}
A successful navigator.credentials.get() call that includes an identity option fulfills with an IdentityCredential instance, which can be used to access the configURL of the IdP used for sign-in.
Check out Federated Credential Management API (FedCM) for more details on how this works. This call will start off the sign-in flow described in FedCM sign-in flow.
Specifications
| Specification |
|---|
| Federated Credential Management API # dom-identitycredential-configurl |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
configURL
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.