Depuração do login
Trabalhe de cima para baixo. A maioria dos problemas é URI de redirecionamento incorreta, tipo de cliente errado ou limites de cookies / armazenamento no navegador.
1. Redirecionamento e ambiente (2 minutos)
- A URL de callback no navegador coincide caractere a caractere com uma URI de redirecionamento permitida (esquema, host, caminho, barra final).
- Você está testando o mesmo ambiente (app de homologação vs produção) que corresponde ao client ID em uso.
- HTTPS em produção onde você registrou
https://— callbackshttpmisturados falham em silêncio ou com erros OAuth.
2. Tipo de cliente e segredos
- App somente no navegador: use PKCE, não um client secret em JavaScript.
- Troca no servidor: cliente confidencial + secret apenas no servidor — veja Clientes confidenciais no servidor.
- Se você rotacionou segredos ou mudou público vs confidencial recentemente, limpe variáveis de ambiente antigas e faça deploy de novo.
3. Navegador e cookies
- Experimente anônimo para descartar cookies antigos ou extensões.
- Safari / ITP e políticas de cookies de terceiros: prefira redirecionamentos first-party e padrões descritos em Sessões, cookies e tokens.
- Pop-ups bloqueados pelo navegador ou bloqueadores — para teste, use fluxo completo de redirecionamento.
4. Ainda falhando?
Reúna este pacote antes de Contato e suporte:
- URL da página (homologação ou produção) e navegador + versão.
- Tipo de app (SDK React, JS puro, SPA, troca no servidor).
- Mensagem de erro ou código de erro OAuth (captura ou texto exato).
- Se já funcionou e o que mudou (lista de redirects, domínio, deploy).
Titulares podem começar pela Checklist do titular (login). Integradores: Visão geral para integradores.
Last updated