Opsætning af Digital Post

Formål

Dette dokument vejleder i opsætningen af Digital Post på jeres DitmerFlex installation, så I har mulighed for at sende til Digital Post.

Hvis I ønsker opsætningen af Digital Post, men det ikke er en del af jeres implementering, bedes I kontakte support@ditmerflex.dk.

Forarbejde

• For at kunne lave opsætningen til Digital Post skal I have et NemID funktionscertifikat.
  I har typisk et, som I bruger i forvejen
  
  
• Derudover skal I have lavet opsætningen af DitmerFlex i jeres E-boks administrationsmodul. I kan finde vejledning til opsætningen her: https://digst.dk/it-loesninger/digital-post/vejledninger/
  under "Tilslutningsinstruks" under "Kom i gang med Digital Post"
  
  DitmerFlex understøtter API version 2

Vejledning

Certifikater

• Installer certifikatet på serviceserveren (serveren med Jobserverservicen og WebAPI'et) i stien local machine/personal/certificates. Certifikatet skal være signeret med nøgle, og det er derfor ikke nok at hente det fra https://www.medarbejdersignatur.dk/produkter/nemid_medarbejdersignatur/information_om_nemid/sikker_e-mail/soeg_certifikat/, da certifikaterne ikke har den private nøgle
  
  
• Højreklik på certifikatet, vælg "All Tasks" og herunder "Manage Private Keys". Tilføj brugeren der kører DitmerFlexJobserver-servicen, så den har rettigheden "Full control"
  
  
• Eksporter certifikatet (som base64 krypteret .cer), uden den private nøgle
  
  
• Installer certifikatet i E-boks' administrationsmodul som certifikat for DitmerFlex afsendersystemet. Det er her vigtigt at ”private key” er fjernet, da E-boks kun vil have certifikater med offentlige nøgler
  
  
• Herefter skal certifikatets thumbprint indsættes i konfigurationen i DitmerFlex. Det gøres ved at logge på jeres DitmerFlex installation. Her skal I vælge "Systemkonfiguration" under menuen "Fælles". Under bjælken "DigitalPost" er feltet "DigitalPostThumbprint", hvor certifikatets thumbprint skal indsættes.
  Bemærk at thumbprintet ikke må indeholde mellemrum, og at hvis du kopierer det ind, så skal du fjerne et "usynligt" tegn, der kommer med over i starten eller slutningen af thumbprintet.
  
  
  
  
• Afslutningsvis skal jobserverservicen genstartes
  
  
• Bemærk: Hvis I skal forny det certifikat, I bruger til DitmerFlex, skal det først fornys, og herefter skal I følge ovenstående vejledning og slette det gamle certifikat, inden jobserverservicen genstartes
  
  

Opsætning i DitmerFlex

• I "Systemkonfiguration" under bjælken "DigitalPost" skal felterne "DigitalPostIndholdstypeId", "DigitalPostSysId" og "DigitalPostUrl" udfyldes.
  Disse felter skal udfyldes med ID'er fra jeres opsætning i E-boks administrationsportal
  
  
• Ved "DigitalPostIndholdstypeId" skal I indsætte ID'et på det materiale, som DitmerFlex er tilknyttet
  Bemærk: Et materiale i administrationsportalen til E-boks skal være tilknyttet en tilmeldingsgruppe, for at I kan sende digital post til både borgere eller virksomheder. Der er desuden forskellige tilmeldingsgrupper til borgere og virksomheder, og materialet skal være tilmeldt tilmeldingsgrupper for begge, hvis I skal kunne sende Digital Post til både borgere og virksomheder
  
  
• Ved "DigitalPostSysId" skal I indsætte ID'et på DitmerFlex som afsendersystem
  
  
  
  
• Ved "DigitalPostUrl" skal I indsætte denne URL: https://api.e-boks.com/oio/rest/srv.svc
  
  

Fejlmeddelelser

Hvis der er lavet fejl i opsætningen af integrationen kan du opleve flere forskellige fejlbeskeder, som bliver beskrevet herunder.

Certifikat ikke fundet [efterfulgt af bogstav-/talkombination på 40 karakterer]

Fejlbeskeden kan skyldes to ting:

• Der er ikke indtastet korrekt thumbprint tilhørende certifikatet
• Thumbprintet indeholder den føromtalte usynlige karakter

Fejl ved kald af Digital Post API

Efter denne fejl vises den fejlbesked, der kommer tilbage fra Digital Post API'et.

Fejlen kan skyldes flere forskellige ting, men de mest almindelige er:

• Klientcertifikatet er ikke gyldigt
  Her skyldes det, at der ikke er installeret samme certifikat både på DitmerFlex serveren og i administrationsportalen til Digital Post, eller at certifikatet ikke er installeret som base64 krypteret og uden private key i administrationsportalen til Digital Post
• Bad Request
  Skyldes som oftest, at der enten ikke er indtastet korrekte ID'er på materiale eller afsendersystem.
  Kan også skyldes, at der ikke er medsendt et CPR-nummer. Det kan du kontrollere i kolonnen "Modtager" i administrationsdelen på punktet "Udbakke"