Single Sign-On Oversigt¶

Indholdsfortegnelse¶

1. Introduktion og oversigt
2. Udbydervejledninger
3. Konfigurationstrin
4. Dashboard-konfiguration
5. Backend-konfiguration
6. Test af login
7. Fejlfinding
8. Understøttede udbydere

Introduktion og oversigt¶

Denne vejledning giver trin-for-trin instruktioner til at integrere Single Sign-On (SSO) med digna-platformen ved hjælp af OpenID Connect (OIDC).

Hvad er SSO?¶

Single Sign-On giver brugere mulighed for at logge sikkert ind på digna ved at bruge deres virksomhedslegitimationsoplysninger gennem eksterne identitetsudbydere. Brugere kan godkende med deres virksomhedsoplysninger i stedet for at administrere separate digna-adgangskoder.

Hvordan det virker¶

SSO i digna er implementeret ved hjælp af OIDC-protokollen. Flere identitetsudbydere kan konfigureres parallelt ved at justere to nøglekonfigurationsfiler:

• dashboard_config.toml — Styrer frontend-logingrænsefladen
• config.toml — Konfigurerer backend OIDC-forbindelser

Understøttede udbydere¶

Eksempler i denne vejledning bruger Microsoft og Google, men enhver OIDC-kompatibel udbyder kan integreres ved at følge samme struktur.

Udbydervejledninger¶

Hver udbyder har brug for de samme fire værdier — en client ID, en client secret, en redirect URI og en discovery URL — men hver enkelt placerer dem forskellige steder i sin administrationskonsol, og flere har et udbyderspecifikt trin, som de andre ikke har. Vejledningerne nedenfor dækker den del af arbejdet; denne side dækker digna-delen, som er identisk for alle.

Enhver anden OIDC-kompatibel udbyder fungerer på samme måde — se Andre OIDC-udbydere.

Konfigurationstrin¶

SSO-konfiguration kræver opdateringer til to filer. Dette afsnit forklarer, hvordan hver enkelt konfigureres.

Oversigt over konfigurationsfiler¶

Begge filer skal konfigureres for at SSO fungerer korrekt.

Dashboard-konfiguration¶

Filplacering¶

dashboard/dashboard_config.toml

Trin 1: Tilføj OIDC-udbydere¶

Tilføj poster under [[login.oidc]]-arrayet for hver identitetsudbyder, du vil understøtte.

Eksempel med Microsoft og Google:

[[login.oidc]]
key = "microsoft"
label = "Login with Microsoft"

[[login.oidc]]
key = "google"
label = "Login with Google"

Trin 2: Konfigurer loginmuligheder¶

Angiv, om login baseret på adgangskode skal være tilladt:

[login]
usePassword = true

Konfigurationsparametre¶

[[login.oidc]]-sektionen¶

[login]-sektionen¶

Forstå usePassword¶

Hvis usePassword = true: - Login-skærmen viser SSO-knapper (f.eks. "Login with Microsoft") - Login-skærmen viser også brugernavn- og adgangskodefelter - Brugere kan godkende med enten metode - Giver hybride opsætninger, hvor nogle brugere bruger SSO og andre bruger adgangskoder

Hvis usePassword = false (eller udeladt): - Login-skærmen viser kun SSO-knapper - Ingen brugernavn-/adgangskodefelter - Kun OIDC-godkendelse er tilgængelig

Færdigt eksempel¶

[login]
usePassword = true

[[login.oidc]]
key = "microsoft"
label = "Login with Microsoft"

[[login.oidc]]
key = "google"
label = "Login with Google"

[[login.oidc]]
key = "okta"
label = "Login with Okta"

Backend-konfiguration¶

Filplacering¶

/config.toml

(Rodmappen for digna-installationen)

Trin 1: Tilføj OIDC-udbydersektioner¶

Hver udbyder skal have en dedikeret [oidc.<key>]-sektion. Key'en skal matche key defineret i dashboard_config.toml.

Microsoft-konfiguration¶

[oidc.microsoft]
DIGNA_OIDC_CLIENT_ID = "<client_id>"
DIGNA_OIDC_CLIENT_SECRET = "<client_secret>"
DIGNA_OIDC_REDIRECT_URI = "http://localhost:5173/oidc/callback"
DIGNA_OIDC_CONFIGURATION_URL = "https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration"

Google-konfiguration¶

