Parkeerrechten

Vergunningsoftware BV

Introductie

Deze applicatie demonstreert hoe een applicatie (client) gebruik maakt van een FSC compliant koppeling tussen organisaties.

De applicatie toont twee typen koppelingen:

Directe koppeling tussen organisatie A en organisatie B
Gedelegeerde koppeling waarbij organisatie C namens organisatie A bij organisatie B data ophaalt.

De voorbeeld organisaties zijn:

De gemeente Stijns met een Parkeerrechten-register
Rijksdienst voor Realistische Demo's met een Kentekenregister
Vergunningsoftware BV met een applicatie waarmee burgers een parkeervergunning kunnen aanvragen.

Request flow

De parkeerrechten ophalen en toevoegen kan op twee verschillende manieren. Door zelf toegang te regelen of via Delegatie. De flow is steeds als volgt:

Client (deze website) -> Outway (FSC compliant gateway) -> Inway (FSC compliant gateway) -> Parkeerrechten (API).

De client draait in een netwerk wat toegang heeft tot de Outway.
De client doet het request aan de Outway met daarin de referentie van de toegang tot de API
1. Technisch is dit de grant hash van de toegang die gebruikt moet worden en deze wordt in de Fsc-Grant-Hash header gezet. De toegang is eerder al georganiseerd door een Contract tussen de betrokken organisaties op te stellen.
De Outway controleert of er een valide toegangstoken beschikbaar is en vraagt deze aan bij de API provider wanneer nodig
De Outway stuurt het request naar de inway inclusief het toegangstoken
De Inway herkent het token en stuurt het request door naar de API.

Toegang op basis van unieke referentie

Organisaties stellen met elkaar een contract op waarin de connecties van Outway naar API zijn gedefinieerd. Elk van deze connecties heeft een unieke referentie. Deze referentie wordt een client applicatie gebruikt om aan de Outway aan te geven op basis van welke toestemming de connectie en daarmee het request uitgevoerd wordt.