Overblik

Denne guide beskriver, hvordan du som IT-administrator klargør og installerer DPG Outlook Office Add-in til det nye Outlook. 


Processen er opdelt i to faser:

  1. Klargøring — opret en App-registrering i Azure (Microsoft Entra ID), så Add-in kan benytte Single Sign-On (SSO) via OAuth 2.0.
  2. Installation — hent manifest-filen fra DPG kundeportal og udrul Add-in via Microsoft 365 Admin Center.
⚠️ Vigtigt: Gennemfør klargøringen (fase 1) og overdrag oplysningerne til Timengo DPG, inden du installerer Add-in (fase 2). Begge dele er nødvendige, for at Add-in fungerer korrekt.

Forudsætninger

Inden du går i gang, skal følgende være på plads:

  • Du har adgang til Azure Portal som Global Administrator eller Application Administrator.
  • Du har adgang til Microsoft 365 Admin Center som tenant-administrator.
  • Du har adgang til DPG kundeportal.
  • DPG Servicen er konfigureret (se separat vejledning: Klargøring til DPG Service).

Fase 1: Klargøring — App-registrering i Azure

DPG Outlook Office Add-in kræver en Registered Application i Azure, som håndterer SSO via OAuth 2.0. Du kan gennemføre dette enten automatisk med et PowerShell-script eller manuelt trin for trin.

? Ny eller eksisterende kunde?
Nye kunder: Denne app-registrering oprettes normalt som del af den indledende klargøring af DPG.
Eksisterende kunder: Hvis du ikke tidligere har konfigureret den nye DPG Outlook Office Add-in, skal du gennemføre nedenstående trin. Foretag efterfølgende ikke ændringer i app-registreringen uden instruktion fra Timengo DPG Support.

Mulighed A: Automatisk opsætning med PowerShell (anbefales)

Download og kør følgende PowerShell-script, som automatisk opretter og konfigurerer App-registreringen:


Download: Create-DPGAppRegistration.ps1 (zip)


Scriptet håndterer alle manuelle trin inkl. rettigheder og admin consent. Outputtet gemmes i filen DPGOfficeAddin-TechnicalDetails.txt i samme mappe som scriptet.

Scriptet kræver modulerne Microsoft.Graph og Az.Accounts som installeres automatisk, hvis de ikke er til stede.

Overdragelse til Timengo DPG

Når konfigurationen er gennemført, skal du overdrage følgende oplysninger til Timengo DPG som angivet i velkomstbrevet:


OplysningEksempel
Application (client) IDxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Directory (tenant) IDxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Mulighed B: Manuel konfiguration i Azure (trin-for-trin)

⚠️ Gennemfør hvert trin i den angivne rækkefølge.

Trin 1: Opret ny app-registrering

  1. Log ind på Azure Portal som administrator.
  2. Gå til Microsoft Entra ID → App registrations → New registration.
  3. Udfyld følgende felter:
    • Name:DPG Office Add-in (dpgofficeaddin.dpgapi.dk)
    • Supported account types:Accounts in this organization directory only (Single tenant)
    • Redirect URI: Vælg Single-page application (SPA), og angiv værdien https://dpgofficeaddin.dpgapi.dk
  4. Vælg Register.

Trin 2: Notér Application- og Directory-ID

I sektionen Overview noterer du:

  • Application (client) ID
  • Directory (tenant) ID
? Disse to værdier skal efterfølgende overdrages til Timengo DPG.

Trin 3: Angiv Application ID URI

  1. Gå til Expose an API → Add.
  2. Opdatér Application ID URI til:
    api://dpgofficeaddin.dpgapi.dk/<Application (client) ID>
  3. Vælg Save.

Trin 4: Tilføj scope

  1. Vælg Add a scope i panelet Expose an API.
  2. Udfyld felterne:
    • Scope name:Authenticated
    • Who can consent:Admins and users
    • Admin consent display name:Authenticated
    • Admin consent description:Authenticated
    • State:Enabled
  3. Vælg Add scope.

Trin 5: Forhåndsgodkend Microsoft Office

  1. Vælg Add a client application i panelet Expose an API.
  2. Indsæt client ID: ea5a67f6-b6f3-4338-b240-c655ddc3cc8e
    (Dette forhåndsgodkender alle Microsoft Office Application-endpoints.)
  3. Markér feltet Authorized scopes (det scope du oprettede i trin 4).
  4. Vælg Add application.

Trin 6: Tilføj API-rettigheder (Microsoft Graph)

  1. Gå til API permissions → Add a permission → Microsoft Graph → Delegated permissions.
  2. Søg og markér følgende rettigheder:
    • email
    • openid
    • profile
    • Mail.Read
    • Mail.Send
    • Mail.Read.Shared
    • Mail.Send.Shared
    • User.Read
  3. Vælg Add permissions.

Trin 7: Giv admin consent

  1. I panelet Configured permissions vælger du Grant admin consent for [din organisation].
  2. Bekræft ved at vælge Yes.
  3. Kontrollér, at alle rettigheder i listen vises med grøn markering.

Trin 8: Opdatér manifest

  1. Gå til Manifest.
  2. Find linjen med "accessTokenAcceptedVersion", og ændr værdien fra null til 2.
  3. Vælg Save.

