Erro de login com SSO (SAML/OIDC) em aplicativos de trabalho: diagnóstico prático e correções seguras
Se o seu aplicativo de trabalho recusa o login via SSO com mensagens enigmáticas como “não autorizado”, “token inválido” ou simplesmente volta para a tela inicial, respire fundo. Na maioria dos casos, três vilões respondem por quase todos os incidentes: desalinhamento de relógio (clock skew), mapeamento de atributos incorreto e certificados expirados. Pois bem, meus caros, este guia explica, em linguagem direta, como diagnosticar e corrigir cada um deles com método, segurança e sem perder tempo. É um passo a passo para quem precisa resolver hoje, com dicas de prevenção para não repetir o sufoco amanhã.
Entendendo o SSO na prática: o que o aplicativo espera de você (e do seu IdP)
O SSO com SAML ou OIDC é um acordo de confiança entre três peças: seu aplicativo (o “cliente” ou service provider), o servidor de identidade (identity provider, IdP) e o usuário. O aplicativo aceita você sem senha local, desde que receba um “bilhete” assinado e dentro da validade. Se o relógio está atrasado, o bilhete parece vencido. Se os atributos não batem, o porteiro não encontra seu nome na lista. Se o certificado expirou, ninguém confia na assinatura. Veja bem: os sintomas são parecidos, mas as causas são distintas. Acertar o diagnóstico evita trocas de configurações às cegas.
Sinais de cada causa (para diferenciar sem chute)
- Clock skew: erros intermitentes, pioram quando o dispositivo “dorme” ou após reinício de servidores; mensagens envolvendo “exp”, “nbf”, “NotBefore” ou “NotOnOrAfter”.
- Atributos: usuário chega a autenticar no IdP, mas o app nega acesso; logs mencionam “attribute”, “claim”, “mapping”, “NameID”, “groups” ou “e-mail ausente”.
- Certificado expirado: falhas súbitas após meses de estabilidade; erros de “signature validation”, “invalid signature”, “metadata outdated” ou “expired certificate”.
Clock skew em SAML e OIDC: por que 3 minutos derrubam seu login
O relógio é a régua do SSO. Tokens e assertions têm validade curta para reduzir risco. Se o horário do dispositivo, do servidor do aplicativo ou do IdP fica fora da janela de tolerância, a autenticação é recusada. Imagine dois porteiros combinando um código que só vale até 10h15. Se um relógio marca 10h13 e o outro 10h17, o código “expirou” para um deles.
Como diagnosticar clock skew em SAML
- 1) Capture a resposta SAML: no navegador, use as ferramentas de desenvolvedor para inspecionar a postagem SAML ou ative logs no aplicativo.
- 2) Decodifique o XML (é Base64), abra e confira os carimbos de tempo: IssueInstant, NotBefore e NotOnOrAfter.
- 3) Compare com o relógio do servidor e do cliente. Diferenças de poucos minutos já bastam para reprovar.
- 4) Verifique a tolerância configurada no provedor de serviço (aplicativo) e/ou no IdP. Algumas plataformas permitem “clock skew” de alguns minutos.
Como diagnosticar clock skew em OIDC
- 1) Descompacte e verifique o ID Token (JWT). Cheque as claims iat (emitido em), nbf (não antes de) e exp (expira em).
- 2) Compare horários entre dispositivo, servidor do app e IdP. Atenção a fuso horário incorreto e horário de verão mal configurado.
- 3) Observe intermitência: se falha vai e volta conforme a máquina “esquenta”, é provável desalinhamento.
Correções recomendadas para clock skew
- 1) Ative NTP confiável em todos os servidores envolvidos. No cliente, deixe o “Ajuste automático de data e hora” ligado.
- 2) Garanta o fuso correto, sem ajustes manuais locais para “adiantar” ou “atrasar” hora.
- 3) Defina uma janela de tolerância compatível com a realidade do seu ambiente. Evite exageros; tolerâncias grandes ampliam risco.
- 4) Sincronize hosts críticos antes de rolar mudanças e monitore o desvio periódico de relógio.
Dica de ouro: se o erro aparece “do nada” após uma manutenção ou reinício, valide o NTP primeiro. É solução rápida e, em muitos casos, resolve em minutos.
Mapeamento de atributos em SAML e OIDC: quando o usuário “existe”, mas o app não o encontra
Mesmo com horário em dia, o SSO falha se o mapeamento de atributos estiver fora do esperado. Pense no cadastro do prédio: se o porteiro procura “João Silva” e o crachá chega como “joao.s”, ele pode negar a entrada. O aplicativo precisa de atributos específicos, com nomes corretos e valores padronizados.
Atributos-chave em SAML
- NameID: comumente o identificador principal. Deve casar com o que o app espera (e-mail, UUID, etc.).
- E-mail e nome: atributos como “email”, “mail”, “givenName”, “sn”; padronize o nome exato exigido.
- Grupos/perfis: usados para autorização. Verifique nomes e escopos; às vezes o app espera “Admins” e você envia “admin”.
Claims essenciais em OIDC
- sub: sujeito único, imutável. Ideal para vínculo interno.
- email e email_verified: muitos apps exigem e-mail validado.
- preferred_username ou upn (quando disponível): útil para exibição e busca.
- groups/roles: para controle de acesso; alinhe nomes e formatação.
Passo a passo para corrigir mapeamento
- 1) Liste o que o app precisa: identifique atributos/claims obrigatórios e seus nomes exatos.
- 2) Confira no IdP: ajuste políticas de liberação e transformações (por exemplo, normalizar domínio do e-mail).
- 3) Teste um usuário representativo: valide presença, valores e capitalização dos atributos.
- 4) Padronize grupos: documente nomes e convenções; evite espaços e acentos, se o app não suportar.
- 5) Evite depender de e-mail mutável como identificador. Prefira um ID estável (NameID persistente ou sub).
Certificados expirados e rotação de chaves: a assinatura que ninguém aceita
No SSO, a confiança é selada por certificados e chaves. Quando expiram ou são trocados sem atualização do outro lado, as assinaturas deixam de ser válidas. É como tentar entrar com um crachá vencido: a catraca não abre, ainda que você seja funcionário.
Como identificar problema de certificado
- Erros de validação de assinatura: “invalid signature”, “signature verification failed”.
- Metadados desatualizados: o app ainda conhece a chave antiga do IdP, ou vice-versa.
- Falha súbita em todos os usuários: indica ruptura global, comum após expiração.
Correção segura e sem downtime desnecessário
- 1) Revise a cadeia de confiança: certificado do IdP, do aplicativo e, quando aplicável, da autoridade certificadora intermediária.
- 2) Atualize metadados automaticamente quando possível. Em SAML, reimporte o XML do IdP; em OIDC, valide o documento de configuração e as chaves públicas publicadas.
- 3) Planeje rotação de chaves com sobreposição: publique a nova chave, mantenha a antiga até a propagação e só depois remova a velha.
- 4) Agende lembretes com antecedência para a data de expiração e teste em ambiente de homologação antes da troca em produção.
Aprendizado de campo: não existe “troca invisível” de certificado. Se o outro lado não souber da nova chave, a porta fecha. Documente o procedimento e tenha um plano de volta.
Checklist rápido de diagnóstico: SAML e OIDC sem mistério
- 1) Coletar evidências: logs do app, do IdP e do navegador. Guarde o horário exato do erro.
- 2) Validar relógio: NTP ativo, fuso correto, sem manipulações manuais. Conferir timestamps do token/assertion.
- 3) Conferir assinatura: certificado vigente, cadeia completa, metadados atualizados.
- 4) Revisar atributos/claims: nomes, presença, valores e correspondência com as exigências do app.
- 5) Testar usuário de controle: perfil simples, sem regras especiais, para isolar variáveis.
- 6) Regredir mudanças recentes: se o problema começou após uma alteração, revise-a primeiro.
Boas práticas para não voltar ao erro: prevenção com prudência e praticidade
Vamos com calma: não é bicho de sete cabeças evitar reincidência. Com rotina e método, o SSO fica previsível.
- Sincronização contínua: monitore desvio de relógio e alerte quando passar do limite definido.
- Governança de atributos: padronize nomes e mantenha catálogo acessível às equipes.
- Gestão de certificados: calendário de expiração, rotação com sobreposição e testes programados.
- Observabilidade: dashboards para taxa de falha por causa provável (tempo, assinatura, atributo).
- Comunicação: mudanças no IdP ou no app devem ter janela e contrachecagem entre as equipes.
Na ponta do lápis, segurança não se negocia. Eu mesmo, certa vez, quase caí num golpe de mensagem urgente no celular; só escapei porque liguei antes de transferir. Em SSO, a lógica é parecida: confie, mas verifique. Tokens, certificados e horários existem para isso.
Exemplos práticos de análise: do sintoma à solução
Caso 1: login funcionava de manhã e falha à tarde
Suspeita de clock skew. Verifique NTP do servidor do app e o fuso do IdP. Ajuste a tolerância em minutos, sincronize relógios, repita o teste.
Caso 2: usuário autenticado, mas sem acesso ao painel
Indício de mapeamento de grupos. Confira se a claim/atributo “groups” ou “roles” contém a grafia exata esperada. Corrija capitalização e espaços. Atualize o cache de autorização, se houver.
Caso 3: falha geral após atualização de segurança
Provável certificado trocado sem atualização do outro lado. Reimporte metadados, valide chaves públicas e teste com usuário de controle. Planeje rotação com sobreposição na próxima janela.
Guia de validação final antes de encerrar o incidente
- Relógio: tokens aceitos dentro da janela; sem erros de “not before” ou “expired”.
- Assinatura: verificação positiva no app e no IdP; metadados coerentes.
- Atributos: presentes, com nomes corretos e valores esperados para todos os perfis.
- Reprodutibilidade: login funcionando em desktop e móvel; usuário novo e veterano.
- Documentação: lições aprendidas registradas e próximos passos de prevenção definidos.
Perguntas frequentes (FAQ)
Qual a tolerância de clock skew recomendada para SSO?
Depende do seu ambiente e dos padrões internos. Em geral, poucos minutos bastam para acomodar pequenas diferenças sem ampliar riscos. O fundamental é manter NTP confiável e monitorar desvios.
É melhor usar e-mail ou um identificador fixo como NameID/sub?
Para vinculação interna, prefira um identificador estável e imutável, como NameID persistente no SAML ou sub no OIDC. O e-mail pode mudar e quebrar acessos.
Como saber se o problema é de certificado ou de atributo?
Se a falha é global e fala em “assinatura inválida” ou “metadados”, tende a ser certificado. Se o usuário autentica mas não entra ou perde permissões, olhe atributos/claims e grupos.
Por que funciona no navegador e falha no aplicativo móvel?
Aplicativos móveis sofrem mais com relógios incorretos, caches desatualizados e diferenças de fuso. Valide data/hora do aparelho, limpe cache do app e compare as claims/atributos recebidos.
Preciso reiniciar o IdP para trocar o certificado?
Nem sempre. Em muitos cenários, basta publicar a nova chave, atualizar metadados no parceiro e manter a antiga por um período de sobreposição. Planeje e teste antes para evitar interrupções.
Convite final
Se este passo a passo ajudou, aplique agora mesmo a verificação de relógio, atributos e certificados no seu ambiente. Deixe um comentário com sua dúvida ou compartilhe seu caso: posso orientar nos próximos tutoriais. E, se quiser se aprofundar, navegue por mais guias práticos no perfectapp.com.br.