Skip to main content
Quando seu app usa o Clerk Auth, os visitantes podem fazer login com provedores sociais. O Replit fornece credenciais compartilhadas prontas para uso; esta página cobre como trazer suas próprias credenciais OAuth para cada provedor, o que coloca o nome e a marca do seu app na tela de login. O fluxo é o mesmo para todos os provedores: crie um app OAuth no console do provedor, copie as URLs que o Replit mostra e cole as credenciais resultantes no painel de edição do provedor.
Credenciais OAuth personalizadas só estão disponíveis no ambiente de Produção, então seu app precisa estar publicado primeiro. Abra o painel de edição de cada provedor na ferramenta Users & Auth: aba Configure, seção SSO providers, selecione o ambiente Production e selecione Edit ao lado do provedor. Para o fluxo completo, veja Configurando credenciais OAuth para um provedor SSO.

​
Google

Este guia mostra como criar um app OAuth do Google no Google Cloud Console. Você vai coletar um Client ID e um Client Secret, além de configurar as origens JavaScript e os URIs de redirecionamento que o Clerk exige. Você precisa de: Acesso ao Google Cloud Console.

​
Etapa 1: Crie um app OAuth do Google

Acesse o Google Cloud Console:

​
Crie ou selecione um projeto

  1. Selecione um projeto existente ou crie um novo no menu suspenso de projetos
  2. Você será redirecionado para o Dashboard do seu projeto

​
Configure a tela de consentimento OAuth

  1. Na barra lateral esquerda, selecione o ícone de menu (≡) e selecione APIs & Services
  2. Selecione OAuth consent screen
  3. Configure a tela de consentimento do seu app com as informações exigidas
  4. Salve suas alterações

​
Crie credenciais OAuth

  1. Em APIs & Services, selecione Credentials
  2. Selecione Create Credentials no topo, depois selecione OAuth client ID
  3. Escolha Web application como tipo de aplicativo
  4. Defina Authorized JavaScript origins e Authorized redirect URIs com os valores exatos mostrados em Provider setup no painel Auth. Adicione todos os valores listados — tanto o seu domínio publicado quanto qualquer domínio personalizado são incluídos. Veja Configurando credenciais OAuth para um provedor SSO para saber como encontrá-los.
  5. Selecione Create
  6. Salve seu Client ID e Client Secret
Mantenha seu Client Secret seguro e nunca o envie para o controle de versão.
O login do Google não funciona em navegadores incorporados ou webviews dentro de apps. Os usuários precisam usar um navegador web padrão.

​
Solução de problemas

​
URI de redirecionamento incompatível (Redirect URI mismatch)

  • Verifique se o URI de redirecionamento no Google Cloud Console corresponde exatamente ao valor mostrado em Provider setup no painel Auth
  • Certifique-se de que não há barras finais ou erros de digitação
  • Aguarde alguns minutos para a configuração do Google se propagar

​
Cliente inválido (Invalid client)

  • Verifique se o Client ID e o Client Secret foram copiados corretamente
  • Certifique-se de que não há espaços extras
  • Verifique se a tela de consentimento OAuth está configurada

​
Não funciona em domínio personalizado

  • Adicione as entradas de domínio personalizado mostradas em Provider setup no painel Auth tanto em Authorized JavaScript origins quanto em Authorized redirect URIs

​
GitHub

Este guia mostra como criar um app OAuth do GitHub nas Configurações de Desenvolvedor do GitHub. Você vai coletar um Client ID e um Client Secret para inserir no painel Auth. Você precisa de: Uma conta do GitHub.

​
Etapa 1: Crie um app OAuth do GitHub

  1. Acesse as Configurações de Desenvolvedor do GitHub
  2. Selecione OAuth Apps na barra lateral
  3. Selecione New OAuth App
  4. Preencha os detalhes do aplicativo:
Application name: Digite um nome para o seu aplicativo. Homepage URL e Authorization callback URL: Defina ambos com os valores exatos mostrados em Provider setup no painel Auth. Veja Configurando credenciais OAuth para um provedor SSO para saber como encontrá-los.
  1. Selecione Register application

