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"
  
  Følgende oplysninger skal bruges om DitmerFlex i E-boks administrationsmodulet:
  
  

  Konfiguration	Værdi	Bemærkning
  Navn	DitmerFlex	Du kan kalde systemet, hvad du vil. Det behøver ikke at være DitmerFlex
  Leverandør af afsendersystem	Ditmer A/S
  Snitflade til afsendelse af post	System-til-system
  Afsendelsesmetode	Enkeltforsendelse
  Opslagstype	Onlineopslag
  API version	v2

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
  Bemærk ved SaaS: Denne del foretages af Ditmer, og du skal derfor sende jeres certifikat og tilhørende password til Ditmers e-Boks.
  
  
• 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
  Bemærk ved SaaS: Ditmer sender certifikatet tilbage til dig, når det er installeret på serveren.
  
  
• 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"
• Slutbrugeren er ikke tilmeldt indholdstypen
  Materialet i e-Boks administrationsportalen er ikke tilmeldt en tilmeldingsgruppe i e-Boks administrationsportalen. 
  Bemærk! Det skal både være tilknyttet en tilmeldingsgruppe der rammer private og en der rammer virksomheder, hvis både private og virksomheder skal kunne modtage Digital Post fra jer.