/
Opzet beheerportaal T&I - Stappenplan

Opzet beheerportaal T&I - Stappenplan

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

  • Onder ‘In afwachting van aanvaarding’ kan u de aanvraag terugvinden

  • Klik door op deze aanvraag en klik dan onderaan op ‘aanvaarden’

  • Indien in gebruikersbeheer meer dan 1 API-beheerder recht werd toegekend, zal het mogelijk zijn om de keuze te maken wie de eigenaar wordt van deze API Client.

 

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" }