Cunfiguratzione de s'Single Sign-On (SSO) cun SAML o OIDC

ScribbleMaps suportat s'Single Sign-On pro imprèsas impreende SAML 2.0 o OpenID Connect (OIDC). Custu permitit a is membros de s'iscuadra tua de s'autenticare impreende s'Identity Provider (IdP) de s'organizatzione tua che Okta, Microsoft Entra ID (Azure AD), Google Workspace o Auth0.

Sa cunfiguratzione de s'SSO est a disponimentu in team.scribblemaps.com e est totalmente gratuita.

Indice

1. Funtzionalidades suportadas
2. In antis de cumintzare
3. Passu 1: Verìfica su domìniu de s'email tua
4. Passu 2: Cunfigura s'Identity Provider tuo
5. Passu 3: Cunfigura s'SSO in ScribbleMaps
6. Passu 4: Proa sa cunfiguratzione tua
7. Passu 5: Ativa s'SSO
8. SSO avviadu dae s'SP
9. OIN Universal Logout
10. Ghias ispetzìficas pro provider
11. Optziones avanzadas
12. Risolutzione de problemas

Funtzionalidades suportadas

S'integratzione SSO de ScribbleMaps suportat is funtzionalidades chi sighint:

In antis de cumintzare

• Depes èssere unu Team Owner pro cunfigurare s'SSO
• Tenes bisòngiu de s'atzessu a sa consola de amministratzione de s'Identity Provider de s'organizatzione tua
• Tèngia prontu su domìniu de s'email tua (pro esempru, yourcompany.com)

Passu 1: Verìfica su domìniu de s'email tua

In antis de cunfigurare s'SSO, depes verificare sa propiedade de su domìniu de s'email tua. Custa mesura de seguresa garantit chi isceti is organizatziones autorizadas podent cunfigurare s'SSO pro is domìnios issoro.

1. Intra in team.scribblemaps.com
2. Nàviga a Impostatziones > Single Sign-On
3. Bae a sa ischeda Domìnios
4. Blica Agiunghe domìniu e inserta su domìniu de s'email tua (pro esempru, yourcompany.com)
5. Sèbera unu mètodu de verìfica:

Optzione A: Registru DNS TXT (Cussigiadu)

Agiunghe unu registru TXT a is impostatziones DNS de su domìniu tuo:

Nota: Is modìficas DNS podent pigare finas a 48 oras pro si propagare.

Optzione B: Càrriga de archìviu

1. Crea un'archìviu de testu chi si nòmenet scribblemaps-verify.txt
2. Agiunghe su còdighe de verìfica tuo comente cuntenutu ùnicu
3. Càrriga·lu a: https://yourcompany.com/.well-known/scribblemaps-verify.txt

A pustis de aere agiuntu sa verìfica, blica Verìfica domìniu pro cunfirmare sa propiedade.

Passu 2: Cunfigura s'Identity Provider tuo

Agiunghe ScribbleMaps comente aplicatzione in s'Identity Provider tuo. Si impreas Okta, podes agiùnghere ScribbleMaps deretu dae su catalogu Okta Integration Network (OIN) — s'URL SSO SAML, s'SP Entity ID, s'URL ACS e s'URI de reindiritzamentu OIDC benint pre-cunfigurados in automàticu.

Pro SAML 2.0

Pro OIDC

Passu 3: Cunfigura s'SSO in ScribbleMaps

Cunfiguratzione de SAML 2.0

1. In ScribbleMaps, bae a Impostatziones > Single Sign-On > ischeda SAML
2. Inserta is informatziones chi sighint dae s'Identity Provider tuo:

3. Blica Sarva impostatziones

Cunfiguratzione de OIDC

1. In ScribbleMaps, bae a Impostatziones > Single Sign-On > ischeda OIDC
2. Seletziona su Tipu de provider (Google, Microsoft, Okta, Auth0 o Personalizadu)
3. Inserta is informatziones chi sighint:

4. Blica Sarva impostatziones

Passu 4: Proa sa cunfiguratzione tua

In antis de ativare s'SSO pro totu is usuàrios, proa sa cunfiguratzione tua:

1. Blica su butone Test Connection
2. S'at a abèrrere una ventana noa pro simulare su fluxu de login SSO
3. Cumpleta s'autenticatzione cun s'Identity Provider tuo
4. Verìfica chi sias reindiritzadu a pustis in ScribbleMaps

Si sa proa faddit, rivisiona su messàgiu de errore e controlla is impostatziones de cunfiguratzione.

Passu 5: Ativa s'SSO

Una borta chi sa proa est andada bene:

1. Ativa s'interruptore Enable SSO in ON
2. Sèbera s'optzione de imposizione:
   • Optzionale: Is usuàrios podent seberare s'SSO o su login cun password
   • Impostu: Is usuàrios cun domìnios email verificados depent impreare s'SSO (login cun password disativadu)

Nota: Is Team Owner podent semper impreare su login cun password comente sorta de riserva, fintzas cando s'SSO est impostu.

SSO avviadu dae s'SP

ScribbleMaps suportat s'SSO avviadu dae s'SP, chi permitit a is usuàrios de cumintzare su protzessu de intrada dae sa pàgina de login de ScribbleMaps. Gasi funtzionat:

1. Nàviga a scribblemaps.com/account/login
2. Inserta s'indiritzu email tuo (pro esempru, [email protected])
3. Blica Sign in with SSO
4. Ses a èssere reindiritzadu a s'Identity Provider de s'organizatzione tua (pro esempru, Okta) pro t'autenticare
5. A pustis de s'autenticatzione cun sutzessu, ses reindiritzadu in automàticu a ScribbleMaps e ses intradu

