Skip to main content
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

  1. Teste o Preview e o aplicativo publicado separadamente. Registre a falha exata.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Ainda com falha?

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.