​
Etapa 2: Gere as credenciais do cliente

  1. Você vai ver o seu Client ID na página de configurações do app - copie-o
  2. Selecione Generate a new client secret
  3. Copie seu Client Secret imediatamente
Salve seu Client Secret com segurança. Você não conseguirá visualizá-lo novamente após sair da página. Se perdê-lo, você precisará gerar um novo.

​
Solução de problemas

​
URI de redirecionamento incompatível (Redirect URI mismatch)

  • Verifique se a Authorization callback URL corresponde exatamente ao valor mostrado em Provider setup no painel Auth
  • Verifique se há erros de digitação ou protocolos incorretos
  • Sem barras finais

​
Cliente inválido (Invalid client)

  • Verifique se o Client ID e o Client Secret foram copiados corretamente
  • Certifique-se de que não há espaços extras ao colar

​
Não funciona em domínio personalizado

  • Atualize a Homepage URL e a Authorization callback URL para os valores de domínio personalizado mostrados em Provider setup no painel Auth

​
Apple

Este guia mostra como criar o Apple App ID, o Services ID e a Private Key necessários para o Sign in with Apple. Você vai coletar um Team ID, Services ID, Key ID e Private Key para inserir no painel Auth. Você precisa de: Uma conta Apple Developer (requer inscrição no Apple Developer Program).

​
Etapa 1: Crie um Apple App ID

  1. Acesse o portal Apple Developer
  2. Vá em Certificates, IDs & Profiles e depois Identifiers
  3. Selecione App IDs no menu suspenso
  4. Selecione o ícone + para registrar um novo identificador
  5. Selecione App IDs, depois Continue
  6. Escolha App, depois Continue
  7. Preencha:
    • Description: Nome para o seu App ID
    • Bundle ID: Seu identificador único
  8. Habilite Sign In with Apple em Capabilities
  9. Selecione Continue, depois Register
  10. Salve o seu App ID Prefix (mostrado no topo) - este é o seu Team ID

​
Etapa 2: Crie um Apple Services ID

  1. Na página Identifiers, selecione Services IDs no menu suspenso
  2. Selecione + para registrar um novo identificador
  3. Selecione Services IDs, depois Continue
  4. Preencha:
    • Description: Nome para o seu Services ID
    • Identifier: Seu identificador único (salve isso - é o seu Services ID)
  5. Selecione Continue, depois Register

