SAML

Opsætning af SAML-autentificering i FastComments kræver både konfiguration i din administrationskonsol og opsætning i din identitetsudbyder.

Forudsætninger

Før du konfigurerer SAML, skal du sikre dig, at du har:

• En FastComments Flex- eller Pro-plan (SAML er ikke tilgængelig på Creators-planen)
• Administrativ adgang til din FastComments-konto
• Administrativ adgang til din identitetsudbyder
• Din IdP's SAML-metadata eller certifikatinformation

Adgang til SAML-konfiguration

1. Log ind på dit FastComments administrationsdashboard
2. Gå til API/SSO-indstillinger i venstre sidebjælke
3. Klik på knappen SAML-konfiguration

Hvis du ikke kan se knappen SAML-konfiguration, skal du kontrollere, at:

• Din konto har den nødvendige pakke (Flex eller Pro)
• Du har administrative rettigheder
• Din bruger har rollerne API Admin eller Admin Admin

Grundlæggende SAML-konfiguration

Aktivér SAML-autentificering

1. Markér afkrydsningsfeltet Aktivér SAML-autentificering
2. Dette aktiverer SAML for din tenant og gør konfigurationsfelterne tilgængelige

Obligatoriske felter

IdP Single Sign-On URL (Påkrævet)

• URL'en hvor brugere vil blive omdirigeret for autentificering
• Normalt leveret af din identitetsudbyder
• Eksempel: https://your-company.okta.com/app/fastcomments/sso/saml

IdP X.509-certifikat (Påkrævet)

• Det offentlige certifikat fra din identitetsudbyder
• Bruges til at verificere ægtheden af SAML-svar
• Skal inkludere det fulde certifikat med BEGIN/END-markører
• Eksempelformat:

-----BEGIN CERTIFICATE-----
MIICXjCCAcegAwIBAgIBADANBgkqhkiG9w0BAQsFADA...
-----END CERTIFICATE-----

Valgfrie felter

IdP Entity ID / Udsteder

• Identificerer din identitetsudbyder
• Hvis den efterlades tom, bruges som standard din FastComments-URL
• Skal matche den udsteder, der er konfigureret i din IdP

Avanceret konfiguration

Sikkerhedsindstillinger

Signaturalgoritme

• Standard er SHA-256 (anbefalet)
• Muligheder: SHA-1, SHA-256, SHA-512
• Skal matche din IdP's konfiguration

Digest-algoritme

• Standard er SHA-256 (anbefalet)
• Bruges til beregning af digest i SAML-svar
• Skal matche din IdP's konfiguration

Name ID-format

• Standard er e-mailadresseformat
• Bestemmer, hvordan brugeridentifikatorer formateres
• Almindelige muligheder: Email Address, Persistent, Transient

Kryptering (valgfrit)

Privat nøgle til dekryptering

• Kun nødvendigt, hvis din IdP krypterer SAML-assertioner
• Indsæt din private nøgle, der bruges til dekryptering
• De fleste installationer kræver ikke kryptering af assertioner

Gem konfiguration

1. Gennemgå alle indstillinger for korrekthed
2. Klik på Gem SAML-konfiguration
3. Systemet vil validere din konfiguration
4. Hvis det lykkes, vil du se en bekræftelsesmeddelelse

Næste skridt

Efter at have gemt din FastComments SAML-konfiguration:

1. Konfigurer din identitetsudbyder ved hjælp af Service Provider-oplysningerne
2. Test autentificeringsflowet
3. Opsæt brugerroller og tilladelser efter behov

Service Provider-oplysningerne, der er nødvendige til din IdP-konfiguration, vises, når SAML er aktiveret.

Efter at have konfigureret SAML i FastComments, skal du konfigurere FastComments som en tjenesteudbyder i din identitetsudbyder.

Generel IdP-konfiguration

De fleste identitetsudbydere kræver følgende oplysninger for at tilføje FastComments som en SAML-applikation:

Påkrævet tjenesteudbyderinformation

Disse værdier genereres automatisk og vises på din FastComments SAML-konfigurationsside:

SP Entity ID / Audience

• Format: https://fastcomments.com/saml/{your-tenant-id}
• Dette identificerer entydigt din FastComments-forekomst

Assertion Consumer Service (ACS) URL

• Format: https://fastcomments.com/saml/callback/{your-tenant-id}
• Hvor din IdP sender SAML-svar efter autentificering

