Chave do site reCAPTCHA Enterprise versus chave API: guia de configuração

O reCAPTCHA Enterprise usa duas chaves diferentes – e confundi-las é um dos erros de configuração mais comuns. A chave do site renderiza o widget CAPTCHA na página. A chave de API autentica solicitações de verificação do servidor para o Google. Você precisa da chave do site ao enviar tarefas para CaptchaAI, não da chave da API.

As duas chaves explicadas

Chave do site (pública)

A chave do site está incorporada no HTML da página. Ele identifica qual configuração reCAPTCHA carregar:

<script src="https://www.google.com/recaptcha/enterprise.js?render=6LcR_RsTAAAAADge..."></script>

Ou em uma chamada grecaptcha.enterprise.execute:

grecaptcha.enterprise.execute('6LcR_RsTAAAAADge...', { action: 'login' });

Propriedades:

• Começa com 6L (mesmo prefixo do reCAPTCHA padrão)
• Visível na fonte da página – público por design
• Vinculado a domínios específicos no Console do Google Cloud
• Isso é o que CaptchaAI precisa para resolver o desafio

Chave API (privada)

A chave de API autentica a comunicação entre o servidor e o Google para verificação de token:

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments?key=AIzaSy...

Propriedades:

• Começa com AIzaSy (formato de chave da API do Google Cloud)
• Nunca exposto no código do lado do cliente
• Usado apenas pelo back-end do site para verificar tokens
• CaptchaAI não precisa desta chave

Comparação de chaves

reCAPTCHA Empresarial vs Padrão

O reCAPTCHA Enterprise difere da versão gratuita na forma como as chaves funcionam:

Encontrando a chave do site

Método 1: pesquisa na fonte da página

Pesquise o HTML por enterprise.js:

View Source → Ctrl+F → "enterprise.js"

O parâmetro render contém a chave do site:

<script src="https://www.google.com/recaptcha/enterprise.js?render=6LcR_RsTAAAAADge..."></script>

Método 2: console JavaScript

Execute no console do navegador:

// Check for Enterprise grecaptcha
if (window.grecaptcha && window.grecaptcha.enterprise) {
  console.log('reCAPTCHA Enterprise detected');
}

// Find site key from rendered widgets
document.querySelectorAll('[data-sitekey]').forEach(el => {
  console.log('Site key:', el.getAttribute('data-sitekey'));
});

Método 3: guia Rede

Filtre solicitações de rede para enterprise.js ou recaptcha/enterprise — a chave do site aparece no URL da solicitação ou na carga útil.

Enviando para CaptchaAI

Assim que tiver a chave do site, envie-a como parâmetro websiteKey:

POST https://ocr.captchaai.com/in.php

Parâmetros obrigatórios:

Parâmetros corporativos opcionais:

Como a verificação empresarial difere

Compreender o fluxo completo ajuda a explicar por que apenas a chave do site é importante para a solução:

1. Navegador carrega enterprise.js usando a chave do site
2. Navegador executa desafio e recebe token
3. Back-end do site envia token + chave de API para o endpoint assessments do Google
4. Google retorna pontuação de risco e detalhes da avaliação
5. O back-end do site decide se aceita com base na pontuação

CaptchaAI substitui as etapas 1–2. Ele gera um token válido usando a chave do site. O backend do site então verifica esse token com sua própria chave de API – CaptchaAI não está envolvido na verificação.

Solução de problemas

Perguntas frequentes

Como posso saber se um site usa o Enterprise ou o reCAPTCHA padrão?

Verifique o URL do script. A empresa carrega de /recaptcha/enterprise.js enquanto o padrão usa /recaptcha/api.js. No JavaScript, o Enterprise usa grecaptcha.enterprise.execute() em vez de grecaptcha.execute().

Posso usar a mesma chave de API CaptchaAI para padrão e empresarial?

Sim. Sua chave API CaptchaAI funciona para todos os tipos de CAPTCHA. Defina enterprise=1 em sua solicitação para indicar um desafio Enterprise — a solução é cobrada pela mesma taxa.

A rotação da chave API do site afeta minha solução?

Não. A chave de API é usada apenas para verificação no servidor entre o back-end do site e o Google. Não tem impacto na geração de tokens ou no processo de resolução de CaptchaAI.

Artigos relacionados

• Como resolver o retorno de chamada do Recaptcha V2 usando API
• Segurança da chave de API da lista de permissões de IP Captchaai
• Rotação de chave da API Captchaai

Próximas etapas

Resolva os desafios do reCAPTCHA Enterprise —obtenha sua chave API CaptchaAIe envie a chave do site com o sinalizador enterprise=1.