Architectuurscan Edukoppeling REST

De architectuurscan is uitgevoerd op 29 oktober 2020. Zie voor meer informatie, waaronder de adviezen die naar aanleiding van de scan door de Architectuurraad zijn uitgebracht, het adviesdeel en het bevindingendeel.

ROSA onderdeel	Bevindingen uit project: Edukoppeling REST/SAAS-profiel	Relatie met ROSA (Groen: ROSA, geel: Edukoppeling REST/SAAS-profiel)
Werkingsgebied	Gehele onderwijsdomein (cf. organisatorisch werkingsgebied zoals beschreven in Edukoppeling architectuur).	Fully conformant - Het REST/SaaS-profiel valt binnen de Edukoppeling architectuur waarvan het werkingsgebied het gehele onderwijsdomein betreft.
Toepassingsgebied	M2M-gegevensuitwisseling via een beveiligde point-to-pointverbinding waarbij RESTful standaarden voor gesloten (access-restricted en purpose-limited) APIs worden toegepast (zowel pull als push).	Consistent - Het REST-SaaS-profiel voegt een gestandaardiseerde werkwijze voor het gebruik van REST-APIs toe aan de Edukoppeling-architectuur.
Bovensectorale samenwerking	Gemeenschappelijkheid in informatiehuishouding Binnen het onderwijs zijn al veel ketenpartijen die gebruik maken van RESTful gegevensuitwisseling. Deze maken nu zelfstandige keuzes hoe transport, logistiek en beveiliging ingericht moeten worden. Het profiel beoogt hier meer standaardisatie in door te voeren, waarbij met name invulling gegeven wordt aan het kunnen routeren tussen de rollen die in Edukoppeling t.b.v. SaaS worden onderscheiden.	Compliant - Het SaaS/REST-profiel brengt gemeenschappelijkheid in RESTful gegevensuitwisseling in het onderwijsdomein.
IBP	TLS (wordt verwezen naar UBV) Vertrouwelijke gegevens in GET-parameters P.13: ‘dienen gepseudonimiseerd te zijn’ P.18: igv persoonsgegevens ‘kunnen aanvullende beveiligingsmaatregelen toegepast worden, zoals adequaat versleutelen en/of voorkomen ongewenste logging dmv filter’.	Compliant - Het SaaS/REST-profiel brengt gemeenschappelijkheid in RESTful gegevensuitwisseling in het onderwijsdomein De opmerkingen in de tekst over vertrouwelijke gegevens in GET-parameters zijn in kennelijke tegenspraak. ‘Vertrouwelijk’ is breder dan ‘persoonsgegevens’ Specifiek voor persoonsgegevens geldt AVG (‘passende maatregelen’) Pseudonimisering als specifieke maatregel is mogelijk niet in alle situaties toepasbaar. (Uit toelichtende gesprekken blijkt overigens dat ‘pseudonimisering’ hier gelezen moet worden als het gebruiken van betekenisloze identifiers.)
IAA	Identificatie/authenticatie verwerker obv OIN / PKI-infrastructuur (P2P). Eindorganisaties worden geïdentificeerd via routeringskenmerken (TO, FROM) Inzet van transparante dienstverleners wordt (nog) niet ondersteund (daarvoor: WUS) Verplicht gebruik Onderwijsserviceregister Verwijzing naar ontwikkelingen OAuth in bijlage A. Gebruik van API-sleutels geen onderdeel van het profiel, maar wel toegestaan Voor API-key (geen onderdeel profiel) stroomschema’s en mogelijke 401/403-foutcodes. Zoiets mist voor afhandeling van ‘from-OIN’ en OIN verwerker (P2P) .	Consistent - de invulling van IAA sluit aan bij bestaande methoden en voorzieningen (OIN, PKI, OSR). (Verplichte) toepassing van het OSR voor RESTful-gegevensuitwisseling tussen meerdere gelijkwaardige ketenpartijen stelt aanvullende eisen aan registratie van diensten in en de werking van het OSR.
Gegevensuitwisseling in de keten	Must: Gebruik van openbare internet “Overigens kan Edukoppeling ook toegepast worden in gesloten netwerken.”. Tegenspraak? Hoe ‘must’ te lezen? Foutafhandeling: Architectuur definieert categorieën A t/m E In 3.1.8 alleen foutmeldingen voor cat. A t.a.v. syntax to/from-routeringskenmerken. → hoe passen de andere categorieën op HTTP statuscodes?	Compliant - Toepassing voor zowel bevragingen als meldingen, gebruikmakend van generieke bedrijfstransactiepatronen uit Edukoppeling architectuur. Deze ‘atomaire’ patronen kunnen worden gecombineerd tot complexe, toepassingsspecifieke interactiepatronen.
Governance	Relaties met andere standaarden UBV (zie ook onderdeel IBP) Voor transparante intermediair, onweerlegbaarheid, en/of uitwisseling obv XML: toepassen Edukoppeling WUS-profiel OOAPI: onduidelijk of Edukoppeling-rollen hierin onderkend worden Inbedding in nationale (overheidsbrede) standaarden. Basis wordt gevormd door afspraken en voorschriften uit de landelijke API-strategie. Enige mate van ontkoppeling via MoSCoW-classificering. Op p.6 wordt XML over REST niet toegestaan, volgens API-24 is het een eigen afweging (COULD).	Consistent - REST-profiel wordt duidelijk gepositioneerd t.o.v. de bestaande WUS-profielen. De tekst is onduidelijk over of XML over REST ‘verboden’ is, of ontraden wordt. Er zijn scenario’s waarin XML over REST wenselijk kan zijn, m.n. De overgang van WUS naar REST, waarbij bestaande XML-gegevensstructuren tijdelijk gehandhaafd blijven. Afwijkingen op nationale afspraken zijn grotendeels beargumenteerd en niet in fundamentele tegenspraak.

