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
Bij Naam Toepassing (in de API-handleiding vermeld als ‘Client_ID’) zet u een begrijpbare naam.
Bij Callback URL zet u https://digitaal-ondertekenen-ti.vlaanderen.be
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
Bij Naam Toepassing (in de API-handleiding vermeld als ‘Client_ID’) zet je een begrijpbare naam.
Bij Callback URL zet je https://digitaal-ondertekenen-ti.vlaanderen.be
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
API Documentatie
Al de API-mogelijkheden kan je bekijken op deze pagina