SP Metadata URL (hvis understøttet af din IdP)

• Format: https://fastcomments.com/saml/metadata/{your-tenant-id}
• Leverer komplet SAML-konfiguration i XML-format

SAML Login URL

• Format: https://fastcomments.com/saml/login/{your-tenant-id}
• Direkte link til at igangsætte SAML-autentificering

Påkrævede SAML-attributter

Konfigurer din identitetsudbyder til at sende disse attributter med SAML-svar:

Væsentlige attributter

Email Address (Påkrævet)

• Attribute Name: email, emailAddress, or http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
• Formål: Entydig brugeridentifikation og meddelelser
• Format: Gyldig e-mailadresse

Valgfrie attributter

First Name

• Attribute Names: firstName, givenName, or http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
• Formål: Brugernavn der vises

Last Name

• Attribute Names: lastName, surname, or http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
• Formål: Brugernavn der vises

Roles (Vigtigt for adgangskontrol)

• Attribute Names: roles, groups, memberOf, or custom attribute names
• Formål: Tildeling af FastComments-roller og tilladelser
• Format: Array af rolletekster eller kommaseparerede værdier

Almindelige identitetsudbyderkonfigurationer

Microsoft Azure AD

1. Tilføj Enterprise Application

   • Søg efter "FastComments" eller opret en brugerdefineret SAML-applikation
   • Brug SP-oplysningerne leveret af FastComments

2. Konfigurer attributter

   • Email: user.mail or user.userprincipalname
   • First Name: user.givenname
   • Last Name: user.surname
   • Roles: user.assignedroles or directory groups

Okta

1. Opret SAML-applikation

   • Brug "Create New App" og vælg SAML 2.0
   • Konfigurer med FastComments SP-oplysninger

2. Attribute Statements

   • Email: user.email
   • FirstName: user.firstName
   • LastName: user.lastName
   • Roles: user.groups or custom attributes

Google Workspace

1. Tilføj SAML-applikation

   • Gå til Apps > Web and mobile apps > Add App > Add custom SAML app
   • Konfigurer med FastComments SP-oplysninger

2. Attributkortlægning

   • Email: Primary email
   • First Name: First name
   • Last Name: Last name
   • Roles: Groups or custom attributes

Active Directory Federation Services (ADFS)

1. Tilføj Relying Party Trust

   • Brug FastComments-metadata-URL'en eller manuel konfiguration
   • Konfigurer SP-oplysninger som angivet

2. Claim Rules

   • Email: Email Address claim
   • Name: Name ID claim
   • Roles: Gruppemedlemskab eller brugerdefinerede claims

Fleksibilitet i attributnavne

FastComments accepterer rolleinformation fra flere attributnavne for at imødekomme forskellige IdP-konfigurationer:

• roles
• groups
• memberOf
• role
• group
• http://schemas.microsoft.com/ws/2008/06/identity/claims/role
• http://schemas.xmlsoap.org/ws/2005/05/identity/claims/role

Denne fleksibilitet sikrer kompatibilitet med forskellige identitetsudbydere uden at kræve specifikke navngivningskonventioner for attributter.

Test af din konfiguration

Efter at have konfigureret din identitetsudbyder:

1. Gem IdP-konfigurationen
2. Test med en dedikeret testbruger
3. Bekræft, at attributter sendes korrekt
4. Kontroller, at roller er korrekt kortlagt
5. Sørg for, at autentificeringsflowet fuldføres succesfuldt

De fleste identitetsudbydere tilbyder SAML-testværktøjer til at validere konfigurationen, før du ruller ud til produktionsbrugere.

Når SAML er aktiveret i FastComments, genererer systemet automatisk Service Provider (SP)-information, som du skal konfigurere i din identity provider.

Adgang til Service Provider-information

SP-informationen vises på din SAML-konfigurationsside, efter du har aktiveret SAML-godkendelse. Denne information indeholder alle de detaljer, din identity provider har brug for til at etablere SAML-tillidsforholdet.

Service Provider-endpoints

SP Entity ID / Audience

Formål: Identificerer entydigt din FastComments-instans som service provider Format: https://fastcomments.com/saml/{your-tenant-id} Anvendelse: Konfigurer dette som Entity ID eller Audience i din IdP

Denne identifikator sikrer, at SAML-svar er beregnet til din specifikke FastComments-tenant, og forhindrer, at SAML-svar accepteres af andre instanser.

