Guides & Tools
How to work with the OIDC or WS-Federation metadata endpoints
For each domain you have in Criipto Verify, you can fetch token-issuer related metadata. These are used to configure your client to trust only tokens issued by your tenant, and they also contain information that many client-side libraries can use to run most of the login process automatically.
The remainder of this article uses yourdomain.criipto.id
as a placeholder for your actual domain. Replace as needed before setting up your client(s) with metadata endpoints.
(shorthand) https://yourdomain.criipto.id/metadata/wsfed
(ADFS-style) https://yourdomain.criipto.id/FederationMetadata/2007-06/FederationMetadata.xml
- note that both of the above return exactly the same data.
https://yourdomain.criipto.id/.well-known/openid-configuration
In some scenarios, you may have to use login-method specific metadata endpoints. This can be needed if the client does not allow you to specify acr_values
(OIDC) or wauth
(WS-Federation) dynamically.
For those cases, you can leverage our login-method specific metadata endpoints. Each of these contain an embedded and base64-encoded variant of the 'raw' value normally supplied in the acr_values
/ wauth
query parameter.
Syntax options:
https://yourdomain.criipto.id/metadata/wsfed/BASE64(wauth)
https://yourdomain.criipto.id/BASE64(wauth)/FederationMetadata/2007-06/FederationMetadata.xml
BASE64(wauth)
path segment in the 2 cases.Here, the wauth
value is urn:grn:authn:se:bankid:another-device
. This translates to dXJuOmdybjphdXRobjpzZTpiYW5raWQ6YW5vdGhlci1kZXZpY2U=
in base64 (UTF-8 charset), and the metadata endpoints are
https://yourdomain.criipto.id/metadata/wsfed/dXJuOmdybjphdXRobjpzZTpiYW5raWQ6YW5vdGhlci1kZXZpY2U=
https://yourdomain.criipto.id/dXJuOmdybjphdXRobjpzZTpiYW5raWQ6YW5vdGhlci1kZXZpY2U=/FederationMetadata/2007-06/FederationMetadata.xml
Syntax:
https://yourdomain.criipto.id/BASE64(acr_values)/.well-known/openid-configuration
Here, the acr_values
is urn:grn:authn:no:bankid
. This translates to dXJuOmdybjphdXRobjpubzpiYW5raWQ=
in base64 (UTF-8 charset), and the metadata endpoint is
https://yourdomain.criipto.id/dXJuOmdybjphdXRobjpubzpiYW5raWQ=/.well-known/openid-configuration