De MAGDA Solid diensten zijn specifieke REST diensten ontworpen voor het Solid ecosysteem van Datanutsbedrijf, daarom wijken ze soms af van de gangbare conventies voor MAGDA Webservices & MAGDA REST diensten waar dit genoodzaakt is om compatibiliteit met het Solid ecosysteem te waarborgen.

Situering

Deze dienstverlening kadert binnen het Solid-domein van MAGDA Platform, en meerbepaald binnen het MAGDA Solid Attestation Service aanbod die het voor afnemers en bronnen eenvoudig maakt om authentieke data te ontsluiten via de Solid datakluis in de vorm van een Verifiable Credential.

De Verifier Service maakt het mogelijk voor een derde partij om een Verifiable Credential te valideren tegen de vereisten van het Solid ecosysteem op vlak van uitgever, handtekening, geldigheidsperiode en eventuele intrekking. Hierbij hoeft de Verifier slechts één API call uit te voeren naar de Verifier Service om al deze criteria te valideren, en moet er zelf geen complexe logica worden voorzien om digitale handtekeningen te valideren of de intrekkingsstatus te controleren.

Verwante diensten

De Verifier Service zal enkel succesvol attestaties valideren onder de vorm van een Verifiable Credential uitgegeven door de MAGDA Solid Attestation Service.

Gebruiksvoorwaarden

Om gebruikt te kunnen maken van deze dienst dient men een aansluitingsprocedure te doorlopen op de MAGDA Solid dienstverlening, in kader van een integratie met het Solid-ecosysteem van Vlaams Datanutsbedrijf.

Meer informatie over het aansluitingsproces is terug te vinden op https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/6241026367/Solid#Aansluitingsproces.

Functionaliteiten

Deze API maakt het mogelijk om Verifiable Credentials uitgegeven door de Attestation Service te valideren op vlak van digitale handtekening,

Vraag

Antwoord

Werking

Aandachtspunten

Deze API maakt gebruik van Solid-OIDC Authenticatie, dit authenticatiemiddel kan door de afnemer op twee manieren worden opgezet:

Via een aansluiting op ACM/IDM (voor entiteiten binnen de Vlaamse overheid)
Via een eigen OpenID Provider die Solid-OIDC ondersteunt (voor private partijen aangesloten bij het ecosysteem van Vlaams Datanutsbedrijf).

Zowel voor aansluitingen op Solid-OIDC via ACM/IDM als bij het gebruik van een eigen OpenID Provider die Solid-OIDC ondersteunt is het noodzakelijk dat u eerst een integratie opstart met het Vlaams Datanutsbedrijf, zoals hier beschreven.

Daarnaast is het verplicht om DPoP te gebruiken bij het aanspreken van de Verifier Service, om te beschermen tegen een eventueel hergebruik van de ID Tokens die nodig zijn om te authenticeren met deze API binnen het Solid ecosysteem.

Responsetijden & Beschikbaarheid

Deze dienst heeft volgende gemiddelde performantie in performantietesten behaald:

Gemiddelde respons tijd	1 sec
90 percentiel	2 sec
95 percentiel	3 sec
Max error rate	< 1%

Merk op dat rate limiting toegepast wordt op deze dienstverlening, met een maximum van 10 requests/seconde.

Meer informatie over SLA’s en dienstverleningsmodel van de MAGDA Solid diensten kan u terugvinden op: https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/6241026367/Solid#Ondersteuning

Logging

De opvragingen die gebeuren via deze webservice dienen te worden bewaard zoals beschreven op de pagina "MAGDA logging". Dit houdt in dat een afnemer die de Verifier Service aanroept minstens volgende gegevens moet bijhouden in haar audit log:

Gegeven	Omschrijving
Referentie	Unieke identificatie van de request, die met MAGDA platform werd gedeeld via ten minste één van volgende HTTP request-headers: `X-Request-ID` `X-Correlation-ID` `X-Tracing-ID`
Wat	Identificatie van de MAGDA API die werd aangesproken (e.g. het gebruikte endpoint)
Wie	Identificatie van de toepassing van de afnemer
Gebruiker	INSZ nummer of andere unieke identifier van de gebruiker van de toepassing van de afnemer
Waarom	Finaliteit waarvoor deze vraag werd gesteld
Wanneer	tijdstip waarop de vraag / het antwoord verwerkt wordt
Over wie	Identificatie van het data subject waarop deze bevraging toepassing heeft.

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Domein	Solid
Classificatie

Verifier Service v1