Assertion Consumer Service (ACS) URL

Formål: Endpointet, hvor din IdP sender SAML-svar efter brugergodkendelse Format: https://fastcomments.com/saml/callback/{your-tenant-id} Anvendelse: Konfigurer dette som ACS URL eller Reply URL i din IdP

Det er her, brugere omdirigeres til efter vellykket godkendelse hos din identity provider, sammen med SAML-assertionen, der indeholder brugeroplysninger.

SP Metadata URL

Formål: Giver komplet SAML-konfiguration i standard-XML-format Format: https://fastcomments.com/saml/metadata/{your-tenant-id} Anvendelse: Nogle IdP'er kan automatisk importere konfigurationen via denne URL

Metadata-URL'en indeholder al nødvendig SP-information i XML-format, hvilket gør det nemt automatisk at konfigurere kompatible identity providers.

SAML Login URL

Formål: Direkte link til at starte SAML-godkendelse for din tenant Format: https://fastcomments.com/saml/login/{your-tenant-id} Anvendelse: Link brugere direkte til SAML-godkendelse eller test flowet

Du kan bruge denne URL til at teste SAML-godkendelse eller give brugerne et direkte link til at logge ind via SAML.

Understøttelse af SAML-bindings

FastComments understøtter følgende SAML-bindings:

HTTP-POST Binding

• Primær metode: Den mest almindelige binding til SAML-svar
• Sikkerhed: SAML-svaret sendes via HTTP POST til ACS-URL'en
• Anvendelse: Anbefales til produktionsmiljøer

HTTP-Redirect Binding

• Alternativ metode: SAML-svar sendt via HTTP-redirect
• Begrænsninger: Begrænset payload-størrelse pga. URL-længdebegrænsninger
• Anvendelse: Understøttet, men HTTP-POST foretrækkes

Name ID-politik

FastComments konfigurerer følgende Name ID-politik i SAML-forespørgsler:

• Standardformat: urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
• Alternative formater: Persistent, Transient, Unspecified (kan konfigureres)
• Krav: E-mailadressen bruges som primær brugeridentifikator

SAML-forespørgselsattributter

Ved initiering af SAML-godkendelse sender FastComments forespørgsler med disse karakteristika:

Forespørgselssignering

• Status: Valgfri (kan konfigureres)
• Algoritme: Matcher den konfigurerede signaturalgoritme
• Certifikat: Bruger tenantspecifikt certifikat, hvis forespørgselssignering er aktiveret

Anmodede attributter

FastComments anmoder om følgende attributter i SAML AuthnRequests:

• Email: Påkrævet til brugeridentifikation
• First Name: Valgfri til visningsformål
• Last Name: Valgfri til visningsformål
• Roles/Groups: Valgfri til adgangskontrol og tilladelser

Kopiering af SP-information

SAML-konfigurationssiden giver klikbare felter, der automatisk kopierer SP-information til din udklipsholder:

1. Klik på et vilkårligt SP-informationsfelt (Entity ID, ACS URL osv.)
2. Værdien kopieres automatisk til din udklipsholder
3. Indsæt værdien i din identity providers konfiguration
4. En kort fremhævelse indikerer, at kopieringen lykkedes

Dette gør det nemt at overføre SP-informationen til din IdP nøjagtigt uden tastefejl.

SP-certifikatinformation

Certifikatanvendelse

• Formål: Krypterer kommunikation og verificerer SP-identiteten
• Rotation: Certifikater administreres automatisk af FastComments
• Adgang: Offentlige certifikater er tilgængelige via metadata-URL'en

Certifikatdetaljer

• Algoritme: RSA-2048 eller højere
• Gyldighed: Certifikater fornyes automatisk inden udløb
• Distribution: Tilgængelige via standard SAML-metadata

Fejlfinding af SP-konfiguration

Hvis din identity provider rapporterer problemer med SP-informationen:

1. Verificér URL'er: Sørg for, at alle URL'er bruger HTTPS og indeholder den korrekte tenant-ID
2. Tjek metadata: Brug metadata-URL'en til at verificere konfigurationen
3. Test forbindelsen: Sørg for, at din IdP kan nå FastComments-endpoints
4. Validér formatet: Bekræft, at din IdP understøtter SP-informationsformatet

Almindelige problemer omfatter:

• Forkert tenant-ID i URL'er
• Netværksforbindelsesproblemer mellem IdP og FastComments
• IdP, der forventer andre URL-formater eller yderligere konfigurationsmuligheder

