Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Import Link Fixer

...

Analysts and developers of integrators who want to call a secured Informatie Digitaal Vlaanderen API and need to know how to authorize.

...

  • Help you decide the most suitable method to connect to the Informatie Digitaal Vlaanderen REST APIs
  • Provide a step-by-step explanation of how to get authorization to use the secured Informatie Digitaal Vlaanderen REST APIs with your chosen method.

...

TermDefinition
Resource OwnerThe entity that can grant access to a protected resource. Typically, this is the end-user.
Client

An application requesting access to a protected resource on behalf of the Resource Owner.

Resource ServerThe server hosting the protected resources. These are typically the secured Informatie Digitaal Vlaanderen REST APIs.
Authorization ServerThe server that authenticates the Resource Owner and issues Access Tokens after getting proper authorization. In this case this is the Informatie Digitaal Vlaanderen Authorization Server (oauthauthenticatie.vlaanderen.be)
Access TokenA credential that can be used by an application to access an API.
Refresh TokenA long-lived token that is used to obtain a new Access Token after a previous one has expired.
JSON Web KeyA JavaScript Object Notation (JSON) data structure that represents a cryptographic key. This will be used to establish asynchronous authentication.

How to obtain your oauth Client from

...

Digitaal Vlaanderen?

  1. Download the Microsoft Word form: 
    View file
    nameAanvraagformulier NL OAuth Client Digitaal Vlaanderen.docx
    height250
  1. Complete the form (preferrably in Dutch) and save.
  2. Send the form as attachment to digitaal.vlaanderen@vlaanderen.be.

Our helpdesk will set up the requested oauth client and send an e-mail containing a link to a page to manage his registered client(s).

Next step: find the most suitable way to connect.You can obtain access to the GIPOD API trough the self-service portal "Beheerderportaal". There are two environments:

Next step: https://authenticatie.vlaanderen.be/docs/beveiligen-van-api/oauth-rest/rest-server2server/aanvraag-access-token/#client-authenticatie-via-een-jwt-token