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

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

Este guia explica como criar um app OAuth do Google no Google Cloud Console. Você vai obter um **Client ID** e um **Client Secret**, além de configurar as origens JavaScript e os URIs de redirecionamento exigidos pelo Clerk.

<Note>
  Esta página cobre apenas a configuração do lado do provedor no Google Cloud Console. Para o fluxo geral do Clerk Auth — incluindo como ativar o Google 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

* Acesso ao [Google Cloud Console](https://console.cloud.google.com/)
* 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 **Google** aberto em: **painel Auth** → aba **Configurar** → seção **Provedores SSO** → selecione o ambiente de **Produção** → selecione **Editar** ao lado de **Google**

## Etapa 1: Criar um app OAuth do Google

Acesse o [Google Cloud Console](https://console.cloud.google.com/):

### Criar ou selecionar 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

### Configurar a tela de consentimento OAuth

1. Na barra lateral esquerda, selecione o ícone de menu (≡) e selecione **APIs e Serviços**
2. Selecione **Tela de consentimento OAuth**
3. Configure a tela de consentimento do seu app com as informações necessárias
4. Salve as alterações

### Criar credenciais OAuth

1. Em **APIs e Serviços**, selecione **Credenciais**
2. Selecione **Criar Credenciais** no topo e, em seguida, selecione **ID do cliente OAuth**
3. Escolha **Aplicativo da Web** como tipo de aplicativo
4. Defina as **Origens JavaScript autorizadas** e os **URIs de redirecionamento autorizados** com os valores exatos exibidos em **Configuração do provedor** no **painel Auth**. Adicione todos os valores listados — o domínio publicado e qualquer domínio personalizado estão incluídos. Consulte [Configurando credenciais OAuth para um provedor SSO](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) para saber como encontrá-los.
5. Selecione **Criar**
6. Salve seu **Client ID** e **Client Secret**

<Warning>
  Mantenha seu Client Secret seguro e nunca o envie para o controle de versão.
</Warning>

<Warning>
  O login com Google não funciona em navegadores incorporados ou webviews dentro de aplicativos. Os usuários precisam usar um navegador web padrão.
</Warning>

## Solução de problemas

### URI de redirecionamento incompatível

* Verifique se o URI de redirecionamento no Google Cloud Console corresponde exatamente ao valor exibido em **Configuração do provedor** 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 ser propagada

### Cliente inválido

* 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 no domínio personalizado

* Adicione as entradas do domínio personalizado exibidas em **Configuração do provedor** no **painel Auth** tanto nas Origens JavaScript autorizadas quanto nos URIs de redirecionamento autorizados
