Doelstellingen #

FTV wordt uitgevoerd als invulling van een verleende subsidie. De subsidie benoemt als doelstelling:

Definieer een standaardmethodiek voor toegangsverlening tot API’s #

Er bestaat nu een grote diversiteit aan oplossingen voor toegangsverlening. Dat geeft uitdagingen voor zowel afnemers als aanbieders.

De doelstellingen van het project, en hoe een standaardmethodiek een oplossing voor de uitdagingen kan zijn, luiden als volgt:

Verbeterde technische interoperabiliteit. API’s en hun afnemers zullen beter op elkaar aansluiten als ze dezelfde methodiek gebruiken.
Verlaging van de beheerslast. Eén enkele methodiek meerdere malen toepassen levert op termijn besparingen in ontwerp, realisatie en beheer.
Verhoging van in controle zijn op toegangsbeslissingen. Door beleid gestandaardiseerd te implementeren wordt het eenvoudiger de juiste toepassing ervan te verifiëren en te monitoren.
Geeft richting aan het transitiepad naar de eindsituatie. In de meerjarenvisie worden grote doelen gedefinieerd. Met een concrete invulling van een deel van de weg daarheen wordt de juiste richting ingezet naar die doelen.

Context #

Organisatie #

De subsidie is verstrekt door BZK, en wordt uitgevoerd door VNG Realisatie . Voor praktische uitvoering en ondersteuning is aansluiting bij Digilab gevonden.

Qua organisatorische context valt dit onderwerp onder het programma Realisatie IBDS , en daarbinnen onder het Federatieve datastelsel (FDS) .

Het primaire doelgebied is daarmee het FDS te voorzien van het aspect toegangsverlening. Secundair wordt gekeken of dezelfde of andere methodieken buiten het FDS inzetbaar zijn.

Architectuur #

Als opdracht van BZK valt dit project onder de MIDO en de IBDS , en is gehouden aan de architectuur- en andere principes van die stelsels. Dat is in brede zin de GDI , en in het bijzonder de domeinarchitecturen Gegevensuitwisseling en Toegang .

In de architectuurplaat van FDS geeft FTV invulling aan een van de elementen van de stelselfunctie Poortwachter .

De methodiek zal de eigenschap ‘federatief’ dragen, passend in het FDS. Dat wil zeggen dat de oplossing niet gecentraliseerd zal zijn rond een enkel vertrouwd punt, en ook niet in gescheiden silo’s zal plaatsvinden, maar een collectief stelsel van afspraken zal zijn, een samenwerkingsverband.

Scope #

Onze scope bepalen we door in te gaan op een aantal sleutelwoorden uit de doelstelling:

Definieer wil zeggen dat er methodiek wordt voorgesteld, en niet per se gerealiseerd. Een goede beschrijving van de methode, een breed begrip en draagvlak, en uiteindelijk ook adoptie ervan, dat is het primaire doel. Er zullen ook tastbare technische resultaten zijn, om aan te tonen dat de methodiek haalbaar, schaalbaar en veilig is. Daarnaast kan een referentie-implementatie gemaakt worden als educatief instrument en als halffabrikaat, mocht dat in het verloop van het project wenselijk blijven. Het is expliciet niet de bedoeling om een softwareproduct op te leveren dat in productie genomen kan worden.

Door het aspect toegangsverlening oftewel autorisatie uit te lichten worden expliciet andere aspecten zoals identificatie, authenticatie en encryptie buiten beschouwing gelaten. Vanzelfsprekend zijn dit wel cruciale aspecten, die ook spelen bij het uitwisselen van informatie over autorisatie, en daarmee voorwaardelijk aan verantwoordelijke gegevensuitwisseling als geheel, maar vallen buiten deze scope.

De toevoeging tot API’s beperkt het project tot geautomatiseerde gegevensuitwisseling. Het gaat niet over autorisatie via een niet-digitaal medium en ook niet over interacties tussen mens en computer.

Ook beperkt tot API’s de scope tot uitwisseling waarbij minstens twee door API’s verbonden systemen betrokken zijn. Autorisatie binnen een applicatie of dienst, of die niet via API’s verloopt heeft wel een grote overlap in methode en techniek, maar is niet het doel hier.

Tegelijk moet de term ’tot API’s’ niet te letterlijk genomen worden. Het gaat om de toegang tot datagerichte diensten, die via een API tot stand komt. De toegang tot de API is te nauw verwoordt, de werkelijke toegang kijkt naar wat de API aan verwerking doet.

Terminologie #

Nederlands is de voorkeurstaal voor de projectdocumentatie. In code wordt voor Engels gekozen. Belangrijke niet-voor de hand liggende termen zijn:

Toegangsverlening is de Nederlandse term die gekozen is voor het proces. Autorisatie had ook gekund, zeker omdat die term op het Engelse Authorisation lijkt.

Autorisatieregels is de Nederlandse term voor de formalisering van beleid in concrete regels. Policies is de Engelse vertaling.