reCAPTCHA Enterprise

O reCAPTCHA Enterprise é um serviço do Google que protege sites contra fraudes e abusos usando detecção avançada de bots sem prejudicar a experiência do usuário. Este guia irá orientá-lo no processo de configuração do reCAPTCHA Enterprise com o Logto.

Pré-requisitos

• Um projeto no Google Cloud

Configurar uma chave reCAPTCHA

1. Acesse a página do reCAPTCHA no Google Cloud Console.
2. Clique no botão Criar chave próximo a "Chaves reCAPTCHA".
3. Preencha o formulário com os seguintes detalhes:
   • Nome de exibição: Qualquer nome que você queira dar à chave
   • Tipo de aplicação: Website
   • Lista de domínios: Adicione o domínio do endpoint do Logto
   • Tipo de verificação: Escolha entre Baseado em pontuação (invisível) ou Desafio de caixa de seleção. Isso determina como o reCAPTCHA será exibido para os usuários. Veja Modo de verificação para mais detalhes.
4. Após criar a chave, você será redirecionado para a página de detalhes da chave, copie o ID.

Configurar uma chave de API

1. Acesse a página de credenciais do Google Cloud Console.
2. Clique no botão Criar credenciais e selecione Chave de API.
3. Copie a chave de API.
4. Opcionalmente, você pode restringir a chave de API para reCAPTCHA Enterprise API para torná-la mais segura.
5. Lembre-se de deixar "Restrições de aplicação" como Nenhuma se você não souber o que é.

Obter o ID do projeto

1. Copie o ID do projeto na página inicial do Google Cloud Console.

Modo de verificação

O reCAPTCHA Enterprise suporta dois modos de verificação:

• Invisível: Verificação baseada em pontuação que roda automaticamente em segundo plano sem interação do usuário. Este é o modo padrão.
• Caixa de seleção: Exibe o clássico widget de caixa de seleção "Não sou um robô" que exige interação do usuário.

nota:

O modo de verificação que você selecionar no Logto deve corresponder ao tipo de chave criada no Google Cloud Console. Se você criou uma chave baseada em pontuação, selecione Invisível. Se você criou uma chave de desafio de caixa de seleção, selecione Caixa de seleção.

Traga sua própria UI

Se você usa Traga sua própria UI, o Logto não pode injetar ou executar o reCAPTCHA automaticamente no seu frontend personalizado. Após ativar o CAPTCHA no Logto Console, sua UI personalizada deve carregar o script do reCAPTCHA Enterprise, obter um token CAPTCHA e enviá-lo para a Experience API.

Para o modo Invisível, carregue o script com sua chave do site:

<script src="https://www.google.com/recaptcha/enterprise.js?render=<siteKey>" async defer></script>

Se você configurou um domínio personalizado no Logto, substitua www.google.com por esse domínio, por exemplo recaptcha.net.

Antes de iniciar a interação, execute o reCAPTCHA com a ação fixa interaction e passe o token retornado como captchaToken em PUT /api/experience:

const captchaToken = await grecaptcha.enterprise.execute('<siteKey>', {
  action: 'interaction',
});

await fetch('/api/experience', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    interactionEvent: 'SignIn',
    captchaToken,
  }),
});

Para o modo Caixa de seleção, carregue o script com render=explicit, renderize o widget em sua página e use o token de callback como captchaToken ao chamar PUT /api/experience.

Domínio personalizado

Por padrão, o Logto carrega o script do reCAPTCHA de www.google.com. No entanto, em algumas regiões onde o domínio padrão do Google é inacessível, você pode configurar um domínio alternativo.

Domínios suportados:

• www.google.com (padrão)
• recaptcha.net

Para configurar um domínio personalizado, insira o domínio no campo Domínio ao configurar o reCAPTCHA Enterprise no Logto Console.

Ativar CAPTCHA

Lembre-se de ativar a proteção contra bots CAPTCHA após configurar o provedor de CAPTCHA.

Acesse a página de Segurança, encontre a guia CAPTCHA e ative o botão de alternância "Ativar CAPTCHA".