> ## 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 X (Twitter)

> Configure o X (antigo Twitter) como provedor de login social para a autenticação do seu app

Este guia explica como criar um app OAuth do X no Portal do Desenvolvedor do X. 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 no Portal do Desenvolvedor do X. Para o fluxo geral do Clerk Auth — incluindo como ativar o X 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 de desenvolvedor do X](https://developer.twitter.com/) (nível gratuito disponível)
* 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 **X** aberto em: **painel Auth** → aba **Configurar** → seção **Provedores SSO** → selecione o ambiente de **Produção** → selecione **Editar** ao lado de **X**

## Etapa 1: Configurar o app de desenvolvedor do X

### Criar uma conta de desenvolvedor (se necessário)

1. Acesse o [Portal do Desenvolvedor do X](https://developer.twitter.com/en/portal/dashboard)
2. Solicite uma conta de desenvolvedor caso ainda não tenha uma
3. Preencha o formulário descrevendo seu caso de uso

### Criar ou selecionar um app

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

## Etapa 2: Configurar a autenticação

1. Role até **User authentication settings**
2. Selecione **Set up**

**Permissões do app:**

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)

<Warning>
  As permissões devem corresponder aos escopos solicitados. Se o seu app solicitar `tweet.write`, mas você habilitou apenas Read, a autenticação falhará.
</Warning>

**Tipo de app:**

Selecione **Web App, Automated App or Bot**

**Informações do app:**

* **Callback URI / Redirect URL**: Copie o valor exibido em **Configuração do provedor** no **painel Auth**
* **Website URL**: Copie o valor exibido 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 encontrar esses valores.

3. Selecione **Save**
4. **Salve seu Client ID e Client Secret**

<Warning>
  Armazene seu Client Secret com segurança. Se perdido, gerá-lo novamente invalida o anterior.
</Warning>

## Solução de problemas

### URI de redirecionamento incompatível

* Verifique se a Callback URI 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 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 escopo/permissão

* Verifique se os escopos correspondem às permissões habilitadas no Portal do Desenvolvedor do X
* Certifique-se de que a permissão Read está habilitada no mínimo

### App em modo de desenvolvimento

* Os apps do X começam no modo de desenvolvimento com usuários limitados
* Pode ser necessário solicitar acesso elevado para uso em produção

### Não funciona no domínio personalizado

* Atualize a Website URL e a Callback URI com os valores do domínio personalizado exibidos em **Configuração do provedor** no **painel Auth**

## Recursos adicionais

* [Documentação do OAuth 2.0 do X](https://developer.twitter.com/en/docs/authentication/oauth-2-0)
* [Escopos OAuth do X](https://developer.twitter.com/en/docs/authentication/oauth-2-0/authorization-code)