Saltar para o conteúdo principal
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.
Esta página cobre apenas a configuração do lado do provedor nas Configurações de Desenvolvedor do GitHub. Para o fluxo completo do Clerk Auth — incluindo habilitar o GitHub e inserir credenciais no painel Auth — veja Configurando credenciais OAuth para um provedor SSO na documentação do Clerk Auth.

Pré-requisitos

  • Uma conta do GitHub
  • Um app do Replit publicado — credenciais OAuth personalizadas só estão disponíveis no ambiente de Produção
  • O painel de edição do provedor GitHub aberto em: painel Auth → aba Configure → seção SSO providers → selecione o ambiente Production → selecione Edit ao lado de 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