🔐 HOP-integration - Bekræft afgivelse af samtykke

📋 Om denne integration

Dette er en proof of concept til at demonstrere, hvordan jeres fagsystem kan integrere med Digitalt Samtykke's HOP-integration.

Integrationen gør det muligt for jeres system at:

  • Dirigere borgere direkte til bekræft af 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 HOP-parametre

Vælg hvilket miljø I ønsker at teste mod
8-cifret CVR nummer for jeres myndighed
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/confirm
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:
{
                                    "ConsentDeclarationRequestId": "uuid",
                                    "TenantCvr": "00000000",
                                    "RedirectionUrl": "https://..."
                                    }