Configurar SAML SSO
O logon único (SSO) permite que sua equipe faça login no Kliv com as contas que já usam no trabalho — por meio do provedor de identidade da sua empresa (o serviço que gerencia os logins dos seus funcionários, como Okta ou Microsoft Entra). Nenhuma senha Kliv separada para gerenciar e, quando alguém sai, removê-lo de um só lugar remove o acesso aqui também.
SAML é a forma mais amplamente suportada de conectar um provedor de identidade. Esta página orienta você na configuração, no teste com um login real e na ativação - nessa ordem, para que nada aconteça para sua equipe.
Você configura tudo isso sozinho. Não há tíquete de suporte nem chamada de fornecedor.
Antes de começar
- Você precisa de uma conta de administrador com permissão para gerenciar o logon único da sua organização.
- Você precisará de acesso ao console de administração do seu provedor de identidade (Okta, Entra, Google Workspace, OneLogin ou outro provedor SAML).
- Tenha um domínio que você possa verificar — o domínio de e-mail com o qual sua equipe faz login (por exemplo
yourcompany.com).
Abra o assistente de configuração
- Vá para Gerenciamento de usuários → Logon único.
- Escolha Configurar logon único.
- Escolha seu provedor — Okta, Microsoft Entra, Google, OneLogin ou Other. Escolher um provedor conhecido preenche previamente as configurações corretas para que você tenha menos para copiar manualmente.
- Deixe o protocolo em SAML (o padrão). OIDC é uma alternativa avançada — veja Configurar OIDC SSO.
Troque configurações com seu provedor de identidade
SSO trabalha com seu provedor de identidade e Kliv confiando um no outro. Você dá a cada um alguns detalhes sobre o outro:
- Kliv mostra os valores que seu provedor precisa (como o URL de login que Kliv escuta). Copie-os para um novo aplicativo SAML no console de administração do seu provedor.
- Seu provedor fornece seus próprios detalhes — geralmente um URL de metadados ou um arquivo XML, além de um certificado de assinatura. Cole os metadados (ou carregue o arquivo) em Kliv.
- Certifique-se de que seu provedor envie um identificador estável para cada usuário, não apenas um endereço de e-mail. (O atributo exato é específico do provedor - a predefinição nomeia aquele a ser usado; confirme o texto em seu console.) Este é o valor que Kliv usa para reconhecer uma pessoa que retorna, mesmo que seu e-mail mude.
Kliv salva isso como um rascunho. Um rascunho está configurado, mas ainda não está ativo — sua equipe ainda assina da maneira que faz hoje até você terminar.
Verifique seu domínio
Antes que Kliv crie contas de seu provedor, você precisa provar que controla o domínio de e-mail que sua equipe usa. Isso impede que alguém reivindique um domínio que não é seu.
Siga Verifique seu domínio para adicionar um registro DNS ou arquivo ao seu site. Volte aqui quando aparecer Verificado.
Teste com um login real
Esta é a etapa que torna o SSO seguro para ligar: você prova que toda a viagem de ida e volta funciona antes de afetar alguém.
- No assistente, escolha Testar login.
- Você será enviado ao seu provedor de identidade para fazer login, exatamente como sua equipe fará.
- Se for bem-sucedido, Kliv registra o teste bem-sucedido e desbloqueia o botão Ligar.
- Se falhar, Kliv mostra o que esperava versus o que seu provedor realmente enviou — consulte Solucionar problemas de login SSO com falha. Corrija-o no seu provedor e teste novamente.
Você não pode ativar o SSO até que um login de teste seja bem-sucedido na configuração exata que você está prestes a ativar. Apenas salvar nunca é suficiente.
Ligue
Depois que o teste for aprovado, escolha Ativar. A partir de agora, quando alguém insere um endereço de e-mail em seu domínio verificado, Kliv o envia ao seu provedor de identidade para fazer login. Pessoas que fazem login pela primeira vez recebem uma conta Kliv criada automaticamente, com acesso de membro padrão.
Novos membros chegam apenas ao grupo de todos. Eles não recebem administrador ou qualquer função elevada do seu provedor de identidade, a menos que você configure isso deliberadamente - consulte Mapear grupos IdP para funções Kliv.
Após a configuração
Sua página de login único agora mostra um cartão de status em vez do assistente: seu provedor, seu domínio verificado, o último login bem-sucedido e um aviso se seu certificado de assinatura estiver prestes a expirar. Fique atento a esse aviso: um certificado expirado interrompe os logins até que você carregue um novo.
Para exigir que todos em seu domínio usem SSO (e mantenham um caminho seguro de volta caso ele quebre), consulte Exija SSO e defina administradores de emergência.