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

<Note>
  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](/pt/features/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 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 **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](https://console.cloud.google.com/):

### 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](/pt/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) para saber como encontrá-los.
5. Selecione **Create**
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 do Google não funciona em navegadores incorporados ou webviews dentro de apps. Os usuários precisam usar um navegador web padrão.
</Warning>

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