The authentication service give access to the Signant ID portal for identification by means of the underlying trusted service providers supported by Signant. This API documentation describes the authentication web services functions in order to successfully create and validate authentication requests.
The service operates in two layers; the WS layer for initializing and validating the authentication requests, and a web layer where the user interacts with the service.
The integrator communicates with the «Signant authentication service» by a secure WS connection. The integrator must make sure the integrator credentials (DistributorID, AccessCode, TrackingID) are kept safe and measures should be made to avoid disclosing this data to any other parties.
The authentication sequence work flow
The following sequence diagram illustrates the work flow of an authentication request.
1) See AuthOptions-AuthTypes for a list of available authentication types.
2) RequestId will be added to the querystring before redirect: https://abc/auth will become https://abc/auth?requestid=xyz.
3) Access to norwegian ssn require legal basis.
InitAuth output: InitAuthResponse
Call this function to receive authentication session status. See sample request.
GetAuthStatus output – GetAuthStatusResponse
Authentication Status codes
Authentication status code can have the following values:
Authentication Session state
Authentication session can have the following states
1. Cancelled sessions cannot be reused, new session must be requested using InitAuth.
The sample requests and responses have been shortened down for readability and will therefore not work «as is», you will have to replace all required fields with correct data before trying to send a request to the service.
InitAuth sample request – Kopier fra Visual til Code
The request above will return the following result – Kopier fra Visual til Code
GetAuthStatus sample request – Kopier fra Visual til Code
The request above will return the following result – Kopier fra Visual til Code