Demo- og reference-app til test af HOP-integrationen — ikke til produktion.
Brug "vis kildekode" som reference-implementation.
🔐 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):
- Hentes fra:
https://<miljø>.dk/certifikater - Preprod: https://web-pp-digitaltsamtykke.digst2.govcloud.dk/certifikater
- Prod: https://samtykke.borger.dk/certifikater
- Skal opdateres når vi udskifter certifikater
🔄 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
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
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
}