Saltar para o conteúdo principal
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.
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 na documentação do Clerk Auth.

​
Pré-requisitos

  • Uma conta de desenvolvedor do X (camada gratuita disponível)
  • 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 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
  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)
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.
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 para saber como encontrar esses valores.
  1. Selecione Save
  2. Salve o seu Client ID e Client Secret
Armazene seu Client Secret com segurança. Se você o perder, gerar um novo invalida o antigo.

​
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