Bekræft en anmodning

HOP-integration - Digitalt Samtykke

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.1 Saml parametrene som JSON. Ét JSON-dokument med de parametre, anmodningen skal oprettes ud fra.
  2. 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.
  3. 1.3 Pak JWS og certifikat i en envelope. Et JSON-objekt med jws og certificate, hvor certifikatet er den offentlige del af det, der lige har signeret, i PEM-format.
  4. 1.4 Kryptér envelopen som JWE. Kryptér den til Digitalt Samtykkes systemcertifikat (RSA-OAEP + A256GCM). Headeren skal bære x5t#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.

  1. 4.1 Kontrollér at modtageren svarer. Digitalt Samtykke laver et HEAD-kald til RedirectionUrl fra sin egen server. Svarer den ikke, sendes borgeren ikke af sted, men får en "prøv igen" i stedet.
  2. 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.
  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:

  • RedirectionUrl skal være en https-adresse. Den skal besvare HEAD uden bivirkninger og kunne modtage en POST på samme adresse. Både Head og 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.

Åbn kontrakten i Swagger UI

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)