link

# Registration: URL construction

This page contains a URL construction guide for registration with the MobileID App.

# OIDC

# Request

GET <SIGNICAT_AUTHORIZATION_ENDPOINT>?
response_type=code&; 
scope=openid+profile+mobileid&; 
client_id=<CUSTOMER_CLIENT_ID>&; 
redirect_uri=<CUSTOMER_CALLBACK_URL>&; 
state=<CUSTOMER_REG_METHOD_NAME:STATE_IDENTIFIER>&; 
acr_values=urn:signicat:oidc:method:<CUSTOMER_REG_METHOD_NAME>

Note

The value for CUSTOMER_REG_METHOD_NAME depends on the environment. If you would like to use our demo service that is set up in pre-production, contact us at support@signicat.com and we will provide the relevant details.

# Response

{
    "pairingCode": "<PAIRING_CODE>",
    "links": [
        {
            "rel": "status",
            "href": "<STATUS_URL>",
            "type": "GET"
        },
        {
            "rel": "complete",
            "href": "<COMPLETE_URL>",
            "type": "GET"
        },
        {
            "rel": "cancel",
            "href": "<CANCEL_URL>",
            "type": "GET"
        },
        ...
    ]
}

This is a regular authorisation code flow. A request is sent to the authorisation endpoint and upon successful registration, an authorisation code will be sent to the customer's backend (redirect to CUSTOMER_CALLBACK_URL).

# SAML

# Request

GET <SIGNICAT_BASE_URL>/std/method/<CUSTOMER_SERVICE>/?
id=<CUSTOMER_REG_METHOD_NAME>::&
target=<CUSTOMER_REDIRECT_URL>

# Response

Signicat Page is shown with information on how to continue the process. The available options are QR code scan or manually entering a pairing code.

# Parameters

Parameter Description
STATE_IDENTIFIER Random text used together with CUSTOMER_REG_METHOD_NAME to uniquely identify the ongoing registration session in the customer's backend. The session state can be compared when callback data is received from Signicat.
PAIRING_CODE As described above. To be passed to the MobileID App.
STATUS_URL URL (towards Signicat's server) that is used to get the status of the ongoing operation.
COMPLETE_URL URL (towards Signicat's server) that is used to signal the completion of the transaction. This will need to be used when the customer's app gets notification from the MobileID App that registration is complete.
CANCEL_URL URL (towards Signicat's server) to cancel the ongoing operation.

# Further reading

Last updated: 7/21/2021, 1:18:18 PM