Solucionar problemas de login SSO com falha
Quando um login por meio de seu provedor de identidade não funciona, o Kliv foi criado para informar a solução real - e não apenas "falha no login". Esta página mostra onde procurar e como ler o que você encontra.
Onde mora a resposta
Existem duas visões diferentes sobre uma falha de login, propositalmente:
- A pessoa que faz login vê uma mensagem simples "não foi possível fazer login" com um breve ID de referência. Eles não veem os detalhes técnicos — isso vazaria como sua identidade está configurada.
- Você, o administrador, vê o diagnóstico completo no log de auditoria. É para onde aponta o ID de referência.
Portanto, quando um colega de equipe relatar uma falha no login, peça o ID de referência e procure-o.
Leia o diagnóstico
- Vá para Gerenciamento de usuários → Logon único e abra a guia Auditoria.
- Encontre a falha de login (corresponda ao ID de referência ou apenas observe as entradas mais recentes).
- Abra-o para ver os detalhes do esperado versus recebido: para cada verificação executada pelo Kliv, o que ele esperava e o que seu provedor realmente enviou. A incompatibilidade é a sua solução.
Você pode executar a etapa Testar login na página Single Sign-On para reproduzir uma falha sob demanda enquanto você trabalha nela, sem envolver usuários reais.
Causas e soluções comuns
O emissor não corresponde (OIDC). O problema OIDC mais frequente. O URL do emissor deve corresponder ao seu provedor, caractere por caractere. Os emissores do Microsoft Entra são específicos do seu locatário; Google publica mais de um formulário. Copie o emissor exato do seu próprio aplicativo provedor e cole-o no Kliv.
O certificado de assinatura expirou (SAML). Os logins que funcionaram ontem falharam repentinamente. O certificado de assinatura do seu provedor expirou. Carregue o certificado atual (ou atualize a partir dos metadados do seu provedor). O cartão de status avisa antes que isso aconteça — fique atento.
O domínio de e-mail do usuário não foi verificado. Kliv cria contas apenas para domínios de e-mail que você comprovadamente controla. Se um login for rejeitado para um domínio não verificado, conclua Verifique seu domínio para esse domínio.
A conta está desativada. Se a pessoa foi desativada no seu provedor de identidade ou no Kliv, o login é recusado intencionalmente — um login do SSO nunca reativa silenciosamente uma conta desativada. Reative-os em seu provedor se eles precisarem ter acesso.
A identidade (NameID) não é estável. Se o seu provedor enviar um identificador diferente a cada vez ou enviar um e-mail em vez de um ID estável, Kliv não poderá reconhecer a mesma pessoa com segurança. Configure seu provedor para enviar o identificador estável que a predefinição especifica para ele.
Um e-mail não é marcado como "verificado". Kliv não exige isso - ele identifica as pessoas por um identificador de provedor estável, não por um sinalizador de e-mail verificado - portanto, uma marca "verificado" ausente não é a causa. Veja as outras verificações.
Se você ainda está preso
O detalhe esperado versus recebido nomeia a verificação específica que falhou e oferece orientação baseada no provedor. Faça essa verificação, corrija-a no seu provedor e execute novamente Testar login. Como a ativação exigia um teste bem-sucedido, uma configuração que funcionou antes e parou repentinamente é quase sempre um certificado expirado ou uma configuração alterada por parte do seu provedor.