Test af din SAML-konfiguration sikrer, at godkendelse fungerer korrekt, før den rulles ud til produktionsbrugere.

Tjekliste før test

Før du tester SAML-godkendelse, bekræft:

• ✅ SAML er aktiveret i FastComments
• ✅ Alle nødvendige felter er udfyldt (IdP URL, certifikat)
• ✅ Identitetsudbyderen er konfigureret med FastComments SP-oplysninger
• ✅ Testbruger findes i din IdP
• ✅ Testbrugeren har de rette roller tildelt

Testmetoder

Metode 1: Direkte SAML-login-URL

1. Hent SAML-login-URL:

   • Kopier fra din SAML-konfigurationsside
   • Format: https://fastcomments.com/saml/login/{your-tenant-id}

2. Test godkendelse:

   • Åbn SAML-login-URL'en i et inkognito-/privat browservindue
   • Du bør blive omdirigeret til din identitetsudbyder
   • Log ind med testoplysninger
   • Bekræft, at du omdirigeres tilbage til FastComments

Metode 2: Adgang til admin-dashboardet

1. Gå til FastComments:

   • Gå til FastComments admin-dashboard
   • Se efter SAML-loginmulighed eller brug SAML-login-URL'en

2. Gennemfør godkendelsesflowet:

   • Godkend via din identitetsudbyder
   • Bekræft adgang til de relevante adminfunktioner baseret på tildelte roller

Metode 3: Test af widget-integration

Til test af SAML med kommentarwidgets:

1. Indlejr widget: Brug FastComments-widget'en på en testside
2. Godkendelse: Klik på login og vælg SAML-muligheden (hvis tilgængelig)
3. Verifikation: Bekræft, at brugeren vises som godkendt i widget'en

Hvad der skal verificeres under test

Godkendelsesflow

Succesfuld omdirigering:

• Brugeren omdirigeres til IdP's login-side
• IdP's login-side indlæses korrekt
• Ingen certifikat- eller SSL-fejl opstår

IdP-godkendelse:

• Brugeren kan logge ind med deres IdP-legitimationsoplysninger
• Multi-faktor-godkendelse fungerer (hvis konfigureret)
• Ingen godkendelsesfejl fra IdP

Returnering til FastComments:

• Brugeren omdirigeres tilbage til FastComments efter succesfuld IdP-login
• Ingen valideringsfejl af SAML-assertion
• Brugeren får adgang til de relevante FastComments-funktioner

Brugeroplysninger

Grundlæggende profildata:

• E-mailadresse indfanges korrekt
• Fornavn og efternavn vises, hvis de er angivet
• Brugerprofil oprettes eller opdateres

Rollertilskrivning:

• Administrative roller er korrekt tildelt
• Brugeren har adgang til forventede adminfunktioner
• Tilladelser matcher de tildelte roller

Validering af SAML-respons

Certifikatverifikation:

• SAML-responsens signatur valideres med succes
• Ingen certifikatvalideringsfejl i logfiler
• Respons accepteres som ægte

Atributbehandling:

• Påkrævede attributter (email) er til stede
• Valgfrie attributter behandles korrekt
• Rolleattributter fortolkes og anvendes korrekt

Test af forskellige scenarier

Standard brugerflow

1. Ny bruger:

   • Første SAML-login
   • Oprettelse af konto
   • Tildeling af basisrettigheder

2. Eksisterende bruger:

   • Tilbagevendende brugerlogin
   • Profilopdateringer
   • Rolleændringer

Test af administrativ adgang

1. Adminroller:

   • Testbrugere med fc-admin-admin-rollen
   • Bekræft adgang til admin-dashboardet
   • Bekræft administrative beføjelser

2. Specialiserede roller:

   • Test adgang for fc-moderator til moderationsfunktioner
   • Test adgang for fc-analytics-admin til analysefunktioner
   • Test adgang for fc-billing-admin til faktureringsfunktioner

Fejlscenarier

1. Ugyldige certifikater:

   • Test med udløbne eller forkerte certifikater
   • Bekræft korrekt fejlhåndtering

2. Manglende attributter:

   • Test SAML-responser uden den påkrævede emailattribut
   • Bekræft elegant fejlhåndtering

3. Netværksproblemer:

   • Test med forbindelsesproblemer
   • Bekræft timeout-håndtering

