Obtain the Carrier OpenID Configuration

📘

The iOS or Android SDK within your application on a primary device handle this section and its subsections.

Perform OIDC Discovery to fetch the OpenID configuration document for the user's carrier. This call provides information about the carrier's OpenID configuration including all necessary endpoints and public key location information. Use https://discoveryissuer.myzenkey.com/.well-known/openid_configuration as the DISCOVERY_URL variable in your implementation.

The Request

https://discoveryissuer.myzenkey.com/.well-known/openid_configuration?
    client_id=CLIENT_ID
    &mccmnc=MCCMNC

Parameter

Description

CLIENT_ID

Obtained in the ZenKey developer portal.

MCCMNC

Six digit code that identifies the user's carrier and SIM card details.

SUB

Pairwise identifier that ties a user to an SP CLIENT_ID. (Optional)

PHONE_NUMBER

Only when a valid CLIENT_ID and CLIENT_SECRET are present may the SP request discovery via the phone number. (Optional*) |

IP

SP webserver may make a discovery request passing client's IP. (Optional)

For discovery requests made only with a PHONE_NUMBER, you may use the "proof of possession" signature Header: x-authorization.


Did this page help you?