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

<Note>
  Esta página cobre apenas a configuração do lado do provedor no X Developer Portal. Para o fluxo completo do Clerk Auth — incluindo habilitar o X e inserir credenciais no **painel Auth** — veja [Configurando credenciais OAuth para um provedor SSO](/pt/features/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/) (camada gratuita disponível)
* Um [app do Replit publicado](/pt/learn/projects-and-artifacts/replit-deployments) — credenciais OAuth personalizadas só estão disponíveis no ambiente de **Produção**
* O painel de edição do provedor **X** aberto em: **painel Auth** → aba **Configure** → seção **SSO providers** → selecione o ambiente **Production** → selecione **Edit** ao lado de **X**

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

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

1. Acesse o [X Developer Portal](https://developer.twitter.com/en/portal/dashboard)
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)

<Warning>
  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.
</Warning>

**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](/pt/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) para saber como encontrar esses valores.

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

<Warning>
  Armazene seu Client Secret com segurança. Se você o perder, gerar um novo invalida o antigo.
</Warning>

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

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