/
Opzet beheerportaal T&I - Stappenplan

Opzet beheerportaal T&I - Stappenplan

This content is archived.
Learn more

Deze inhoud is niet meer actueel. Gelieve onderstaand stappenplan te volgen:

Stappenplan voor integratoren - nieuwe aansluitingen OLDArchived

 

1. Log in op beheerportaal

image-20251203-152035.png
image-20251203-152041.png

Voorwaarde: Alleen lokaal beheerders / wettelijk vertegenwoordigers met API Beheerder recht hebben toegang. Voor meer informatie zie Informatiepagina lokale beheerder

2. Maak OAuth client aan

  • Klik op Nieuwe OAuth client aanmaken

  • Vul de vereiste velden in:

    • Naam:

      • Volg de conventie: Digitaal Ondertekenen <naam organisatie/klant>

    • Organisatie eigenaar

    • Communicatie email adres

    • Authenticatie: Client/Secret

    • OAuth API:

      • Klik op de knop ‘Koppelen aan een nieuwe Oauth API’

      • Selecteer ‘DigitaalOndertekenen POC API T&I’

  • Bewaar client id/secret

  • Klik op aanmaken

image-20251203-152100.png

 

Voor algemene informatie over API-clients aanmaken zie Nieuwe OAuth client aanmaken

3. Keur de client goed (optionele stap)

Indien de client in naam van een klant werd aangemaakt, dient de klant deze nog goed te keuren

Voorwaarde: Alleen lokaal beheerders / wettelijk vertegenwoordigers met API Beheerder recht hebben toegang. Voor meer informatie zie Informatiepagina lokale beheerder

Stappen voor klant

  • Zoek de nieuw aangemaakte client op in Mijn OAuth Clients

  • Klik door op de nieuw aangemaakte client

  • In het detail van de client klik onderaan op de link van de OAuth API

  • Klik onderaan op aanvaarden

image-20260224-084147.png
image-20260224-084037.png

 

 

4. Bezorg gegevens technische gebruiker

  • Bezorg volgende informatie

    • Naam van de technische gebruiker van de SigningHub Enterprise

    • E-mail adres van de technische gebruiker van de SigningHub Enterprise

  • Bezorg deze informatie door onderstaande Microsoft Form in te vullen: Opzet beheerportaal T&I - Formulier invullen

image-20251203-152505.png

 

5. Goedkeuring API-Client

Deze stap wordt uitgevoerd door Digitaal Vlaanderen. Van zodra de client is goedgekeurd, ontvangt u een melding.

  • Digitaal Vlaanderen vult de velden in adhv de aangeleverde informatie:

    • Setbyapi_name

    • Setbyapi_email

  • Digitaal Vlaanderen zet de scopes

    • ovo_info

  • Digitaal Vlaanderen keurt de client goed

 

6. Ophalen token beheerportaal

Gebruik volgende request om een token via het Beheerportaal op te halen:

POST

https://authenticatie-ti.vlaanderen.be/op/v1/token

client_id

client_id OAUTH client

client_secret

Client_secret OAUTH client

grant_type

client_credentials

Voorbeeld response:

{  "access_token": "dCXq0EY7….Za18cs",  "expires_in": 3600,  "scope": "dv_handtekenmap_poc vo_info",  "token_type": "Bearer" }

7. Ophalen bearer token digitaal ondertekenen

Gebruik volgende request om een token via het Beheerportaal op te halen:

POST

https://digitaal-ondertekenen-openapi-ti.vlaanderen.be/authenticate/single-sign-on

token

Zie access_token stap 6

method

OAUTH2

profile_name

beheerdersportaal-test

client_id

Client_id van enterprise in signinghub, niet van de api client

client_secret

Client_secret van enterprise in signinghub, niet van de api client

Voorbeeld response:

{  "access_token": "TJpVL….bAY",  "token_type": "bearer",  "expires_in": 86400,  "refresh_token": "QUVTM…DgZ",  "authentication_access_token": "dCXq0….18cs" }