Fejlfinding af testproblemer

Almindelige godkendelsesproblemer

Omdirigeringsloop:

• Kontrollér, at SP Entity ID matcher IdP-konfigurationen
• Bekræft, at ACS URL er korrekt konfigureret
• Bekræft, at SAML-bindingindstillingerne stemmer overens

Certifikatfejl:

• Sørg for, at certifikatet indeholder BEGIN/END-markører
• Bekræft, at certifikatet ikke er udløbet
• Tjek for ekstra mellemrum eller formateringsproblemer

Attributproblemer:

• Bekræft, at emailattributten sendes
• Bekræft, at rolleattributter bruger korrekt navngivning
• Tjek attributformat (array vs. komma-adskilt)

Fejlsøgningsværktøjer

Browserudviklerværktøjer:

• Overvåg netværksanmodninger under SAML-flowet
• Tjek for HTTP-fejl eller omdirigeringer
• Undersøg SAML POST-data (hvis synligt)

IdP-testværktøjer:

• De fleste IdP'er tilbyder SAML-testgrænseflader
• Brug IdP-værktøjer til at validere SAML-responsformatet
• Test attributkonfigurationen, før du sender til FastComments

FastComments-support:

• Aktivér debug-logning under test
• Gem fejlmeddelelser og tidsstempler
• Kontakt support med specifikke fejldetaljer

Bedste praksis for test

Opsætning af testmiljø

1. Dedikerede testbrugere:

   • Opret specifikke testkonti i din IdP
   • Tildel forskellige rollekombinationer
   • Brug letgenkendelige test-e-mailadresser

2. Isoleret test:

   • Brug inkognito-/private browservinduer
   • Ryd cookies mellem tests
   • Test med forskellige brugerkonti

3. Dokumentation:

   • Registrér testscenarier og resultater
   • Dokumentér eventuelle nødvendige konfigurationsændringer
   • Notér detaljer om succesfuld konfiguration

Validering før produktion

1. Omfattende test:

   • Test alle rollekombinationer
   • Bekræft kanttilfælde og fejlsituationer
   • Bekræft, at ydeevnen er acceptabel

2. Brugeraccept:

   • Få slutbrugere til at teste godkendelsesflowet
   • Indsaml feedback om brugeroplevelsen
   • Bekræft, at workflowet opfylder kravene

3. Sikkerhedsreview:

   • Bekræft, at certifikatvalidering fungerer
   • Bekræft, at rollefordelinger er sikre
   • Test håndhævelse af adgangskontrol

Udrulning i produktion

Efter succesfuld test:

1. Gradvis udrulning: Overvej først at udrulle SAML til en delmængde af brugerne
2. Overvågning: Overvåg succesrater for godkendelse og fejl i logfiler
3. Supportforberedelse: Forbered supportteamet på SAML-relaterede spørgsmål
4. Dokumentation: Udarbejd brugerdokumentation for SAML-loginprocessen

Denne guide gennemgår almindelige SAML-godkendelsesproblemer og deres løsninger.

Certifikat- og sikkerhedsproblemer

Ugyldigt certifikat-fejl

Symptomer:

• "Certifikatvalidering mislykkedes"-fejl
• Brugere kan ikke fuldføre SAML-godkendelse
• SAML-svar afvises

Almindelige årsager:

• Certifikatformatet er forkert
• Certifikatet er udløbet
• Forkert certifikat blev angivet
• Ekstra tegn eller mellemrum i certifikatet

Løsninger:

1. Verificér certifikatformat:

   • Sørg for, at certifikatet indeholder -----BEGIN CERTIFICATE----- og -----END CERTIFICATE----- markører
   • Fjern eventuelt ekstra mellemrum eller linjeskift
   • Kopiér certifikatet direkte fra IdP-metadata eller konfiguration

2. Tjek certifikatets gyldighed:

   • Verificér, at certifikatet ikke er udløbet
   • Bekræft, at certifikatet er til den korrekte IdP
   • Brug online certifikatvalidatorer til at tjekke formatet

3. Download certifikatet igen:

   • Download et friskt certifikat fra IdP'en
   • Brug IdP-metadata-URL, hvis tilgængelig
   • Bekræft, at certifikatet matcher den aktuelle IdP-konfiguration

Signaturverifikation mislykkedes

Symptomer:

• Fejl ved validering af SAML-assertion-signatur
• Godkendelse mislykkes efter IdP-login
• "Ugyldig signatur"-fejlmeddelelser

