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.
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 |
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
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.
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
- Gå til API permissions → Add a permission → Microsoft Graph → Application permissions
- Søg og tilføj de nødvendige tilladelser
- Klik Grant admin consent — dette skal udføres af en Azure-administrator
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.
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:
- Bliv i Systemopsætning, og klik på knappen TEST SMTP.
- Udfyld:
- Afsender: en mailadresse i jeres egen Microsoft 365, fx bogholderiets
- Modtager: en ekstern mailadresse uden for jeres eget domæne, fx en privat Gmail eller Outlook.com
- Emne og Tekst: fx "Test fra KeyBalance"
- 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:
Sådan fornyes den (kræver en administrator i jeres Microsoft 365):
- I Azure-portalen: Microsoft Entra ID → App registrations → åbn appen til KeyBalance.
- Certificates & secrets → New client secret. Vælg længst mulige udløb, og klik Add.
- Kopiér Secret Value med det samme. Den vises kun én gang.
- 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.
- Test med TEST SMTP til en ekstern adresse (se ovenfor).
- 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.







