Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Workflow Diagram

...

API Endpoints

[POST] /api/authentications (PostAuthenticationAsync)

Creates a new authentication.

...

(Step 2)

If succeeds, returns authenticationId as a GUID in the location header. (Step 3)

Payload property name

Description

partnerId

Desired NEXT PartnerId

method

Authentication method to use:

nbid, nbid-mobil, Norwegian BankID / Mobile

sbid, sbid-mobil Swedish BankID / Mobile

identity

Identity (personal number / social security number) to verify against

callbackUrl

Your url that user will be redirected back to as shown in step 8.

AuthenticationId value will be appended as a query string parameter with id name when Identity API calls you back.

customProperties

An optional <string, string> Dictionary that your custom properties are stored on the authentication.

[GET] /bankid/{partnerId}/{authenticationId}/authenticate (GetBankIdAuthenticationUrlAsync [Redirects user to the corresponding service provider])

End user should be opening this page upon a new authentication is created and authenticationId is claimed. (Step 4)

Query string property name

Description

authenticationId

Value claimed on

customProperties

An optional <string, string> Dictionary that your custom properties are stored on the authentication.

2. Signing

todo:add api endpoints along with explanations

...