🔐 HOP-integration med Digitalt Samtykke

📋 Om denne integration

Dette er en proof of concept til at demonstrere, hvordan jeres fagsystem kan integrere med Digitalt Samtykke's HOP (Hop Over Proxy) endpoint.

Integrationen gør det muligt for jeres system at:

  • Automatisk oprette samtykke-anmodninger uden medarbejder intervention
  • Dirigere borgere direkte til samtykke-processen
  • Modtage sikre callbacks med samtykke-resultater

🔐 Sikkerhedsarkitektur - JWS og JWE

Integrationen anvender to-lags sikkerhed:

1. JWS (JSON Web Signature)
  • Signerer data med jeres OCES3 private nøgle
  • Beviser dataens integritet og autenticitet
  • Inkluderer jeres offentlige certifikat
  • Vi verificerer mod trusted certifikat liste
2. JWE (JSON Web Encryption)
  • Krypterer hele payload med vores offentlige nøgle
  • Sikrer data confidentialitet under transport
  • Kun vi kan dekryptere med vores private nøgle
  • Bruger RSA-OAEP + AES-256-GCM
📜 Certifikat krav

Jeres certifikat (til signering):

  • Skal være et gyldigt OCES3 certifikat
  • Skal være registreret i vores admin interface
  • Offentlige del sendes med hver request
  • Private nøgle bruges kun til signering (opbevares sikkert!)

Vores certifikat (til kryptering):

🔄 Integration proces

1
Udfyld Data

Indtast samtykke parametre og konverter til JSON

2
Signer (JWS)

Signer data med jeres private OCES3 nøgle

3
Krypter (JWE)

Krypter payload med vores offentlige nøgle

4
Send Request

POST til HOP-endpoint og modtag redirect

1Udfyld Samtykke Data

Vælg hvilket miljø I ønsker at teste mod
8-cifret CVR nummer for jeres myndighed
Jeres lokale reference til at identificere denne samtykke-anmodning
UUID fra ErklaeringSkabelon/@erklaeringSkabelonUUID
UUID fra ErklaeringSkabelon/Afsendere/Afsender/@afsenderUUID
Sagsnummer fra jeres fagsystem
CPR-nummer på subjekt (10 cifre)
CPR på person der skal give samtykke
Anden samtykke-giver (hvis begge forældre skal give samtykke)
Udvalg af skabelonens trin. Udelades feltet, medtages alle trin. Pr. trin: udeladte GrantOptions medtager alle valgmuligheder, og udeladte AdditionalChoices medtager alle valgfrie yderligere valg, mens en tom liste medtager ingen valgfrie. Obligatoriske yderligere valg medtages altid.
HTTPS URL hvor borgeren sendes tilbage efter samtykke-proces

Skift af miljø opdaterer disse felter. Du kan derefter overskrive manuelt. Privat nøgle må kun bruges her i test.

Hentes fra: https://<miljø>.dk/certifikater
Udregnes af certifikatet ovenfor: base64url af SHA-256-digesten over certifikatets DER-bytes (RFC 7515 §4.1.8). Overskriv kun for at se hvad der sker, når referencen ikke matcher modtagerens certifikat.
Må ikke indlejres i produktion

🔐 Sikkerhedsbehandling og Afsendelse

Dette felt viser payload gennem de forskellige behandlingstrin
💡 Sådan fungerer det:
1. Udfyld data og klik "Generer JSON" for at aktivere trin 2
2. Signer med JWS for at bevise autenticitet
3. Krypter med JWE for at sikre fortrolighed
4. Send til endpoint og få redirect til samtykke-proces
Bemærk: Ændrer du sikkerhedsværdier eller miljø skal du starte fra trin 1 igen.

Endpoint URL struktur:
POST {miljø}/api/Integration/{cvr}/SignedConsentResponseParameters
Content-Type:
application/x-www-form-urlencoded
Request Body:
Body={JWE_ENCRYPTED_PAYLOAD}
JWE Payload indeholder JWS struktur:
{
  "jws": "eyJhbGc...", 
  "certificate": "-----BEGIN CERTIFICATE-----..."
}
JWS Payload indeholder samtykke data:
{
  "ConsentDeclarationTemplateId": "uuid",
  "RequesterId": "uuid",
  "SubjectCpr": "0000000000",
  "Consenter1Cpr": "0000000000",
  "RedirectionUrl": "https://...",
  // + andre felter
}