Konfigurera Single Sign-On (SSO) med SAML eller OIDC

ScribbleMaps stöder Single Sign-On för företag med antingen SAML 2.0 eller OpenID Connect (OIDC). Detta gör att dina teammedlemmar kan autentisera sig med din organisations identitetsleverantör (IdP) som Okta, Microsoft Entra ID (Azure AD), Google Workspace eller Auth0.

SSO-konfiguration är tillgänglig på team.scribblemaps.com och är helt gratis.

Innehållsförteckning

1. Funktioner som stöds
2. Innan du börjar
3. Steg 1: Verifiera din e-postdomän
4. Steg 2: Konfigurera din identitetsleverantör
5. Steg 3: Konfigurera SSO i ScribbleMaps
6. Steg 4: Testa din konfiguration
7. Steg 5: Aktivera SSO
8. SP-initierad SSO
9. OIN Universal Logout
10. Leverantörsspecifika guider
11. Avancerade alternativ
12. Felsökning

Funktioner som stöds

ScribbleMaps SSO-integration stöder följande funktioner:

Innan du börjar

• Du måste vara Team Owner för att konfigurera SSO
• Du behöver åtkomst till din organisations administratörskonsol för identitetsleverantören
• Ha din e-postdomän redo (t.ex. yourcompany.com)

Steg 1: Verifiera din e-postdomän

Innan du konfigurerar SSO måste du verifiera ägarskapet av din e-postdomän. Denna säkerhetsåtgärd säkerställer att endast behöriga organisationer kan konfigurera SSO för sina domäner.

1. Logga in på team.scribblemaps.com
2. Navigera till Inställningar > Single Sign-On
3. Gå till fliken Domains
4. Klicka på Add Domain och ange din e-postdomän (t.ex. yourcompany.com)
5. Välj en verifieringsmetod:

Alternativ A: DNS TXT-post (rekommenderas)

Lägg till en TXT-post i din domäns DNS-inställningar:

Obs: DNS-ändringar kan ta upp till 48 timmar att spridas.

Alternativ B: Filuppladdning

1. Skapa en textfil med namnet scribblemaps-verify.txt
2. Lägg till din verifieringskod som enda innehåll
3. Ladda upp till: https://yourcompany.com/.well-known/scribblemaps-verify.txt

Efter att ha lagt till verifieringen, klicka på Verify Domain för att bekräfta ägarskapet.

Steg 2: Konfigurera din identitetsleverantör

Lägg till ScribbleMaps som en applikation i din identitetsleverantör. Om du använder Okta kan du lägga till ScribbleMaps direkt från Okta Integration Network (OIN)-katalogen — SAML SSO-URL, SP Entity ID, ACS URL och OIDC Redirect URI är förkonfigurerade automatiskt.

För SAML 2.0

För OIDC

Steg 3: Konfigurera SSO i ScribbleMaps

Konfigurera SAML 2.0

1. I ScribbleMaps, gå till Inställningar > Single Sign-On > fliken SAML
2. Ange följande information från din identitetsleverantör:

3. Klicka på Spara inställningar

Konfigurera OIDC

1. I ScribbleMaps, gå till Inställningar > Single Sign-On > fliken OIDC
2. Välj din Provider Type (Google, Microsoft, Okta, Auth0 eller Custom)
3. Ange följande information:

4. Klicka på Spara inställningar

Steg 4: Testa din konfiguration

Innan du aktiverar SSO för alla användare, testa din konfiguration:

1. Klicka på knappen Test Connection
2. Ett nytt fönster öppnas för att simulera SSO-inloggningsflödet
3. Slutför autentiseringen med din identitetsleverantör
4. Verifiera att du omdirigeras korrekt tillbaka till ScribbleMaps

Om testet misslyckas, granska felmeddelandet och kontrollera dina konfigurationsinställningar.

Steg 5: Aktivera SSO

När testningen har lyckats:

1. Slå på omkopplaren Enable SSO
2. Välj ditt genomdrivningsalternativ:
   • Optional: Användare kan välja SSO eller lösenordsinloggning
   • Enforced: Användare med verifierade e-postdomäner måste använda SSO (lösenordsinloggning inaktiverad)

Obs: Team Owners kan alltid använda lösenordsinloggning som reserv, även när SSO är tvingande.

SP-initierad SSO

ScribbleMaps stöder SP-initierad SSO, vilket gör att användare kan starta inloggningsprocessen från ScribbleMaps inloggningssida. Så här fungerar det:

1. Navigera till scribblemaps.com/account/login
2. Ange din e-postadress (t.ex. [email protected])
3. Klicka på Sign in with SSO
4. Du omdirigeras till din organisations identitetsleverantör (t.ex. Okta) för autentisering
5. Efter lyckad autentisering omdirigeras du automatiskt tillbaka till ScribbleMaps och loggas in

