Configurar OIDC SSO

OIDC é uma alternativa ao SAML para conectar seu provedor de identidade. Ambos permitem que sua equipe faça login com as contas corporativas existentes; OIDC é um protocolo mais moderno preferido por alguns provedores. Se você não tiver certeza de qual usar, use SAML — é o padrão e funciona com todos os provedores suportados. Procure OIDC quando seu provedor recomendar ou quando SAML não for uma opção para você.

A configuração tem o mesmo formato do SAML — configure, verifique seu domínio, teste e ligue — com alguns detalhes específicos do OIDC.

Antes de começar

  • Uma conta de administrador com permissão para gerenciar o logon único.
  • Acesso ao console de administração do seu provedor de identidade.
  • Um domínio que você pode verificar (o domínio de e-mail com o qual sua equipe faz login).

Abra o assistente de configuração

  1. Vá para Gerenciamento de usuários → Logon único.
  2. Escolha Configurar logon único.
  3. Escolha seu provedor e mude o protocolo para OIDC.

Troque configurações com seu provedor de identidade

  1. Crie um novo aplicativo OIDC (ou "OpenID Connect") no console do seu provedor. Kliv mostra o URL de redirecionamento para colar.
  2. Seu provedor fornece um ID do cliente, um segredo do cliente e um URL do emissor (o endereço da Web que identifica o serviço de login do seu provedor). Cole todos os três em Kliv.
  3. O URL do emissor deve corresponder ao seu provedor exatamente, caractere por caractere. Esta é a coisa mais comum de errar:
    • Os emissores do Microsoft Entra são específicos do seu locatário e incluem um identificador longo. Copie-o do seu próprio aplicativo, não reutilize um de um guia.
    • Google publica seu emissor em mais de uma forma; use exatamente o que seu console mostra.

Se o emissor estiver um pouco errado, os logins válidos serão rejeitados. A etapa de teste abaixo dirá se esse é o problema.

Kliv salva isso como um rascunho — configurado, mas não ativo. Sua equipe continua fazendo login como faz hoje até você terminar.

Verifique seu domínio

Tal como acontece com SAML, Kliv não criará contas do seu provedor até que você prove que controla o domínio de e-mail. Siga Verifique seu domínio e retorne aqui quando aparecer Verificado.

Teste com um login real

  1. Escolha Testar login.
  2. Faça login no seu provedor exatamente como sua equipe fará.
  3. Em caso de sucesso, Kliv grava o teste e desbloqueia Ativar.
  4. Em caso de falha, Kliv mostra detalhes esperados versus recebidos para que você possa corrigir o emissor, segredo ou redirecionamento - consulte Solucionar problemas de login SSO com falha.

Ligue

Depois que o login de teste for bem-sucedido, escolha Ativar. As pessoas em seu domínio verificado agora são enviadas ao seu provedor para fazer login, e os primeiros logins criam automaticamente uma conta de membro padrão.

Novos membros obtêm acesso apenas de membro — sem função elevada, a menos que você configure mapeamento de grupo.

Uma observação sobre a identidade do usuário

OIDC identifica cada pessoa por um par estável de valores do seu provedor, não pelo endereço de e-mail. Isso é deliberado: significa que uma pessoa mantém a mesma conta Kliv mesmo que seu e-mail mude, e significa que Kliv não depende de seu provedor marcar um e-mail como “verificado” (alguns provedores não enviam isso para contas de trabalho). Você não precisa configurar nada para isso — é apenas útil saber por que um e-mail alterado não cria uma conta duplicada.