Het domein (organisatorisch, taakvelden) binnen de overheid waarin het element (principe, standaard, voorziening) wordt of kan worden toegepast.

Een specifieke invulling van een set van koppelvlakstandaarden die een groep functionele eisen invult.

Samenhangend onderwijsprogramma in de bovenbouw van het voortgezet onderwijs met verplichte en facultatieve vakken, gericht op globale sectoren van werk en opleiding.

Vaststaand, erkend voorbeeld of model

Een natuurlijk persoon of een organisatie die een bepaalde rol heeft binnen een keten(samenwerking).

De maatregelen die nodig zijn om te voorkomen dat berichten door onbevoegden worden gewijzigd, onderschept of gelezen.

Weergave van een feit, begrip of aanwijzing, geschikt voor overdracht, interpretatie of verwerking door een persoon of apparaat.

Geheel van autorisaties voor de uitvoering van een bepaalde functie.

Weergave van een feit, begrip of aanwijzing, geschikt voor overdracht, interpretatie of verwerking door een persoon of apparaat.

Alle informatie over een geïdentificeerde of identificeerbare natuurlijke persoon.

Het proces waarbij informatie of gegevens worden omgezet in een onleesbare vorm, genaamd ciphertext, met behulp van een algoritme of een encryptiesleutel met als doel om de vertrouwelijkheid en beveiliging van gegevens te waarborgen door te voorkomen dat onbevoegden de informatie kunnen begrijpen of toegang kunnen krijgen tot de oorspronkelijke inhoud.

Het verwerken van persoonsgegevens op zodanige wijze dat de persoonsgegevens niet meer aan een specifieke betrokkene kunnen worden gekoppeld zonder dat aanvullende gegevens worden gebruikt, op voorwaarde dat deze aanvullende gegevens apart worden bewaard en technische en organisatorische maatregelen worden genomen om ervoor te zorgen dat de persoonsgegevens niet aan een geïdentificeerde of identificeerbare natuurlijke persoon worden gekoppeld.

Een label (meestal een string of tekst) waarmee je een entiteit aanduidt.

Het aantonen dat degene die zich identificeert ook daadwerkelijk degene is die zich als zodanig voorgeeft: ben je het ook echt?

Een natuurlijke persoon of rechtspersoon, een overheidsinstantie, een dienst of een ander orgaan die/ dat ten behoeve van de verwerkingsverantwoordelijke persoonsgegevens verwerkt.

De persoon of organisatie die voorziet in het leveren van een afgebakende prestatie (dienst) aan haar omgeving (de afnemers).

Informatie die in de vorm van een bestand kan worden meegestuurd met een inhoud van een bericht.

Een interface die uitwisseling van gegevens tussen applicaties verzorgt.

Een samenhangend geheel van gegevensverzamelingen en de daarbij behorende personen, procedures, processen en programmatuur alsmede de voor het informatiesysteem getroffen voorzieningen voor opslag, verwerking en communicatie.

Standaardoplossing, middel of maatregel binnen een bepaalde context. Die context kan klein of groot zijn (een organisatie, een keten, een domein, een land, of een groep daarvan). Generieke voorzieningen zijn voorzieningen die opgezet of doorontwikkeld zijn om her te gebruiken voor andere diensten.

Een afgebakende prestatie van een persoon of organisatie (de dienstverlener), die voorziet in een behoefte van haar omgeving (de afnemers).

Een enkelvoudige vraag die door een serviceafnemer aan een serviceaanbieder wordt gesteld en waar direct een antwoord op wordt verwacht

Herhaalde opeenvolging van één of meer ondersteunende processen waarmee standaardoplossingen worden geboden.

Vormen van berichtuitwisseling tussen twee partijen.

Een intermediair die berichten doorstuurt zonder iets aan het bericht (of berichtheader) te wijzigen.

Het kunnen aantonen door een ontvanger van een bericht dat de verzender dit heeft verstuurd. De verzender van het bericht kan dit niet ontkennen  

Normatief bedoelde overeenkomst tussen ketenpartners binnen een bepaalde context over de inrichting en het toepassen van bepaalde voorzieningen en/of standaarden.

Een specifieke invulling van een set van koppelvlakstandaarden die een groep functionele eisen invult.

Samenhangend onderwijsprogramma in de bovenbouw van het voortgezet onderwijs met verplichte en facultatieve vakken, gericht op globale sectoren van werk en opleiding.

Een beschrijving, "draaiboek", van een bepaalde gebeurtenis of reeks gebeurtenissen.