Este guia trata de usuários que fazem login em um aplicativo que você criou. Para problemas ao
entrar na sua conta do Replit, veja Conta e acesso.
Identifique primeiro o sistema de autenticação
Pergunte ao Agent: “Este aplicativo usa Replit Auth, Clerk Auth gerenciado pelo Replit ou um
provedor de autenticação configurado separadamente?”
- Replit Auth: os usuários fazem login com contas do Replit.
- Clerk Auth gerenciado pelo Replit: seu aplicativo tem contas de usuário próprias e configuração de autenticação gerenciada.
- Sua própria conta do Clerk ou outro provedor: verifique a configuração desse provedor, além do aplicativo.
No caso do Clerk, confirme se o Agent provisionou a integração ou se você forneceu
credenciais da sua própria conta do Clerk. Não misture a configuração dos dois.
Não exclua nem recrie um tenant de autenticação para corrigir um erro de login.
Excluir um tenant pode excluir contas de usuário. Não troque de provedor nem substitua
credenciais sem um plano de migração para os usuários existentes.
O login funciona no Preview, mas falha após a publicação
- Teste o Preview e o aplicativo publicado separadamente. Registre a falha exata.
- No caso do Clerk, verifique se o ambiente de desenvolvimento ou de produção pretendido está selecionado.
Os usuários e a configuração de cada um são separados.
- Verifique se o aplicativo publicado tem as variáveis de ambiente de autenticação necessárias.
Inspecione os nomes e o status da configuração; não cole os valores no chat.
- Se você usa seu próprio provedor, compare as origens permitidas e as URLs de callback
com o nome de host e o protocolo exatos do aplicativo publicado.
- Publique qualquer alteração de configuração pretendida e teste em uma sessão de navegador nova.
Para um redirect_uri_mismatch do OAuth, compare o URI de redirecionamento real com o
URI registrado no provedor. Não adivinhe um caminho de callback nem adicione acesso com curinga
como solução alternativa.
Apenas um provedor de login social falha
Teste outro método de login habilitado para isolar a falha. Verifique a configuração do
provedor com falha quanto ao ambiente, domínio e URI de callback corretos.
Para o Clerk gerenciado, siga Clerk Auth
em vez de criar um tenant substituto.
Usuários parecem estar ausentes
Confirme o projeto, o provedor de autenticação e o ambiente antes de alterar
qualquer coisa. Uma conta de desenvolvimento não comprova que a mesma conta
existe em produção. Um projeto copiado ou remixado pode usar uma configuração de autenticação diferente;
não presuma que os usuários foram migrados junto com o código.
Um domínio personalizado causa erros de login
Primeiro teste a URL publicada padrão. Se apenas o domínio personalizado falhar, siga
o guia de domínios e depois verifique a configuração de
domínio do provedor de autenticação. O DNS de hospedagem e o DNS de autenticação são verificações separadas.
Se um domínio for informado como já associado a outro aplicativo de autenticação,
entre em contato com o Suporte no caso de uma integração gerenciada ou com seu provedor no caso de uma
autogerenciada. Não exclua o aplicativo antigo apenas para liberar o domínio.
Os e-mails de verificação não chegam
Verifique o endereço, a pasta de spam e se a conta existe no ambiente pretendido.
Registre qualquer mensagem de erro ou de limite de taxa antes de tentar novamente. Evite
solicitar vários códigos em sequência e nunca compartilhe um código de verificação com o Suporte.
Inclua o provedor e o modo de gerenciamento, o ambiente, o método de login com falha,
o nome de host afetado, o erro sem dados sensíveis e a hora com o fuso horário. Informe se outros
métodos funcionam. Não inclua tokens, cookies, credenciais ou listas de usuários.
Use a lista de verificação para o suporte.