Løsninger:

1. Algoritme-mismatch:

   • Tjek, at signaturalgoritmen i FastComments matcher IdP'en
   • Prøv forskellige signaturalgoritmer (SHA-256, SHA-1, SHA-512)
   • Verificér, at digest-algoritmen matcher IdP-konfigurationen

2. Certifikatproblemer:

   • Sørg for, at det korrekte signeringscertifikat er konfigureret
   • Verificér, at certifikatet svarer til den private nøgle, som IdP'en bruger
   • Tjek for certifikatrotation i IdP'en

Konfigurationsproblemer

Forkert Entity ID eller ACS URL

Symptomer:

• IdP'en rapporterer "Ukendt service provider"
• SAML-svar sendes til forkert endpoint
• Godkendelsen fuldføres ikke

Løsninger:

1. Verificér SP-oplysninger:

   • Kopiér den nøjagtige Entity ID fra FastComments-konfigurationen
   • Sørg for, at ACS URL matcher formatet: https://fastcomments.com/saml/callback/{tenant-id}
   • Tjek for tastefejl i tenant ID

2. IdP-konfiguration:

   • Opdater IdP'en med korrekt SP Entity ID
   • Konfigurer korrekt ACS/Reply URL
   • Verificér IdP-binding-indstillinger (HTTP-POST foretrækkes)

Manglende eller forkerte attributter

Symptomer:

• Brugere oprettes uden korrekte roller
• Manglende brugerprofiloplysninger
• "Email påkrævet"-fejl

Løsninger:

1. Email-attribut:

   • Sørg for, at IdP'en sender email-attributten
   • Tjek attributnavnes-mapping (email, emailAddress osv.)
   • Verificér, at email-værdien er en gyldig emailadresse

2. Rolleattributter:

   • Bekræft, at IdP'en sender rolle/gruppe-oplysninger
   • Tjek, at rolleattributnavnene matcher FastComments' forventninger
   • Verificér, at rolleværdierne matcher FastComments' rollenavne præcist

3. Attributformat:

   • Test både array- og kommasepareret rolleformat
   • Sørg for, at attributværdier ikke har ekstra mellemrum
   • Tjek for versalfølsomhed i rollenavne

Godkendelsesflow-problemer

Redirect-løkke

Symptomer:

• Browseren redirecter endeløst mellem FastComments og IdP'en
• Godkendelsen fuldføres aldrig
• Flere redirects vises i browserens udviklerværktøjer

Løsninger:

1. Tjek SP-konfiguration:

   • Verificér, at Entity ID matcher IdP-konfigurationen præcist
   • Sørg for, at ACS URL er korrekt konfigureret i IdP'en
   • Tjek for afsluttende skråstreger i URL'er

2. Session-problemer:

   • Ryd browser-cookies og prøv igen
   • Test i inkognito/privat browservindue
   • Tjek for indstillinger for session-timeout

Adgang nægtet efter godkendelse

Symptomer:

• SAML-godkendelsen lykkes
• Brugeren redirectes til FastComments
• "Adgang nægtet" eller tilladelsesfejl vises

Løsninger:

1. Rolletildeling:

   • Verificér, at brugeren har passende roller i IdP'en
   • Tjek, at rolleattributten sendes i SAML-svaret
   • Bekræft, at rollenavnene matcher FastComments' krav præcist

2. Pakkebegrænsninger:

   • Verificér, at kontoen har Flex- eller Pro-plan
   • Tjek, at SAML-funktionen er aktiveret for pakken
   • Kontakt support, hvis pakken inkluderer SAML, men funktionen er utilgængelig

Identitetsudbyder-specifikke problemer

Microsoft Azure AD

Almindelige problemer:

• App-rolletildelinger afspejles ikke i tokens
• Claims sendes ikke korrekt
• Krav om brugertildeling

Løsninger:

• Tjek brugertildeling til FastComments-applikationen
• Verificér, at app-roller er korrekt konfigureret
• Sørg for, at claims-mapping inkluderer påkrævede attributter

Okta

Almindelige problemer:

• Gruppefiltre fungerer ikke korrekt
• Attributsætninger er forkert konfigureret
• Problemer med applikationstildeling

Løsninger:

• Gennemgå attributsætning-konfigurationen
• Tjek gruppetildeling og filtreringsregler
• Verificér, at applikationen er tildelt til passende brugere/grupper