Si s'organizatzione tua at s'SSO impostu, a inserire s'email tua in sa pàgina de login ses a èssere reindiritzadu in automàticu a s'Identity Provider tuo — no at a èssere ammustradu perunu campu de password.

OIN Universal Logout

S'Universal Logout de Okta est suportadu. Pro is istrutziones de cunfiguratzione, bisita custu ligòngiu.

Ghias ispetzìficas pro provider

Okta

1. In sa Okta Admin Console, bae a Applications > Browse App Catalog
2. Chirca ScribbleMaps e blica Add Integration
3. S'URL SSO, s'Entity ID e s'URI de reindiritzamentu benint pre-cunfigurados in automàticu
4. Bae a sa ischeda Sign On pro agatare is detàllios de cunfiguratzione de s'IdP tuo:
   • Iscàrriga su X.509 Certificate
   • Còpia s'Identity Provider Issuer (Entity ID)
   • Còpia s'Single Sign-On URL
5. Inserta custos balores in is impostatziones SSO de ScribbleMaps (càstia su Passu 3)

Microsoft Entra ID (Azure AD)

1. In su Portale Azure, bae a Microsoft Entra ID > App registrations > New registration
2. Cunfigura:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (piataforma Web)
3. Bae a Certificates & secrets > Crea unu Client secret nou
4. Còpia s'Application (client) ID e su Client secret value
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

1. In sa Google Cloud Console, bae a APIs & Services > Credentials
2. Blica Create Credentials > OAuth client ID
3. Seletziona Web application
4. Agiunghe s'Authorized redirect URI: https://api.scribblemaps.com/oidc/callback
5. Còpia su Client ID e su Client Secret
6. Authority URL: https://accounts.google.com

Nota: Pro rechèdere s'MFA pro Google Workspace, cunfigura·lu in sa Google Workspace Admin Console.

Auth0

1. In su Dashboard de Auth0, bae a Applications > Create Application
2. Seletziona Regular Web Applications
3. Cunfigura:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Còpia su Client ID e su Client Secret dae sa ischeda Settings
5. Authority URL: https://YOUR-DOMAIN.auth0.com

Optziones avanzadas

Provisioning Just-In-Time (JIT)

Cando est ativadu, is usuàrios benint creados in automàticu in ScribbleMaps a su primu login SSO. Is informatziones de su profilu issoro (nùmene, email) benint cumpiladas dae s'Identity Provider.

Rechedi s'autenticatzione a fatores mùltiplos (isceti OIDC)

Ativa custa optzione pro rechèdere sa verìfica MFA in antis de permìtere su login. ScribbleMaps at a verificare chi s'IdP tuo at imposta s'MFA pro s'utente.

Pro Okta, podes ispetzificare valores ACR personalizados comente:

• urn:okta:loa:2fa:any - Calesisiat segundu fatore
• phr - Autenticatzione resistente a su phishing
• phrh - Autenticatzione resistente a su phishing ligada a s'hardware

Mapadura de Atributos/Claim

Personaliza comente is atributos de s'utente de s'IdP tuo benint mapados a is campos de s'utente de ScribbleMaps:

Risolutzione de problemas

Problemas cumunes

"Domain not verified"

• Assegura·ti chi su registru DNS TXT o s'archìviu de verìfica siat cunfiguradu in manera curreta
• Is modìficas DNS podent pigare finas a 48 oras pro si propagare
• Verìfica chi non bi siant errores de iscritura in su còdighe de verìfica

"Invalid certificate"

• Assegura·ti de impreare su certificadu cumpretu incluidu -----BEGIN CERTIFICATE----- e -----END CERTIFICATE-----
• Controlla chi su certificadu no apat iscadidu
• Assegura·ti de aere copiadu su certificadu de firma, no unu certificadu de cifradura

"Invalid signature"

• Verìfica chi su certificadu currispondat a su certificadu de firma atuale de s'IdP tuo
• Controlla chi s'algoritmu de firma currispondat (SHA-256 vs SHA-1)

"User not found" o "Email mismatch"

• Assegura·ti chi s'email torrada dae s'IdP tuo currispondat a unu domìniu verificadu
• Controlla chi su formadu NameID siat impostadu in Email Address
• Verìfica chi sa mapadura de atributos/claim siat curreta

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

• Custu sutzedit cando sa cunfiguratzione de s'IdP no currispondet a su domìniu verificadu
• Assegura·ti chi su domìniu de s'email siat verificadu in suta de s'iscuadra tua
• Controlla chi ses intrende cun un'email de unu domìniu verificadu

Visualizatzione de is log de auditoria

Monitora s'atividade SSO in Impostatziones > Single Sign-On > Audit Logs. Podes:

• Filtrare pro tipu de eventu (Login, Logout, Login faddidu)
• Filtrare pro intervallu de datas
• Esporta is log in formadu CSV pro is relatos de cunformidade

Tenes bisòngiu de agiudu?

Si ses tenende problemas cun sa cunfiguratzione de s'SSO, cuntata s'iscuadra de suportu nostra cun:

• Su nùmene de s'iscuadra tua
• S'Identity Provider chi ses impreende
• Calesisiat messàgiu de errore chi ses bidende
• Ischermadas de sa cunfiguratzione de s'IdP tuo (cun is datos sensìbiles cuados)

Semus inoghe pro t'agiudare a cunfigurare s'SSO pro s'organizatzione tua.