Migratie GeoSecure naar ACM-IDM voor Notificaties

Aanleiding

Digitaal Vlaanderen kiest voortaan voor een uniforme beveiliging van webdiensten via het Toegangs- en Gebruikersbeheer Vlaanderen (ACM-IDM). Op onze site leest u waarom we die keuze maakten en hoe u kunt inschrijven om op de hoogte te blijven van belangrijke evoluties.

Wie vandaag nog GeoSecure gebruikt voor de Notificaties-aansluiting moet dus een migratie naar ACM-IDM plannen. Digitaal Vlaanderen ondersteunt uiteraard maximaal bij deze transitie.

Check vooraf

Check vooraf of u nog een integratie met de Notificaties bèta-omgeving heeft.

Indien ja, laat uw URL’s verwijzen naar het endpoint van de Notificaties TNI-omgeving: https://notificaties.api.tni-vlaanderen.be/ met dezelfde authenticatie als voor Geosecure bèta.

Raadpleeg het overzicht met de Notificaties-basisbegrippen.

Stappenplan

Om de migratie te starten, gaat u als volgt te werk:

1. Heeft u een integratie met de Notificaties TNI-omgeving? Laat uw authenticatie naar de ACM TNI-endpoints verwijzen. Lees meer over de ACM-endpoints.

   1. Check eerst of u het recht API-beheerder hebt voor het ACM Beheerportaal. Dit kunt u controleren via de volgende URL’s:
      -Test
      -Productie
      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.

   2. Bent u een dienstenleverancier? Dan moet het lokaal bestuur het beheer van de OAuth-client aan u delegeren via het Beheerportaal. Meer informatie vindt u in de handleiding van het ACM Beheerportaal om clients te beheren.

   3. Vervang uw huidige GeoSecure-clientID door uw ACM-ClientID in de calls die u doet om een access token aan te vragen. De ACM-ClientID kunt u opvragen/aanmaken in het in het ACM-Beheerportaal op TNI > API- en Clientbeheer > Mijn OAuth-clients.

   4. Spreek voor authenticatie de ACM-endpoints aan i.p.v. de GeoSecure-endpoints. Lees meer over de ACM-endpoints.

2. Test vervolgens of u een notificatie succesvol kan versturen op TNI.

3. Doorloop dezelfde stappen voor uw productie-omgeving via het ACM-Beheerportaal op productie.

4. Wanneer de migratie succesvol is verlopen, laat dit weten aan het team Aansluitingen Mijn Burgerprofiel via aansluitingen.mijnburgerprofiel@vlaanderen.be.

Nuttige links

Bekijk zeker ook de informatie via de volgende nuttige links:

• Check de nodige rollen en rechten bij Gebruikersbeheer Vlaanderen

• Lees de documentatie bij het ACM Beheerportaal

• Beheer uw OAuth-client via het ACM-Beheerportaal

• Lees de documentatie Vlaams Toegangsbeheer

Vragen?

Welkom op: uitfaseringgeosecure@vlaanderen.be of aansluitingen.mijnburgerprofiel@vlaanderen.be

Of kom langs op het technisch spreekuur van het team Aansluitingen, wekelijks op dinsdag van 13:00 tot 14:00 uur.