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

  1. Vá para Gerenciamento de usuários → Logon único e abra a guia Auditoria.
  2. Encontre a falha de login (corresponda ao ID de referência ou apenas observe as entradas mais recentes).
  3. 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.