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

Integratie aanmaken in Digitaal Ondertekenen zelf

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

Wanneer het wachtwoord van de technical user ingesteld is, meldt u 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