Document toolboxDocument toolbox

Stappenplan voor nieuwe integratoren

Werkzaamheden in de Test omgeving

Inleidingsmail

Stuur een e-mail naar ondersteuning.digitaaltekenen@vlaanderen.be met de vermelding dat u een integratie wenst met Digitaal Ondertekenen. Vermeld zeker volgende gegevens:

  • Naam van de organisatie.

  • KBO nummer/instellingsnummer/OVO-code van de organisatie.

  • Met welke organisaties u een koppeling gaat maken.

  • Of u op dit ogenblik een User-Case hebt.

  • Hoe u uw toepassing wil koppelen aan Digitaal Ondertekenen.

Aanmaken van de organisatie in T&I

Indien uw organisatie nog niet bestaat in de T&I-omgeving, dan wordt deze aangemaakt. Er zal een lokale beheerder worden aangesteld.

Dit is dezelfde persoon als in de productieomgeving. Uw organisatie in T&I wordt vervolgens getypeerd om gebruik te kunnen maken van Digitaal Ondertekenen.

Maak een gebruiker aan voor Digitaal Ondertekenen in T&I

De lokale beheerder maakt in de T&I-omgeving (https://gebruikersbeheer-ti.vlaanderen.be) een gebruiker aan,
koppelt de gebruiker aan de organisatie en kent het recht ‘Digitaal Ondertekenen’ met context ‘Beheerder’ toe.

De organisatie wordt automatisch aangemaakt.

Door het aanmaken van deze gebruiker wordt de organisatie automatisch aangemaakt in Digitaal Ondertekenen.

Integratie aanmaken in Digitaal Ondertekenen T&I zelf

De nieuwe gebruiker (met recht ‘Digitaal Ondertekenen’ /‘Beheerder) meldt zich aan op https://digitaal-ondertekenen-ti.vlaanderen.be. Eens aangemeld klikt hij op het mannetje (avatar) in de rechter bovenhoek ==> Bedrijfsinstellingen ==> Integraties.

Hier staat reeds 1 organisatie geregistreerd. Deze laat u staan want deze zorgt voor de doorstroming vanuit het Gebruikersbeheer.

De gebruiker klikt op het + teken

Klik op de knop Genereren bij Klantgeheim (in de API-handleiding vermeld als ‘Client_secret’)

Registreer een certificaat via DCBaaS

Registreer een certificaat via DCBaaS, het certificatenbeheer van Vlaamse overheid (https://dcb.vlaanderen.be). HIer vindt u meer informatie over de werking van DCB.

Deze dient van het type SSL Client + Signing te zijn.

Bezorg deze CN via het volgende formulier: Aanvraag voor API integratie Digitaal Ondertekenen

 

Werkzaamheden in de Productieomgeving

Als de development helemaal uitgevoerd is dien je onderstaande zaken te doen:

Integratie aanmaken in Digitaal Ondertekenen zelf

Een gebruiker (met recht ‘Digitaal Ondertekenen’ /‘Beheerder) meldt zich aan op https://digitaal-ondertekenen.vlaanderen.be. Eens aangemeld klikt hij op het mannetje (avatar) in de rechter bovenhoek ==> Bedrijfsinstellingen ==> Integraties.

Hier staat reeds 1 organisatie geregistreerd. Deze laat je staan want deze zorgt voor de doorstroming vanuit het Gebruikersbeheer.

De gebruiker klikt op het + teken

Klik op de knop Genereren bij Klantgeheim (in de API-handleiding vermeld als ‘Client_secret’)

Registreer een certificaat via DCBaaS

Registreer een certificaat via DCBaaS, het certificatenbeheer van Vlaamse overheid (https://dcb.vlaanderen.be). HIer vindt u meer informatie over de werking van DCB.

Deze dient van het type SSL Client + Signing te zijn.

Bezorg deze CN via het volgende formulier: Aanvraag voor API integratie Digitaal Ondertekenen

API Endpoints

 

Wij werken met 2 endpoints.
Een endpoint voor de testomgeving en 1 voor de productie omgeving.

Hieronder vindt u beide:

API Documentatie

Al de API-mogelijkheden kan je bekijken op deze pagina