> ## 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.

# Configure GitHub OAuth

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

Este guia apresenta o passo a passo para criar um app OAuth do GitHub nas Configurações de Desenvolvedor do GitHub. Você coletará 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 ativar o GitHub e inserir as credenciais no **painel Auth** — consulte [Configurando credenciais OAuth para um provedor SSO](/core-concepts/project-editor/auth-and-security/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](/category/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 **Configure** → seção **SSO providers** → selecione o ambiente **Production** → selecione **Edit** ao lado de **GitHub**

## Passo 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 mostrados em **Provider setup** no **painel Auth**. Consulte [Configurando credenciais OAuth para um provedor SSO](/core-concepts/project-editor/auth-and-security/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) para saber como encontrá-los.

5. Selecione **Register application**

## Passo 2: Gerar as 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 em local seguro. Não é possível visualizá-lo novamente após sair da página. Se perdido, será necessário gerar um novo.
</Warning>

## Solução de problemas

### Incompatibilidade de URI de redirecionamento

* 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

* Verifique novamente 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 está funcionando no domínio personalizado

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