Saltar para o conteúdo principal
Este guia mostra como criar um app OAuth do Google no Google Cloud Console. Você vai coletar um Client ID e um Client Secret, além de configurar as origens JavaScript e os URIs de redirecionamento que o Clerk exige.
Esta página cobre apenas a configuração do lado do provedor no Google Cloud Console. Para o fluxo completo do Clerk Auth — incluindo habilitar o Google e inserir credenciais no painel Auth — veja Configurando credenciais OAuth para um provedor SSO na documentação do Clerk Auth.

​
Pré-requisitos

  • Acesso ao Google Cloud Console
  • 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 Google aberto em: painel Auth → aba Configure → seção SSO providers → selecione o ambiente Production → selecione Edit ao lado de Google

​
Etapa 1: Crie um app OAuth do Google

Acesse o Google Cloud Console:

​
Crie ou selecione um projeto

  1. Selecione um projeto existente ou crie um novo no menu suspenso de projetos
  2. Você será redirecionado para o Dashboard do seu projeto

​
Configure a tela de consentimento OAuth

  1. Na barra lateral esquerda, selecione o ícone de menu (≡) e selecione APIs & Services
  2. Selecione OAuth consent screen
  3. Configure a tela de consentimento do seu app com as informações exigidas
  4. Salve suas alterações

​
Crie credenciais OAuth

  1. Em APIs & Services, selecione Credentials
  2. Selecione Create Credentials no topo, depois selecione OAuth client ID
  3. Escolha Web application como tipo de aplicativo
  4. Defina Authorized JavaScript origins e Authorized redirect URIs com os valores exatos mostrados em Provider setup no painel Auth. Adicione todos os valores listados — tanto o seu domínio publicado quanto qualquer domínio personalizado são incluídos. Veja Configurando credenciais OAuth para um provedor SSO para saber como encontrá-los.
  5. Selecione Create
  6. Salve seu Client ID e Client Secret
Mantenha seu Client Secret seguro e nunca o envie para o controle de versão.
O login do Google não funciona em navegadores incorporados ou webviews dentro de apps. Os usuários precisam usar um navegador web padrão.

​
Solução de problemas

​
URI de redirecionamento incompatível (Redirect URI mismatch)

  • Verifique se o URI de redirecionamento no Google Cloud Console corresponde exatamente ao valor mostrado em Provider setup no painel Auth
  • Certifique-se de que não há barras finais ou erros de digitação
  • Aguarde alguns minutos para a configuração do Google se propagar

​
Cliente inválido (Invalid client)

  • Verifique se o Client ID e o Client Secret foram copiados corretamente
  • Certifique-se de que não há espaços extras
  • Verifique se a tela de consentimento OAuth está configurada

​
Não funciona em domínio personalizado

  • Adicione as entradas de domínio personalizado mostradas em Provider setup no painel Auth tanto em Authorized JavaScript origins quanto em Authorized redirect URIs