Deze documentatie zal de informatie op https://prod.dosis-burgers.vlaanderen.be/ deels vervangen.
Doelpubliek
Deze documentatie is geschreven voor afnemers (lokale besturen, Vlaamse overheidsdiensten of dienstenleveranciers) die dossierstatusinformatie (Dosis) willen opladen en die informatie via een digitaal loket willen ontsluiten.
Naast de technische documentatie bieden we hier ook een aantal praktische instrumenten om de technische integratie op Dosis te beheren en te testen.
Aansluitingsprocedure
In deze presentatie leest u meer over de integratiemogelijkheden en de praktische stappen om aan te sluiten op Dosis.
De concrete stappen in de aansluiting op Dossierstatusinformatie met passieve notificaties zijn als volgt:
Stap | Handeling |
|---|---|
1 | Als klant (lokaal bestuur, Vlaamse overheidsdienst of dienstenleverancier) vult u de aansluitingsflow in:
|
2 | Informatie Vlaanderen laat de GeoSecure OAuth-client aanmaken voor uw organisatie. |
3 | Informatie Vlaanderen maakt de nieuwe bron-URI aan, dit is de unieke identificatie voor uw dossier. De bron-URI wordt doorgegeven in de aansluitingsflow. bijv. URN://gemeente.be/LB365 waarbij gemeente = organisatie en LB365 = brontoepassing |
4 | U krijgt een uitnodiging via mail van GeoSecure om aan te melden in de organisatie en de uitnodiging te bevestigen. Bent u nog niet geregistreerd bij Informatie Vlaanderen, dan moet die registratie eerst gebeuren in de bèta/test-omgeving: https://beta.auth.vlaanderen.be Na de registratie wordt de klant eigenaar van de OAuth-client door de uitnodiging te bevestigen. |
5 | U moet nu de OAuth-client authenticeren op de OAuth 2.0 Server. Dat kan met behulp van dit credential: JSON Web Token met asymmetrische sleutel |
6 | De klant |
Stappenplan aansluiting op GeoSecure
Om eigenaar te worden van een OAuth-client moet u zich eerst registreren de Bèta/Test-omgeving van GeoSecure (https://beta.oauth.vlaanderen.be). Na registratie kan u aanmelden op de bèta-omgeving met een gebruikersnaam en wachtwoord.
De procedure hiervoor ziet er als volgt uit:
Stap | Handeling |
|---|---|
1 | Klik op de link in de mail om uw uitnodiging te bevestigen.  |
2 | Klikken op de link in de mail leidt naar het onderstaande scherm waar u de registratie kan starten door op hier te klikken:  |
3 | Om te registreren vult u de gevraagde informatie in en klikt u vervolgens op Registreer.  Er wordt een mail verstuurd naar het opgegeven e-mailadres met een verificatielink. De verificatielink is 24 uur geldig vanaf het moment dat de e-mail is verstuurd. |
4 | Klik in de mail op de registratielink. Geef je gebruikersnaam en wachtwoord in om de registratie te bevestigen:  |
5 | Bevestig vervolgens dat u tot de opgegeven organisatie behoort:  Uw registratie is voltooid. Zodra u eigenaar bent van een OAuth-client, ontvangt u een e-mail en kan u de publieke key van het certificaat opladen via https://beta.oauth.vlaanderen.be . Na aanmelden met uw gebruikersnaam en wachtwoord kunt u de publieke sleutel voor uw Client certificaat toevoegen:  |