Om din organisation har SSO tvingande, kommer det att ange din e-post på inloggningssidan automatiskt omdirigera dig till din identitetsleverantör — inget lösenordsfält kommer att visas.

OIN Universal Logout

Universal logout av Okta stöds. För konfigurationsinstruktioner, besök denna länk.

Leverantörsspecifika guider

Okta

1. I Okta Admin Console, gå till Applications > Browse App Catalog
2. Sök efter ScribbleMaps och klicka på Add Integration
3. SSO-URL, Entity ID och Redirect URI förkonfigureras automatiskt
4. Gå till fliken Sign On för att hitta dina IdP-konfigurationsuppgifter:
   • Ladda ned X.509 Certificate
   • Kopiera Identity Provider Issuer (Entity ID)
   • Kopiera Single Sign-On URL
5. Ange dessa värden i ScribbleMaps SSO-inställningar (se Steg 3)

Microsoft Entra ID (Azure AD)

1. I Azure Portal, gå till Microsoft Entra ID > App registrations > New registration
2. Konfigurera:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (Web-plattform)
3. Gå till Certificates & secrets > Skapa en ny Client secret
4. Kopiera Application (client) ID och Client secret value
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

1. I Google Cloud Console, gå till APIs & Services > Credentials
2. Klicka på Create Credentials > OAuth client ID
3. Välj Web application
4. Lägg till Authorized redirect URI: https://api.scribblemaps.com/oidc/callback
5. Kopiera Client ID och Client Secret
6. Authority URL: https://accounts.google.com

Obs: För att kräva MFA för Google Workspace, konfigurera det i din Google Workspace Admin Console.

Auth0

1. I Auth0 Dashboard, gå till Applications > Create Application
2. Välj Regular Web Applications
3. Konfigurera:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Kopiera Client ID och Client Secret från fliken Settings
5. Authority URL: https://YOUR-DOMAIN.auth0.com

Avancerade alternativ

Just-In-Time (JIT)-etablering

När detta är aktiverat skapas användare automatiskt i ScribbleMaps vid första SSO-inloggningen. Deras profilinformation (namn, e-post) hämtas från identitetsleverantören.

Kräv multifaktorautentisering (endast OIDC)

Aktivera detta alternativ för att kräva MFA-verifiering innan inloggning tillåts. ScribbleMaps kommer att verifiera att din IdP har tvingat fram MFA för användaren.

För Okta kan du ange anpassade ACR-värden som:

• urn:okta:loa:2fa:any - Vilken andra faktor som helst
• phr - Nätfiskeresistent autentisering
• phrh - Nätfiskeresistent hårdvarubunden autentisering

Attribut-/anspråksmappning

Anpassa hur användarattribut från din IdP mappas till ScribbleMaps användarfält:

Felsökning

Vanliga problem

"Domain not verified"

• Säkerställ att din DNS TXT-post eller verifieringsfil är korrekt konfigurerad
• DNS-ändringar kan ta upp till 48 timmar att spridas
• Kontrollera att det inte finns stavfel i verifieringskoden

"Invalid certificate"

• Säkerställ att du använder hela certifikatet inklusive -----BEGIN CERTIFICATE----- och -----END CERTIFICATE-----
• Kontrollera att certifikatet inte har gått ut
• Se till att du kopierade signeringscertifikatet, inte ett krypteringscertifikat

"Invalid signature"

• Verifiera att certifikatet matchar din IdP:s aktuella signeringscertifikat
• Kontrollera att signaturalgoritmen matchar (SHA-256 kontra SHA-1)

"User not found" eller "Email mismatch"

• Säkerställ att e-posten som returneras av din IdP matchar en verifierad domän
• Kontrollera att NameID-formatet är inställt på E-postadress
• Verifiera att attribut-/anspråksmappningen är korrekt

"Security error: Your Identity Provider is not authorized for this email domain"

• Detta inträffar när IdP-konfigurationen inte matchar den verifierade domänen
• Säkerställ att e-postdomänen är verifierad under ditt team
• Kontrollera att du loggar in med en e-post från en verifierad domän

Visa granskningsloggar

Övervaka SSO-aktivitet under Inställningar > Single Sign-On > Audit Logs. Du kan:

• Filtrera efter händelsetyp (Login, Logout, Failed Login)
• Filtrera efter datumintervall
• Exportera loggar som CSV för efterlevnadsrapportering

Behöver du hjälp?

Om du upplever problem med SSO-konfigurationen, kontakta vårt supportteam med:

• Ditt teamnamn
• Identitetsleverantören du använder
• Eventuella felmeddelanden du ser
• Skärmdumpar av din IdP-konfiguration (med känslig data dold)

Vi är här för att hjälpa dig konfigurera SSO för din organisation.