> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar OAuth do GitHub

> Configure o GitHub como provedor de login social para a autenticação do seu app

Este guia explica como criar um app OAuth do GitHub nas Configurações de Desenvolvedor do GitHub. Você vai obter um **Client ID** e um **Client Secret** para inserir no **painel Auth**.

<Note>
  Esta página cobre apenas a configuração do lado do provedor nas Configurações de Desenvolvedor do GitHub. Para o fluxo geral do Clerk Auth — incluindo como ativar o GitHub e inserir as credenciais no **painel Auth** — consulte [Configurando credenciais OAuth para um provedor SSO](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) na documentação do Clerk Auth.
</Note>

## Pré-requisitos

* Uma [conta GitHub](https://github.com)
* Um [app Replit publicado](/learn/projects-and-artifacts/replit-deployments) — credenciais OAuth personalizadas estão disponíveis apenas no ambiente de **Produção**
* O painel de edição do provedor **GitHub** aberto em: **painel Auth** → aba **Configurar** → seção **Provedores SSO** → selecione o ambiente de **Produção** → selecione **Editar** ao lado de **GitHub**

## Etapa 1: Criar um app OAuth do GitHub

1. Acesse as [Configurações de Desenvolvedor do GitHub](https://github.com/settings/developers)
2. Selecione **OAuth Apps** na barra lateral
3. Selecione **New OAuth App**
4. Preencha os detalhes do aplicativo:

**Application name:**

Insira um nome para o seu aplicativo.

**Homepage URL** e **Authorization callback URL:**

Defina ambos com os valores exatos exibidos em **Configuração do provedor** no **painel Auth**. Consulte [Configurando credenciais OAuth para um provedor SSO](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) para saber como encontrá-los.

5. Selecione **Register application**

## Etapa 2: Gerar credenciais do cliente

1. Você verá 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

<Warning>
  Salve seu Client Secret com segurança. Você não poderá visualizá-lo novamente após sair da página. Se perdido, será necessário gerar um novo.
</Warning>

## Solução de problemas

### URI de redirecionamento incompatível

* Verifique se a Authorization callback URL corresponde exatamente ao valor exibido em **Configuração do provedor** no **painel Auth**
* Verifique se há erros de digitação ou protocolos incorretos
* Sem barras finais

### Cliente inválido

* 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 no domínio personalizado

* Atualize a Homepage URL e a Authorization callback URL com os valores do domínio personalizado exibidos em **Configuração do provedor** no **painel Auth**