Skip to main content

Introduction

IDkollen provides a unified JSON/REST API for authenticating with a selection of eID providers.

The API is only accessible with TLS/SSL and a unique key provided by IDkollen. The Access key pair is private and should not be shared with a third party. The API should only be called from a server application, not directly from the client.

When signing up you will receive API keys for IDKollens staging and live environment.

EnvironmentURLCallback IP
Livehttps://api.idkollen.se/13.53.114.219
13.48.243.11
Staginghttps://stgapi.idkollen.se/13.53.56.116
13.53.92.159

Usage flow​

  1. The user initiates an authentication via the partner's interface.
  2. The partner calls IDkollen's API with the secret key to get the login link.
  3. The partner sends the login link to the end user to use to authenticate themselves with.
  4. The end user authenticate themselves themselves.
  5. The partner fetches the result or gets it via their callback endpoint.

Authentication​

To initiate requests to the API a secret key is needed. To request a secret key, contact support@idkollen.se. All API endpoints are authenticated using Basic Auth, where the "username" is the API key (account ID) and the "password" is the secret key.

Authorization: Basic ${ base64(accountId + ':' + secretKey) }

More information​

If you have any questions, please contact us at support@idkollen.se.