Gedaan met laden. U bevindt zich op: API integratie met de Handtekenmap Starten met Digitaal Ondertekenen

API integratie met de Handtekenmap

Om te integreren met de Handtekenmap via de API(opent in nieuw venster) volgt u de onderstaande stappen.

Elke integratie wordt eerst in de T&I omgeving opgezet alvorens deze in de Productieomgeving wordt uitgerold.

1. Inleidingsmail

Stuur een e-mail naar ondersteuning.digitaaltekenen@vlaanderen.be(opent in uw e-mail applicatie) met de vermelding dat u een integratie wenst met de Handtekenmap. Vermeld zeker volgende gegevens:

  • Naam 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 de Handtekenmap.

2. 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 de Handtekenmap.

3. Maak een gebruiker aan voor de Handtekenmap in T&I

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

4. De organisatie wordt automatisch aangemaakt.

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

5. integratie aanmaken in de Handtekenmap zelf

De nieuwe gebruiker (met recht ‘Handtekenmap’ /‘Beheerder) meldt zich aan op https://handtekenmap-ti.vlaanderen.be(opent in nieuw venster). 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’)

6. Registreer een certificaat via DCBaaS

Registreer een certificaat via DCBaaS, het certificatenbeheer van Vlaamse overheid (= https://dcb.vlaanderen.be(opent in nieuw venster)). 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 Digitale Handtekenmap(opent in nieuw venster)

API Endpoints

    Volg Digitaal Vlaanderen op