​
Configure o Services ID

  1. Selecione o Services ID que você acabou de criar
  2. Habilite Sign In with Apple
  3. Selecione Configure
  4. Defina:
    • Primary App ID: Selecione seu App ID da Etapa 1
    • Domains and Subdomains: Copie o valor mostrado em Provider setup no painel Auth (sem o prefixo de protocolo https://)
    • Return URLs: Copie o valor mostrado em Provider setup no painel Auth
    Veja Configurando credenciais OAuth para um provedor SSO para saber como encontrar esses valores.
  5. Selecione Next, depois Done, depois Continue, depois Save

​
Etapa 3: Crie uma Apple Private Key

  1. Na barra lateral do portal Apple Developer, selecione Keys
  2. Selecione + para registrar uma nova chave
  3. Digite um Key Name
  4. Habilite Sign In with Apple
  5. Selecione Configure, depois selecione seu App ID da Etapa 1
  6. Selecione Save, depois Continue, depois Register
  7. Salve o Key ID
  8. Baixe o arquivo da chave privada (.p8)
Você só pode baixar a chave privada uma vez. Armazene-a com segurança — você não conseguirá baixá-la novamente.

​
Etapa 4: Configure o Apple Private Email Relay

O recurso Hide My Email da Apple permite que os usuários façam login sem revelar o e-mail real. Para enviar e-mails a esses usuários, registre sua fonte de e-mail.
  1. Na barra lateral do portal Apple Developer, selecione Services
  2. Em Sign in with Apple for Email Communication, selecione Configure
  3. Selecione + para adicionar uma Email Source
  4. Digite o valor de Email Source mostrado em Provider setup no painel Auth
  5. Selecione Next, depois Register, depois Done
  6. Aguarde a verificação de DNS (ícone verde de confirmação)
Em algumas regiões (China, Índia), os Apple IDs podem estar vinculados a números de telefone em vez de e-mail. Se o seu app exigir e-mail para todos os usuários, o Sign in with Apple pode falhar para usuários dessas regiões.

​
Solução de problemas

​
Cliente inválido (Invalid client)

  • Verifique se todas as credenciais foram inseridas corretamente
  • Certifique-se de que a Private Key inclui as linhas BEGIN e END
  • Verifique se o seu Services ID está configurado corretamente

​
URI de redirecionamento inválida (Invalid redirect URI)

  • Verifique se a Return URL na configuração do Apple Services ID corresponde exatamente ao valor mostrado em Provider setup no painel Auth
  • Verifique se o domínio em Domains and Subdomains corresponde ao seu domínio publicado (sem https://)

​
Email relay não funciona

  • Verifique se a Email Source mostra um ícone verde de confirmação no portal Apple Developer
  • Aguarde a propagação do DNS se foi adicionada recentemente

​
Não funciona em domínio personalizado

  • Adicione as entradas de domínio personalizado mostradas em Provider setup no painel Auth em Domains and Subdomains (sem https://) e em Return URLs

​
Recursos adicionais

​
X (Twitter)

Este guia mostra como criar um app OAuth do X no X Developer Portal. Você vai coletar um Client ID e um Client Secret para inserir no painel Auth. Você precisa de: Uma conta de desenvolvedor do X (camada gratuita disponível).

​
Etapa 1: Configure o app de desenvolvedor do X

​
Crie uma conta de desenvolvedor (se necessário)

  1. Acesse o X Developer Portal
  2. Solicite uma conta de desenvolvedor se ainda não tiver uma
  3. Complete a inscrição descrevendo seu caso de uso

​
Crie ou selecione um app

  1. No X Developer Portal, vá em Projects & Apps
  2. Use um app existente ou selecione Add App
  3. Digite um nome para o app e selecione Next
  4. Selecione App settings

​
Etapa 2: Configure a autenticação

  1. Role até User authentication settings
  2. Selecione Set up
App permissions: Selecione o nível mínimo de permissão:
  • Read - Necessário para o perfil do usuário (mínimo)
  • Write - Para publicar em nome dos usuários (opcional)
  • Direct Messages - Para acesso a mensagens diretas (opcional)
As permissões precisam corresponder aos scopes solicitados. Se o seu app solicitar tweet.write mas você só habilitou Read, a autenticação vai falhar.
Type of app: Selecione Web App, Automated App or Bot App info:
  • Callback URI / Redirect URL: Copie o valor mostrado em Provider setup no painel Auth
  • Website URL: Copie o valor mostrado em Provider setup no painel Auth
Veja Configurando credenciais OAuth para um provedor SSO para saber como encontrar esses valores.
  1. Selecione Save
  2. Salve o seu Client ID e Client Secret
Armazene seu Client Secret com segurança. Se você o perder, gerar um novo invalida o antigo.

​
Solução de problemas

​
URI de redirecionamento incompatível (Redirect URI mismatch)

  • Verifique se o Callback URI corresponde exatamente ao valor mostrado em Provider setup no painel Auth
  • Verifique se há erros de digitação ou protocolos incorretos
  • Sem barras finais

​
Cliente inválido (Invalid client)

  • Verifique novamente o Client ID e o Client Secret
  • Certifique-se de que não há espaços extras
  • Verifique se você está usando credenciais OAuth 2.0 (não OAuth 1.0a)

​
Erros de scope/permissão

  • Verifique se os scopes correspondem às permissões habilitadas no X Developer Portal
  • Certifique-se de que a permissão Read está habilitada no mínimo

​
App em modo de desenvolvimento

  • Os apps do X começam em modo de desenvolvimento com usuários limitados
  • Você pode precisar solicitar acesso elevado para uso em produção

​
Não funciona em domínio personalizado

  • Atualize a Website URL e o Callback URI para os valores de domínio personalizado mostrados em Provider setup no painel Auth

​
Recursos adicionais