Google Workspace

Almindelige problemer:

• Brugerdefinerede attributter mappes ikke korrekt
• Gruppemedlemskab sendes ikke
• Fejl i SAML-applikationskonfiguration

Løsninger:

• Konfigurer brugerdefineret skema til rolleattributter
• Tjek udbredelse af gruppemedlemskab
• Verificér attribut-mapping i SAML-applikationen

Netværks- og forbindelsesproblemer

Timeout-fejl

Symptomer:

• Godkendelsesprocessen får timeout
• "Request timeout" eller lignende fejl
• Langsomt godkendelsesflow

Løsninger:

1. Netværksforbindelse:

   • Tjek, at firewall-regler tillader FastComments-kommunikation
   • Verificér DNS-opslag for fastcomments.com
   • Test netværksforbindelsen fra IdP'en til FastComments

2. Ydeevneproblemer:

   • Tjek IdP'ens svartider
   • Verificér, at validering af certifikatkæden ikke er langsom
   • Overvej netværkslatens mellem IdP og brugere

SSL/TLS-problemer

Symptomer:

• Certifikatadvarsler under godkendelse
• SSL-handshake-fejl
• "Sikker forbindelse mislykkedes"-fejl

Løsninger:

• Sørg for, at alle SAML-endpoints bruger HTTPS
• Tjek certifikatets gyldighed for alle involverede domæner
• Verificér kompatibilitet af TLS-version

Fejlfinding og logning

Aktivering af debug-oplysninger

1. Browserens udviklerværktøjer:

   • Overvåg Network-fanen under SAML-flowet
   • Tjek Console for JavaScript-fejl
   • Undersøg SAML POST-requests (hvis synlige)

2. IdP-logning:

   • Aktivér SAML-debugging i din IdP
   • Gennemgå IdP-logs for detaljer om SAML-request/response
   • Tjek for problemer med attribut-mapping

Almindelige logmeddelelser

FastComments-logs:

• "SAML config not found" - SAML er ikke aktiveret eller er forkert konfigureret
• "Invalid certificate" - Certifikatvalidering mislykkedes
• "Missing email attribute" - Påkrævet email blev ikke angivet i SAML-svaret

IdP-logs:

• "Unknown service provider" - Entity ID mismatch
• "Invalid ACS URL" - Assertion Consumer Service URL er forkert
• "User not assigned" - Brugeren mangler adgang til SAML-applikationen

At få hjælp

Oplysninger at indsamle

Når du kontakter support, så angiv:

• Nøjagtige fejlmeddelelser og tidsstempler
• SAML-konfigurationsdetaljer (uden følsomme data)
• IdP-type og version
• Trin til at genskabe problemet
• Browser- og netværksoplysninger

FastComments-support

For SAML-relaterede problemer:

1. Brug supportportalen
2. Inkluder tenant ID og berørte brugeres emails
3. Angiv fejlmeddelelser og konfigurationsdetaljer
4. Specificér IdP-type og konfigurationstilgang

IdP-support

For IdP-specifikke problemer:

• Konsultér IdP-dokumentationen for SAML-fejlfinding
• Brug IdP'ens supportkanaler til konfigurationsproblemer
• Udnyt IdP'ens community-fora til almindelige problemer

Forebyggelsestips

Bedste praksis

1. Test grundigt:

   • Test konfigurationsændringer i et ikke-produktionsmiljø
   • Verificér med flere testbrugere
   • Dokumentér fungerende konfigurationer

2. Overvåg regelmæssigt:

   • Opsæt overvågning af SAML-godkendelsesfejl
   • Gennemgå certifikaters udløbsdatoer
   • Overvåg for ændringer i IdP-konfigurationen

3. Dokumentation:

   • Vedligehold dokumentation af SAML-konfigurationen
   • Dokumentér eventuelle brugerdefinerede konfigurationer eller workarounds
   • Gem kontaktoplysninger for IdP-administratorer

Proaktivt vedligehold

1. Certifikathåndtering:

   • Overvåg certifikaters udløbsdatoer
   • Planlæg procedurer for certifikatrotation
   • Test certifikatopdateringer før udløb

2. Konfigurationsgennemgange:

   • Gennemgå regelmæssigt SAML-konfigurationen
   • Verificér, at IdP-konfigurationen forbliver aktuel
   • Opdater dokumentationen, efterhånden som ændringer foretages