[oidc.google]
DIGNA_OIDC_CLIENT_ID = "<client_id>"
DIGNA_OIDC_CLIENT_SECRET = "<client_secret>"
DIGNA_OIDC_REDIRECT_URI = "http://localhost:5173/oidc/callback"
DIGNA_OIDC_CONFIGURATION_URL = "https://accounts.google.com/.well-known/openid-configuration"

Konfigurationsparametre¶

Redirect URI¶

Redirect URI skal være den samme i din identitetsudbyderkonfiguration:

http://localhost:5173/oidc/callback

Hvis digna hostes på et andet domæne, opdater tilsvarende: - Lokalt: http://localhost:5173/oidc/callback - Produktion: https://digna.yourdomain.com/oidc/callback

Færdigt eksempel¶

[oidc.microsoft]
DIGNA_OIDC_CLIENT_ID = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
DIGNA_OIDC_CLIENT_SECRET = "abc123xyz789def456ghi"
DIGNA_OIDC_REDIRECT_URI = "https://digna.yourdomain.com/oidc/callback"
DIGNA_OIDC_CONFIGURATION_URL = "https://login.microsoftonline.com/12345678-1234-1234-1234-123456789012/v2.0/.well-known/openid-configuration"

[oidc.google]
DIGNA_OIDC_CLIENT_ID = "123456789-abcdefghijklmnopqrstuvwxyz.apps.googleusercontent.com"
DIGNA_OIDC_CLIENT_SECRET = "google_secret_xyz789"
DIGNA_OIDC_REDIRECT_URI = "https://digna.yourdomain.com/oidc/callback"
DIGNA_OIDC_CONFIGURATION_URL = "https://accounts.google.com/.well-known/openid-configuration"

Test af login¶

Efter at have gennemført konfigurationen, bekræft at SSO fungerer korrekt.

Tjekliste før test¶

Før test, sørg for:

• dashboard_config.toml er opdateret med OIDC-udbydere
• config.toml er opdateret med OIDC-legitimationsoplysninger
• Begge filer er gemt
• Legitimationsoplysninger er korrekte (client ID, client secret)
• Redirect URI matcher din deployment-URL
• Identitetsudbyder-applikationen er konfigureret med redirect URI

Testtrin¶

Trin 1: Genstart tjenester¶

Genstart digna-backend og webserver for at anvende ændringerne.

Hvis kørt som service på Windows:

cd C:\path\to\digna\bin
stop_service.bat
start_service.bat

Hvis kørt som service på Linux eller macOS:

cd /opt/digna/bin
sudo ./stop_service.sh
sudo ./start_service.sh

Hvis kørt manuelt:

digna serve --address localhost --port 8082

Genstart også webserveren — IIS eller Tomcat på Windows, nginx eller Apache på Linux og macOS.

Trin 2: Åbn dashboard¶

Åbn digna-dashboardet i din browser:

http://localhost:5173

(eller din konfigurerede dashboard-URL)

Trin 3: Bekræft loginknapper¶

Kontroller, at loginknapper vises for hver konfigureret udbyder:

• Du bør se "Login with Microsoft"-knappen
• Du bør se "Login with Google"-knappen
• (Hvis usePassword = true) Du bør se brugernavn-/adgangskodefelter

Hvis knapper ikke vises: - Tjek at dashboard_config.toml blev gemt - Tjek at dashboard-tjenesten blev genstartet - Tjek browserkonsollen (F12) for fejl

Trin 4: Test SSO-login¶

Klik på en af SSO-knapperne (f.eks. "Login with Microsoft"):

1. Du bør blive omdirigeret til identitetsudbyderens login-side
2. Log ind med dine virksomhedslegitimationsoplysninger
3. Du bør blive omdirigeret tilbage til digna
4. Du bør være logget ind i digna

Trin 5: Bekræft brugeroprettelse¶

Efter succesfuldt SSO-login:

• Brugeren bør blive oprettet automatisk i digna
• Brugeren bør være logget ind
• Brugerprofilen bør vise dine identitetsudbyderoplysninger
• Du bør se digna-dashboardet

Trin 6: Test login med adgangskode (hvis aktiveret)¶

Hvis usePassword = true:

1. Log ud af digna
2. På login-siden indtast et brugernavn og en adgangskode
3. Du bør kunne logge ind med adgangskodelegitimationsoplysninger

Fejlfinding¶

Loginknapper vises ikke¶

