Configura OIDC SSO

OIDC è un'alternativa a SAML per connettere il tuo provider di identità. Entrambi consentono al tuo team di accedere con i propri account aziendali esistenti; OIDC è un protocollo più moderno preferito da alcuni provider. Se non sei sicuro di quale utilizzare, utilizza SAML: è l'impostazione predefinita e funziona con tutti i provider supportati. Opta per OIDC quando il tuo provider lo consiglia o quando SAML non è un'opzione per te.

La configurazione ha la stessa forma di SAML: configura, verifica il tuo dominio, testa, quindi attiva, con alcuni dettagli specifici di OIDC.

Prima di iniziare

  • Un account amministratore con autorizzazione per gestire il Single Sign-On.
  • Accesso alla console di amministrazione del tuo provider di identità.
  • Un dominio che puoi verificare (il dominio email con cui accede il tuo team).

Apri la procedura guidata di configurazione

  1. Vai a Gestione utenti → Single Sign-On.
  2. Scegli Configura Single Sign-On.
  3. Scegli il tuo provider, quindi cambia il protocollo in OIDC.

Scambia le impostazioni con il tuo provider di identità

  1. Crea una nuova applicazione OIDC (o "OpenID Connect") nella console del tuo provider. Kliv ti mostra l'URL di reindirizzamento da incollare.

  2. Il tuo provider ti fornisce un ID client, un client secret e un URL dell'emittente (l'indirizzo web che identifica il servizio di accesso del tuo provider). Incolla tutti e tre in Kliv.

  3. L'URL dell'emittente deve corrispondere esattamente al tuo provider, carattere per carattere. Questo è l'errore più comune:

    • Gli emittenti Microsoft Entra sono specifici per il tuo tenant e includono un identificatore lungo: copialo dalla tua app, non riutilizzarne uno da una guida.
    • Google pubblica il proprio emittente in più di una forma; usa quello esatto mostrato dalla tua console.

    Se l'emittente è anche solo leggermente errato, gli accessi validi vengono rifiutati. Il passaggio di prova qui sotto ti dirà se è questo il problema.

Kliv lo salva come bozza: configurata ma non ancora attiva. Il tuo team continua ad accedere come fa oggi finché non finisci.

Verifica il tuo dominio

Come con SAML, Kliv non creerà account dal tuo provider finché non avrai dimostrato di controllare il dominio email. Segui Verifica il tuo dominio, quindi torna qui una volta visualizzato Verificato.

Prova con un accesso reale

  1. Scegli Prova accesso.
  2. Accedi al tuo provider esattamente come farà il tuo team.
  3. In caso di successo, Kliv registra il test e sblocca Attiva.
  4. In caso di errore, Kliv mostra i dettagli attesi rispetto a quelli ricevuti in modo da poter correggere l'emittente, il segreto o il reindirizzamento: vedi Risolvere i problemi di accesso SSO non riuscito.

Attivalo

Una volta completato l'accesso di prova, scegli Attiva. Le persone sul tuo dominio verificato vengono ora inviate al tuo provider per accedere e il primo accesso crea automaticamente un account membro standard.

I nuovi membri ottengono solo l'accesso come membri: nessun ruolo elevato a meno che non configuri la mappatura dei gruppi.

Una nota sull'identità dell'utente

OIDC identifica ogni persona tramite una coppia stabile di valori del tuo provider, non tramite il suo indirizzo email. Questo è intenzionale: significa che una persona mantiene lo stesso account Kliv anche se la sua email cambia, e significa che Kliv non dipende dal fatto che il tuo provider contrassegni un'email come "verificata" (alcuni provider non la inviano per gli account di lavoro). Non è necessario configurare nulla per questo: è semplicemente utile sapere perché un'e-mail modificata non crea un account duplicato.