Demo- og reference-app til test af HOP-integrationen — ikke til produktion.
Brug "vis kildekode" som reference-implementation.
🔐 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):
- 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 HOP-parametre
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/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://..."
}