Trin 9: Tilføj ekstra Redirect URI

  1. Gå til Authentication → sektionen Single-page application Redirect URIs.
  2. Vælg Add URI, og tilføj: brk-multihub://dpgofficeaddin.dpgapi.dk
  3. Vælg Save.

Overdragelse til Timengo DPG

Når konfigurationen er gennemført, skal du overdrage følgende oplysninger til Timengo DPG som angivet i velkomstbrevet:


OplysningEksempel
Application (client) IDxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Directory (tenant) IDxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
⚠️ Foretag ikke ændringer i app-registreringen efter overdragelsen, medmindre Timengo DPG Support eksplicit beder dig om det.

Fase 2: Installation af Add-in via Microsoft 365 Admin Center

Installationen foregår i to dele: Test deployment til udvalgte superbrugere, og derefter Release deployment til hele organisationen. Vi anbefaler stærkt denne to-trins-fremgangsmåde.

⚠️ Det er afgørende, at hver bruger/brugerprofil kun har ét Add-in installeret.

Trin 1: Hent manifest-filer

  1. Log ind på DPG kundeportal.
  2. Åbn siden Download & Install.
  3. Hent begge manifest-filer:
    • Test deployment-manifest — f.eks. manifest_DPG_testdeployment_3.0.1193.1.xml
    • Release-manifest — f.eks. manifest_DPG_3.0.1193.1.xml
Manifest-filerne er tilpasset din organisation og fungerer uden videre.

Trin 2: Installér Test deployment-versionen

  1. Gå til Microsoft 365 Admin Center → Settings → Integrated apps.
  2. Vælg Upload custom apps.
  3. Sæt App type til Office Add-in.
  4. Vælg Upload manifest file (.xml) from device.
  5. Vælg Choose file, og udpeg test deployment-manifestet.
  6. Verificér, at manifestet valideres uden fejl, og vælg Næste.
  7. Angiv testbrugere (de superbrugere der skal verificere Add-in), og vælg Næste.
  8. Vælg Accept permissions → Næste → Accept.
  9. Vælg Finish deployment → Done.
Lad testbrugerne verificere, at Add-in fungerer korrekt, inden du fortsætter til trin 3.

Trin 3: Installér Release-versionen til alle brugere

Når testbrugerne har godkendt funktionaliteten, gentages installationsproceduren fra trin 2 — men denne gang vælges release-manifestet (IKKE test deployment-versionen), og du angiver de ønskede brugere eller hele organisationen.


Validering — sådan ved du, at det virker

  • Add-in vises i Outlook under tilføjelsesprogrammer.
  • Brugeren kan logge ind med SSO uden manuel indtastning af adgangskode.
  • Knappen Send sikker post er tilgængelig i Outlook.
⏱️ Bemærk: Det kan tage op til 24 timer, inden Add-in vises i Outlook ved nye installationer. Vi anbefaler at installere om fredagen, så Add-in er klar til mandag morgen.

Opdatering af eksisterende installation

  1. Gå til Settings → Integrated apps, og filtrer på DPG.
  2. Vælg DPG-udgaven markeret som Test deployment.
  3. Vælg Update add-in, upload det nye test-manifest, og vælg Access and update.
  4. Lad testbrugerne verificere den nye version.
  5. Gentag for release-versionen (den, der IKKE er markeret som Test deployment).
⏱️ Opdateringer kan tage op til 72 timer at slå igennem i Outlook for eksisterende brugere.

Fejlsøgning


ProblemMulig årsagLøsning
Add-in vises ikke i OutlookUdrulning ikke færdig endnuVent op til 24 timer. Prøv at genstarte Outlook.
"DPG er endnu ikke klar" ved afsendelseAdd-in ikke indlæst færdigVent 10–20 sekunder efter åbning af Outlook, inden du sender.
To ukendte App-registreringer med navn "DPG secure communication"Automatisk oprettet af AzureDisse er normale. Azure opretter dem, når brugere tilføjes. De slettes automatisk ved afinstallation.
SSO virker ikkeApp-registrering ikke korrekt konfigureretVerificér, at Application (client) ID og Directory (tenant) ID er overdraget korrekt til Timengo DPG.
Manifest-validering fejler ved uploadForkert manifest-fil valgtTjek, om du har hentet den rigtige fil fra DPG kundeportal (test vs. release)


Ofte stillede spørgsmål

Kan vi bruge en anden deployment-metode end Fixed?


Vi anbefaler Fixed (standardvalget). Det sikrer automatisk udrulning, inkl. til delte postkasser. Metoderne Available og Optional understøttes teknisk, men giver ikke automatisk udrulning til fælles/delte postkasser.


Kan Add-in installeres med "sideloading" i stedet?


Ja, men det anbefales ikke. Sideloading kræver, at hver enkelt bruger selv håndterer installation og opdatering, og giver ingen central kontrol over versionsstyring.


Hvad med den gamle DPG Outlook Office Add-in v2.2?


V2.2 anbefales ikke længere. Manifest-filen kan undtagelsesvis hentes via URL-format:
https://[HOSTNAME]/api/addin/[CUSTOMERID]/manifest/v2.2

Brug for hjælp?

Kan du ikke løse problemet med denne guide? Opret en supportsag hos Timengo DPG Support:
servicecenter.sikker-post.dk