Log ind med Microsoft (Entra ID)
Med Microsoft-login kan jeres medarbejdere logge ind i AgentBase med deres almindelige arbejdskonto. Login-siden på jeres egen adresse (fx kommune.agentbase.dk) får en knap, Log ind med Microsoft, over den sædvanlige formular.
Denne vejledning er til jeres IT-afdeling. Det tager omkring ti minutter.
Det skal I vide først
- Kun inviterede brugere kan logge ind. Microsoft-login opretter aldrig en bruger i AgentBase. En medarbejder skal først inviteres til AgentBase; første gang vedkommende logger ind med Microsoft, kobles Microsoft-kontoen til brugeren ud fra e-mailadressen. Derefter genkendes kontoen, selv om e-mailadressen senere ændres.
- Roller styres stadig i AgentBase. Hvem der er Udvikler, Administrator osv., bestemmes i AgentBase — ikke af grupper i Entra.
- Knappen vises kun på jeres egen adresse. Organisationen skal have sin egen adresse (Organisation → Branding → Platform). På
agentbase.dkændrer intet sig. - Login-link og adgangskode virker fortsat ved siden af Microsoft-login — medmindre I slår Kræv login med Microsoft til (se nedenfor).
- Spærrer I en bruger i Entra, mister vedkommende adgangen til AgentBase senest 12 timer efter sit seneste Microsoft-login. Fjern også brugeren i AgentBase, hvis adgangen skal lukke med det samme.
1. Opret en app-registrering
-
Log ind i Microsoft Entra admin center som administrator.
-
Gå til Applications → App registrations → New registration.
-
Giv den et navn, fx
AgentBase. -
Under Supported account types vælger I Accounts in this organizational directory only.
-
Under Redirect URI vælger I platformen Web og indsætter den adresse, AgentBase viser i opsætningsguiden på kortet Microsoft Entra ID (log ind) under Organisation → Integrationer. For AgentBase i drift er den:
https://api.agentbase.dk/api/v1/auth/entra/callback -
Klik Register.
App-registreringen behøver ingen API-tilladelser ud over standardtilladelsen User.Read.
2. Opret en hemmelighed
- Åbn app-registreringen, og gå til Certificates & secrets → Client secrets → New client secret.
- Vælg en udløbsperiode, og klik Add.
- Kopiér Value med det samme — den vises kun én gang.
- Skriv udløbsdatoen i jeres kalender. Når hemmeligheden udløber, kan ingen logge ind med Microsoft, før I har oprettet en ny og indsat den i AgentBase. Forny den et par uger før.
3. Indsæt værdierne i AgentBase
- Log ind i AgentBase som administrator, og gå til Organisation → Integrationer.
- Klik Konfigurer på kortet Microsoft Entra ID (log ind).
- Udfyld:
- Directory (tenant) ID — fra app-registreringens Overview. Det er et GUID som
1b2c3d4e-…, ikke et domænenavn. - Application (client) ID — også fra Overview.
- Hemmelighed (client secret) — den Value, I kopierede i trin 2.
- Directory (tenant) ID — fra app-registreringens Overview. Det er et GUID som
- Gem.
Hemmeligheden gemmes krypteret og vises aldrig igen. Microsoft-login gælder hele organisationen og kan ikke sættes op pr. team.
4. Test forbindelsen
Klik Test forbindelse på kortet. AgentBase beder Microsoft om et token med app-registreringens oplysninger; går det godt, er tenant ID, client ID og hemmelighed rigtige.
Prøv derefter selv: Åbn jeres login-side (fx https://kommune.agentbase.dk/login), klik Log ind med Microsoft, og log ind med en konto, der er inviteret til AgentBase.
5. Kræv login med Microsoft (valgfrit)
Vil I have, at Microsoft er den eneste vej ind, slår en administrator Kræv login med Microsoft til på kortet Microsoft Entra ID (log ind). Kontakten vises, når kortet er sat op.
For at slå den til skal I selv være logget ind med Microsoft lige nu — så ved vi, at login virker, før de andre veje lukkes. Log ud, og log ind igen med Log ind med Microsoft på organisationens login-side, hvis kontakten er grå.
Når kravet er slået til:
- Login-link og adgangskode virker ikke for organisationens medarbejdere. Beder en medarbejder om et login-link, får vedkommende i stedet en e-mail, der peger på organisationens login-side.
- Login-siden viser kun knappen Log ind med Microsoft på jeres egen adresse.
- Igangværende sessioner afsluttes. En medarbejder, der er logget ind med login-link eller adgangskode, sendes til login-siden ved næste klik (senest et halvt minut efter, I slog kravet til).
- Forbindelser til ChatGPT og Claude skal godkendes igen. Eksisterende forbindelser afbrydes; godkendelsen sker derefter gennem Microsoft. En adgangsnøgle, der allerede er udstedt, udløber af sig selv inden for kort tid.
- API-nøgler, webhooks og indlejrede apps påvirkes ikke — de er ikke et login.
- Der er ingen nødindgang for medarbejdere. Udløber hemmeligheden, eller holder Microsoft-login op med at virke, kan ingen i organisationen logge ind, før I har rettet kortet. Kontakt syv.ai-support, hvis I er låst ude — syv.ai's egne supportkonti logger ind med login-link og kan slå kravet fra.
Kravet slås fra igen med samme kontakt. Fjerner I kortet Microsoft Entra ID (log ind), slås kravet også fra, og login-link virker igen.
Fejlsøgning
Går noget galt, vender medarbejderen tilbage til login-siden med en af disse beskeder:
| Besked | Hvad det betyder |
|---|---|
| Login med Microsoft blev afbrudt. Prøv igen, eller log ind herunder. | Medarbejderen trykkede annuller eller afviste samtykket hos Microsoft. |
| Login-forsøget udløb. Prøv igen. | Der gik mere end ti minutter, eller login blev startet i en anden fane eller browser. Start forfra fra login-siden. |
| Din Microsoft-konto er ikke knyttet til en bruger i AgentBase. Bed en administrator om en invitation. | Der findes ingen aktiv AgentBase-bruger i organisationen med Microsoft-kontoens e-mailadresse. Invitér medarbejderen, eller ret e-mailadressen i AgentBase, så den passer. |
| Brugerkontoen er ikke aktiv. Kontakt en administrator i din organisation. | AgentBase-brugeren er deaktiveret. En administrator kan genaktivere den under Organisation → Brugere. |
| Denne konto kan ikke logge ind med Microsoft. Brug login-linket. | Kontoen har en særlig rolle, der kun kan logge ind med login-link. |
| Din organisation kræver login med Microsoft. Log ind med Microsoft for at fortsætte. | Organisationen har slået Kræv login med Microsoft til, og medarbejderens session var startet på en anden måde. Log ind med Microsoft. |
| Login med Microsoft mislykkedes. Prøv igen, eller kontakt din administrator. | Microsoft-login er ikke sat op (eller ikke længere sat op), hemmeligheden er udløbet, eller Microsoft svarede uventet. Kør Test forbindelse på kortet — beskeden dér siger, hvad der er galt. |
Ingen knap på login-siden? Kontrollér, at I bruger organisationens egen adresse (ikke agentbase.dk), at alle tre felter er udfyldt på kortet, og at organisationen har en adresse under Branding → Platform.