Hvem og hvornår
Bruges af en borger. Nogle samtykkeanmodninger kræver to borgeres accept.
Dette kan for eksempel være, når begge forældre skal samtykke på et barns vegne. I en samtykkeanmodning er det altid angivet,
hvilken borger, der skal besvarer samtykkeanmodningen,
og hvilken borger, som skal bekræfte besvarelsen af samtykkeanmodningen.
Dette integrationspunkt benyttes til at sende den bekræftende borger direkte til siden for bekræftelse af en anmodning, som afventer bekræftelse.
Forudsætninger
- Myndigheden er tilsluttet Digitalt Samtykke.
- Anvendersystemet har et OCES-systemcertifikat, og certifikatets subject serial number er registreret som aktivt anvendersystem hos myndigheden.
- Den samtykkeerklæringsskabelon, der bruges, er på anvendersystemets liste over tilladte skabeloner.
- Der findes en anmodning, hvor første samtykkegiver har svaret, og som afventer anden giver. Anvendersystemet kender dens id.
Parametrene skal signeres og krypteres
Parametrene sendes som JWE omkring en JWS i ét formfelt ved navn Body.
Opbygningen, certifikaternes roller og registreringen er beskrevet samlet i
Signering og kryptering.
Forløbet
Trin 1. Systemet bygger og beskytter parametrene
- 1.1 Saml parametrene som JSON. Ét JSON-dokument med de parametre, anmodningen skal oprettes ud fra.
-
1.2 Signér som JWS. Signér JSON-dokumentet med anvendersystemets eget
OCES-systemcertifikat (
RS256). Se Signering og kryptering for de nøjagtige krav. -
1.3 Pak JWS og certifikat i en envelope. Et JSON-objekt med
jwsogcertificate, hvor certifikatet er den offentlige del af det, der lige har signeret, i PEM-format. -
1.4 Kryptér envelopen som JWE. Kryptér den til Digitalt Samtykkes
systemcertifikat (
RSA-OAEP+A256GCM). Headeren skal bærex5t#S256, som udpeger det certifikat, der er krypteret til.
Resultatet lægges i formfeltet Body og postes til
/api/Integration/{tenantCvr}/SignedConsentResponseParameters/Confirm.
Se endpointet i Swagger UI.
Trin 2. Digitalt Samtykke pakker ud og validerer
Envelopen dekrypteres, signaturen kontrolleres mod det registrerede certifikat, og anmodningen slås op. Anmodningen skal afvente bekræftelse og være baseret på en af anvendersystemets tilladte skabeloner.
Trin 3. Anden giver bekræfter
Efter login lander borgeren på bekræftelsessiden med den besvarede samtykkeanmodning. Borger kan enten afvise eller bekræfte besvarelsen af samtykkeanmodningen.
Trin 4. Svaret sendes tilbage
Svaret beskyttes som parametrene, men med to forskelle: certifikaternes roller er byttet om, og trin 3 springes over. Der er ingen envelope - JWS'en krypteres direkte.
-
4.1 Kontrollér at modtageren svarer. Digitalt Samtykke laver et
HEAD-kald tilRedirectionUrlfra sin egen server. Svarer den ikke, sendes borgeren ikke af sted, men får en "prøv igen" i stedet. - 4.2 Signér og kryptér svaret. Svaret signeres som JWS med det af Digitalt Samtykkes systemcertifikater, anvendersystemet krypterede til og krypteres som JWE til det certifikat, anvendersystemet sendte med i envelopen i trin 1.3.
-
4.3 Browseren afleverer svaret. Der bliver lavet en form-post fra brugerens browser med svaret
til
RedirectionUrl. Felterne i den formular, og modellen inde i envelopen, står under Callbacks på bekræft-endpointet: se retursvaret i Swagger UI.
Krav til integrationen
Bekræftelsen kan være registreret, selv om borgeren ikke kommer tilbage
Borgerens svar registreres i Digitalt Samtykke i det øjeblik der bekræftes eller afvises, altså i trin 3 - før svaret sendes tilbage i trin 4. Går noget galt derefter, eller går borgeren i stå undervejs, er svaret alligevel registreret, og samtykket er dermed færdigt.
Det forventes derfor at et integrerende anvendersystem kan håndtere følgende:
-
RedirectionUrlskal være en https-adresse. Den skal besvareHEADuden bivirkninger og kunne modtage en POST på samme adresse. BådeHeadog POST kan blive forsøgt af flere omgange, og bør derfor kunne håndteres. - Før borgeren bliver sendt til Digitalt Samtykke skal man undersøge om borgeren allerede har afgivet det ønskede samtykke. Dette er for at undgå dubletter.
- Et svar betyder ikke, at der er blevet afgivet samtykke. Borgeren kan have afvist at give de ønskede samtykker. Man bør derfor altid kontrollere, at der blev afgivet de ønskede samtykker.
Datamodel
Den fulde feltliste med typer, længder og svarkoder ligger i Swagger UI under
POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters/Confirm.
Prøv det
Testklienten kan køre besvarelse og bekræftelse i forlængelse af hinanden, så hele to‑giver‑forløbet kan afprøves i ét stræk.
Åbn demoen af bekræftelse (åbner i nyt vindue)