Symptomer: - OIDC-loginknapper vises ikke på login-siden - Ser kun adgangskodefelter (hvis usePassword = true)

Årsager og løsninger: 1. Tjek at dashboard_config.toml er i dashboard/-biblioteket 2. Verificer at [[login.oidc]]-sektionerne er til stede med korrekt syntaks 3. Genstart dashboard-tjenesten 4. Ryd browsercache (Ctrl+Shift+Delete eller Cmd+Shift+Delete) 5. Tjek browserkonsollen (F12 → Console-fanen) for fejl

Fejl ved mismatch af Redirect URI¶

Symptomer: - Efter klik på SSO-knappen, fejl om "redirect_uri mismatch" - "The redirect URI is not registered" fejl

Årsager og løsninger: 1. Verificer DIGNA_OIDC_REDIRECT_URI i config.toml er korrekt 2. Verificer at redirect URI er registreret i identitetsudbyderens indstillinger 3. Sørg for, at begge bruger identiske URL'er (inkl. protokol, domæne, sti) 4. Tjek for stavefejl i redirect URI 5. Hvis du bruger HTTPS, sørg for at certifikatet er gyldigt

Ugyldige klientlegitimationsoplysninger¶

Symptomer: - "Invalid client ID or secret" fejl - Godkendelse fejler med legitimationsfejl

Årsager og løsninger: 1. Verificer DIGNA_OIDC_CLIENT_ID og DIGNA_OIDC_CLIENT_SECRET er korrekte 2. Sørg for ingen ekstra mellemrum eller specialtegn 3. Tjek at legitimationsoplysninger ikke er udløbet eller tilbagekaldt 4. Genstart backend-tjenesten efter opdatering af config 5. Tjek identitetsudbyderens konsol for at bekræfte at legitimationsoplysningerne er aktive

Login hænger eller timeouter¶

Symptomer: - Klik på SSO-knappen sker intet - Timeout efter flere sekunder - Browser viser "Failed to connect" eller lignende

Årsager og løsninger: 1. Verificer at digna-backend kører: digna repo check 2. Tjek netværksforbindelse til identitetsudbyderen 3. Verificer DIGNA_OIDC_CONFIGURATION_URL er tilgængelig 4. Tjek firewall-regler tillader udgående HTTPS-forbindelser 5. Verificer backend og dashboard kan nå hinanden

Brugere oprettes ikke automatisk¶

Symptomer: - SSO-login lykkes, men bruger oprettes ikke i digna - Får tilladelsesfejl efter SSO-login

Årsager og løsninger: 1. Verificer OIDC-konfigurationen er korrekt 2. Tjek at brugerrettigheder er sat op 3. Gennemgå digna-logs for fejlmeddelelser 4. Genstart backend-tjenesten 5. Kontakt support@digna.ai hvis problemet fortsætter

Understøttede udbydere¶

Testede og understøttede¶

Følgende OIDC-udbydere er testet og vides at fungere:

Andre OIDC-udbydere¶

Enhver udbyder, der understøtter OpenID Connect, kan integreres. Påkrævet information:

• Client ID
• Client secret
• OpenID-konfigurations-URL (typisk ved /.well-known/openid-configuration)
• Understøttede scopes (typisk openid profile email)

Kontakt support@digna.ai hvis du har brug for hjælp til at integrere en specifik udbyder.

Bedste praksis¶

GØR: - Brug HTTPS i produktion (ikke HTTP) - Opbevar client secrets sikkert (brug miljøvariabler hvis muligt) - Rotér secrets periodisk - Test i et ikke-produktionsmiljø først - Dokumentér hvilke udbydere der er konfigureret - Overvåg login-logs for usædvanlig aktivitet - Hold identitetsudbyderkonfigurationen i sync med digna-konfigurationen

GØR IKKE: - Gem client secrets i versionsstyring - Brug HTTP redirect URIs i produktion - Konfigurer flere udbydere med samme key - Lad standard/test-legitimationsoplysninger blive i produktion - Eksponér konfigurationsfiler, der indeholder secrets - Bland udviklings- og produktionslegitimationsoplysninger

Support¶

Brug for hjælp til SSO-konfiguration?

• Email: support@digna.ai
• Dokumentation: https://docs.digna.ai
• Website: https://www.digna.ai

Sidst opdateret: August 30, 2026
Release: 2026.04
© 2026 digna GmbH — www.digna.ai