Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Stap

Handeling

1

Als klant (lokaal bestuur, Vlaamse overheidsdienst of dienstenleverancier) vult u de aansluitingsflow in voor uw organisatie en voor de applicatie die u wilt aansluiten:
https://dynamicforms.crmiv.vlaanderen.be/DynamicForms/notificatie
Hier vult u de volgende informatie in:

  • Basisgegevens: types aansluiting, organisatie, dienstenleverancier

  • Contactpersonen: algemeen, technisch, bij de dienstenleverancier en verantwoordelijke voor informatieveiligheidsbeleid (DPO)

  • Configuratie Notificaties: kanalen om de Notificaties beschikbaar te maken (passief en/of via e-mail) + eventueel dienstenpakket (via dienstenleverancier)

  • IPDC-catalogus: de gewenste producten en diensten (optioneel)

2

Digitaal Vlaanderen maakt de OAuth-client aan voor uw organisatie en doet de productconfiguratie voor Notificaties TNI.

3

Digitaal Vlaanderen bezorgt u de OAuth client ID. U kunt starten met de integratie, de configuratie en de validatie van uw testomgeving:

Zie ook: Test en validatie

Info

Deze stap is optioneel als u al een werkende integratie heeft en bijkomende aansluitingen aanvraagt. bedoel je bijvoorbeeld scopes uitbreiden (bv client heeft al scope Notificaties, en willen uitbreiden met scope om DOSIS aan te spreken)?

4

Info

Stappen 4 en 5 doorloopt u enkel als u zelf de OAuth-client ID zal beheren voor.

Meld u aan op het ACM Beheerportaal. Dit kunt u doen via de volgende URL:

https://beheerportaal-ti.vlaanderen.be/

Raadpleegde handleiding van het ACM Beheerportaal om clients te beheren.

Heeft u geen toegang tot het ACM Beheerportaal? Neem dan contact op met de Ondersteuners. <mailadres> en <telefoonnummer>.

5

Vooraleer u de OAuth Client kan gebruiken, moet u eenmalig uw publieke sleutel in de vorm van een JSON Web Key in het ACM-beheerportaal opladen. Deze publieke sleutel wordt gebruikt om uw OAuth Client te authenticeren bij het aanroepen van de Notificaties API. U kan ook kiezen voor een andere authenticatiemethode.

Zie ook: https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/2680390681/Security#Beveiliging-van-de-api-via-OAuth-2.0-en-een-JSON-Web-Token

6

Na validatie van uw testomgeving geeft u een seintje aan Digitaal Vlaanderen zodat zij de opzet voor de productieomgeving kunnen doen.

7

Digitaal Vlaanderen bezorgt u de OAuth client ID. U kunt starten met de integratie, de configuratie en de validatie van uw productieomgeving:

Zie ook: Productie en go-live

8

Info

Stappen 8 en 9 doorloopt u enkel als u zelf de OAuth-client ID zal beheren.

Note

Let op: voor productie kan u zelf de toegang tot het ACM-Beheerportaal regelen.

Als wettelijk vertegenwoordiger voor uw bedrijf heeft u automatisch toegang tot het ACM-beheerportaal.

Bent u dat niet? Vraag dan aan de wettelijk vertegenwoordiger van uw bedrijf om u in Gebruikersbeheer het recht API beheerder toe te kennen voor uw organisatie. Uw organisatie bestaat in Gebruikersbeheer vanaf de wettelijk vertegenwoordiger zelf voor een eerste keer aanmeldt. Als u zelf nog niet bestaat in Gebruikersbeheer, kan de wettelijk vertegenwoordiger u met uw rijksregisternummer als gebruiker toevoegen.

Voor meer informatie over het toekennen van rechten of het toevoegen van gebruikersbeheer vindt u in de handleiding om aan te melden als ondernemerCheck of u het recht API-beheerder hebt voor het ACM Beheerportaal. Dit kunt u controleren via de volgende URL’s:
-Test
-Productie

Zouden we niet meteen de links naar het beheer portaal zetten? Daar zien ze ook meteen dat ze geen rechten hebben?
Raadpleeg de handleiding van het ACM Beheerportaal om clients te beheren.
Indien u niet het recht API-beheerder hebt, dan het kunt u die aanvragen bij de Lokale Beheerder in uw organisatie.

9

Vooraleer u de OAuth Client kan gebruiken, moet u eenmalig uw publieke sleutel in de vorm van een JSON Web Key in het ACM-beheerportaal opladen. Deze publieke sleutel wordt gebruikt om uw OAuth Client te authenticeren bij het aanroepen van de Notificaties API. U kan ook kiezen voor een andere authenticatiemethode.

Zie ook: https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/2680390681/Security#Beveiliging-van-de-api-via-OAuth-2.0-en-een-JSON-Web-Token

10

Klaar? Geef Digitaal Vlaanderen een seintje zodat zij de opzet voor de productieomgeving kunnen doen. Voor nazorg of met vragen of problemen kunt u altijd terecht bij de Servicedesk Informatiekanalen.

...