Single Sign-On (SSO)
Accedi alla dashboard Jamdesk con il tuo provider di identità. Configura SAML o OIDC su qualsiasi piano a pagamento; la SSO per i lettori del sito è disponibile su Enterprise.
Jamdesk offre due tipi di Single Sign-On. Dashboard SSO consente al tuo team di accedere alla dashboard tramite il tuo provider di identità. Puoi configurarla autonomamente dalle Impostazioni su qualsiasi piano a pagamento. Docs-site SSO autentica i lettori della documentazione pubblicata tramite il tuo IdP, al posto di una password condivisa. Il nostro team la configura sui piani Enterprise.
Per l'accesso individuale alla documentazione senza un piano Enterprise, usa l'autenticazione JWT. Se il tuo prodotto ha un login proprio, il tuo backend autentica i lettori. È disponibile su tutti i piani.
Cosa copre l'SSO
A chi è rivolto
La SSO richiede un provider di identità: Okta, Google Workspace, Microsoft Entra ID, Auth0 o qualsiasi provider SAML 2.0 / OIDC.
La Dashboard SSO ti dà il controllo centralizzato su chi gestisce i progetti. L'MFA è imposta tramite il tuo IdP. Con la SSO obbligatoria, rimuovere qualcuno dalla tua directory blocca anche il suo accesso alla dashboard.
La Docs-site SSO ti offre un registro di chi ha letto quali documenti. Sostituisce una password condivisa con un accesso per singolo utente.
Abilitare il Dashboard SSO
La Dashboard SSO è self-service su qualsiasi piano a pagamento. Verifica il dominio della tua email, collega il tuo provider di identità e, se vuoi, richiedi la SSO a tutti gli utenti di quel dominio.
Prima di iniziare
- Un piano Jamdesk a pagamento.
- Accesso da proprietario al progetto. La connessione SSO copre tutti i progetti di cui sei proprietario. Solo il proprietario vede le impostazioni Single Sign-On.
- Accesso al DNS del tuo dominio per aggiungere un record TXT.
- Accesso amministratore al tuo provider di identità (Okta, Microsoft Entra, Google Workspace, Auth0 o qualsiasi provider SAML 2.0 / OIDC).
Configurare la connessione
Nella dashboard vai su Impostazioni → Single Sign-On e inserisci il dominio email aziendale, ad esempio acme.com. Jamdesk crea una connessione e mostra un record DNS TXT per la verifica del dominio.
Aggiungi al DNS del tuo dominio un record TXT con nome e valore indicati nella dashboard. Clicca su Verify. Le modifiche DNS possono richiedere fino a un'ora per propagarsi. Se il primo tentativo fallisce, attendi e riprova. Lascia il record al suo posto anche dopo la verifica: Jamdesk lo ricontrolla periodicamente e disabilita la connessione se scompare.
Copia Entity ID e ACS URL dalla dashboard in una nuova applicazione SAML o OIDC nel tuo IdP. Inserisci i dati del tuo IdP in Jamdesk:
- SAML 2.0: IdP Entity ID, SSO URL e il certificato di firma X.509 in formato PEM.
- OIDC: issuer URL, client ID e client secret.
Scegli il tuo provider dalla lista per una guida di configurazione specifica. Clicca su Save & activate. La connessione passa allo stato Active.
Con la connessione Active, attiva Require SSO for all users on your domain. Ogni email di quel dominio accederà tramite il tuo IdP. L'accesso con password o Google smetterà di funzionare per loro. Il tuo account proprietario resta escluso. Aggiungi fino a 20 break-glass emails per gli amministratori che devono poter usare una password di riserva se il tuo IdP non è raggiungibile.
Aggiungi almeno un'email break-glass prima di attivare l'obbligo. Senza, un'interruzione del tuo IdP escluderebbe tutti gli utenti del dominio dalla dashboard.
Come accedono gli utenti
L'accesso alla Dashboard SSO è email-first. Inserisci un'email aziendale nella schermata di login. Se il suo dominio ha una connessione SSO, Jamdesk ti reindirizza al tuo provider di identità. Non esiste un pulsante separato "Accedi con SSO".
Accedere tramite il tuo IdP non concede l'accesso. Ogni membro del team ha comunque bisogno di un invito a un progetto. Senza invito vede "Il tuo account non è stato configurato". Un accesso bloccato porta a una pagina di errore SSO che spiega il passo successivo.
Risoluzione dei problemi
Le modifiche DNS possono impiegare fino a un'ora per raggiungere Jamdesk. Attendi, poi clicca di nuovo su Verify. Se continua a fallire, controlla che nome e valore del record corrispondano esattamente a quelli della dashboard. Alcuni provider DNS aggiungono il tuo dominio al nome del record, trasformando _jamdesk in _jamdesk.acme.com.acme.com. Rimuovi il suffisso duplicato.
Jamdesk ricontrolla il record TXT del tuo dominio dopo la configurazione. Un record rimosso o modificato porta la connessione allo stato Disabled. Gli accessi smettono di essere instradati verso il tuo IdP. Ripristina il record nel DNS e clicca su Re-check status, oppure elimina la connessione e ricomincia.
Si è autenticato con il tuo provider di identità ma non è mai stato invitato a un progetto. Invitalo da Impostazioni → Members, poi fagli ripetere l'accesso. Vedi Membri del team.
L'obbligo è attivo. Ha tentato di accedere con password o Google invece che tramite il tuo IdP. Chiedigli di usare il flusso email-first, che lo reindirizza al tuo provider. Per una password di riserva (ad esempio se il tuo IdP è inattivo), aggiungi il suo indirizzo alla lista break-glass.
Abilitare l'SSO per il sito docs
Il nostro team configura la SSO per i lettori della documentazione. Verifichiamo i tuoi metadati, le mappature degli attributi e i filtri di gruppo prima di proteggere i tuoi documenti pubblicati.
Contatta le vendite Enterprise →
La pagina dei prezzi elenca i piani e il percorso di contatto Enterprise. Il nostro team configura l'IdP insieme a te, testa su un sottodominio di staging e passa in produzione quando sei pronto.
Alternative
Proteggi la documentazione senza Enterprise: