Gå til indholdet

Graph app opsætning (Azure App Registration)

En Azure App Registration (Graph app) er nødvendig i to situationer:

Brug Kræver Graph app
Azure AD / EntraID login (basis) Nej — brugeren godkender blot første gang
Udgående mails via Microsoft Graph Ja
EntraID Styret (brugere/grupper styres i EntraID) Ja

Denne guide beskriver, hvordan App-registreringen oprettes og konfigureres i Azure-portalen, og hvor værdierne sættes ind i KeyBalance.


Opret App Registration i Azure

1. Log ind på Azure-portalen

Gå til portal.azure.com og log ind med en konto med administratorrettigheder.

2. Åbn App registrations

Søg efter App registrations i søgefeltet øverst, eller find det under Microsoft Entra ID → App registrations.

3. Registrér ny app

Klik New registration og udfyld:

  • Name: fx KeyBalance
  • Supported account types: Accounts in this organizational directory only (Single tenant)
  • Redirect URI: kan sættes til https://keybalance.dk — værdien har ingen praktisk betydning

Klik Register.

Registrer ny application dialog i Azure

4. Gem Tenant ID og Application ID

Fra oversigtssiden kopieres:

Felt Hvor i Azure
Application (client) ID Vist direkte på oversigtssiden
Directory (tenant) ID Vist direkte på oversigtssiden

Application overview med Tenant ID og Application ID

Begge værdier indsættes i KeyBalance under SYSTEMOPSÆTNING → KeyBalance Application (se Azure AD / EntraID login — Opsætning).

5. Opret Client Secret

Gå til Certificates & secrets → New client secret:

  • Sæt udløbstid til maksimum (typisk 24 måneder)
  • Klik Add
  • Kopiér Secret Value med det samme — den vises kun én gang

Opret ny client secret dialog

Husk at forny: Client secrets udløber. Notér udløbsdatoen og planlæg fornyelse i god tid — udløbet secret stopper mail-afsendelse og EntraID Styret-funktionalitet.

Client secret value og ID visning


API Permissions

Hvilke tilladelser der er nødvendige afhænger af, hvad Graph-appen bruges til:

Tilladelse Type Bruges til
Mail.Send Application Udgående mails via Microsoft Graph
User.Read.All Application EntraID Styret — aflæsning af brugere/grupper

Tilføj tilladelser

  1. Gå til API permissions → Add a permission → Microsoft Graph → Application permissions
  2. Søg og tilføj de nødvendige tilladelser
  3. Klik Grant admin consent — dette skal udføres af en Azure-administrator

API permissions oversigt med Grant admin consent

Tilføj Mail.Send permission dialog

Grant admin consent knap for permissions

Tilladelser af typen Application kræver altid Admin consent — de kan ikke godkendes af den enkelte bruger.


Indsæt værdier i KeyBalance

Åbn Systemopsætning: fanen Værktøjer → knappen Værktøj → System → Systemopsætning.

Menuvejen til Systemopsætning: Værktøjer → Værktøj → System → Systemopsætning

Udfyld under KeyBalance Application:

Felt i KeyBalance Værdi fra Azure
Application ID Application (client) ID
Secret Value Client secret — Value (ikke Secret ID)
TenantID Directory (tenant) ID

Har I flere regnskaber? Systemopsætningen er pr. regnskab. Værdierne skal indsættes i hvert regnskab, der sender mails.


Test altid efter en ændring

Når værdierne er indsat eller ændret, skal I teste, at der faktisk kan sendes:

  1. Bliv i Systemopsætning, og klik på knappen TEST SMTP.
  2. Udfyld:
  3. Afsender: en mailadresse i jeres egen Microsoft 365, fx bogholderiets
  4. Modtager: en ekstern mailadresse uden for jeres eget domæne, fx en privat Gmail eller Outlook.com
  5. Emne og Tekst: fx "Test fra KeyBalance"
  6. Send, og tjek at mailen er kommet frem hos den eksterne modtager. Tjek også spam.

Hvorfor ekstern? En mail til en kollega i samme Microsoft 365 viser ikke, om mails faktisk kommer ud af huset til jeres kunder og leverandører. Først når en ekstern adresse har modtaget testen, ved I, at fakturaer, rykkere og ordrebekræftelser også når frem.

Kommer testmailen ikke frem, eller giver den en fejl, så kontakt KeyBalance support med fejlteksten.


Når mails pludselig stopper: forny client secret

En client secret udløber (typisk efter 6–24 måneder). Herefter afviser Microsoft KeyBalances login, og alle mails, som KeyBalance sender via Microsoft 365, fejler, fx fakturaer, rykkere, godkendelser og kørsler, der sendes automatisk. Fejlen ser typisk sådan ud:

Fejl MailAfsendelse(O365) ... ClientSecretCredential authentication failed

Sådan fornyes den (kræver en administrator i jeres Microsoft 365):

  1. I Azure-portalen: Microsoft Entra ID → App registrations → åbn appen til KeyBalance.
  2. Certificates & secrets → New client secret. Vælg længst mulige udløb, og klik Add.
  3. Kopiér Secret Value med det samme. Den vises kun én gang.
  4. I KeyBalance: åbn Systemopsætning (se ovenfor), og indsæt den nye værdi i Secret Value under KeyBalance Application. Gør det i alle regnskaber.
  5. Test med TEST SMTP til en ekstern adresse (se ovenfor).
  6. Notér den nye udløbsdato, og sæt en påmindelse et par uger før.

Mails, der fejlede i perioden, bliver ikke sendt automatisk igen. De skal sendes igen manuelt, eller kørslen skal køres igen.

Application ID og TenantID ændres ikke ved fornyelse. Kun Secret Value skal skiftes.


Relaterede guides