reCAPTCHA v2, v3 e Enterprise: identifique o que você precisa
Primeiro, identifique se a página usa v2 ou v3 e, em seguida, verifique se usa Enterprise. O Enterprise pode usar chaves de caixa de seleção ou baseadas em pontuação; o nome por si só não indica qual fluxo você está analisando. O solvethree resolve v3 padrão e Enterprise v3, mas não v2.
Nesta página
O que a página realmente indica
| O que você encontra | O que isso indica |
|---|---|
| Um widget reCAPTCHA com caixa de seleção | Um fluxo com caixa de seleção, não uma evidência de v3 baseado em pontuação. Verifique se a integração usa a biblioteca clássica ou a Enterprise. |
| Sem caixa de seleção | Inconclusivo. O v2 pode ser invisível, portanto uma página sem elementos visíveis de reCAPTCHA não comprova o uso de v3. |
| Execução baseada em pontuação com uma ação nomeada | Evidência de v3. Confirme qual biblioteca e configuração de chave a execução usa. |
| api.js | A biblioteca clássica do reCAPTCHA. O nome do arquivo por si só não distingue v2 de v3. |
| enterprise.js | A biblioteca Enterprise. Você ainda precisa identificar o tipo de chave e o fluxo; isso, por si só, não comprova o uso de v3. |
<!-- Classic script: investigate whether the page uses v2 or v3. -->
<script src="https://www.google.com/recaptcha/api.js?render=PUBLIC_SITE_KEY"></script>
<!-- Enterprise script: investigate which Enterprise key type is in use. -->
<script src="https://www.google.com/recaptcha/enterprise.js?render=PUBLIC_SITE_KEY"></script>Essas tags de script são exemplos de identificação, não solicitações de resolução. Inspecione o código usado pela interação protegida, em vez de escolher uma tarefa apenas pelo nome de um arquivo de script. Uma string de token, por si só, não revela qual fluxo a produziu.
Confirme o hostname e a ação
Em uma integração baseada em pontuação, encontre a ação usada pela interação que você precisa concluir. Não tente deduzi-la pelo rótulo de um botão nem reutilize uma ação de outra página. O site pode verificar a ação esperada no backend; um token de outra interação não é intercambiável.
Confirme também o hostname e o ambiente pretendidos. Se você controla a integração, verifique a configuração da chave para esclarecer indicadores ambíguos na página. A chave pública do site identifica a integração do site; ela não é o segredo de verificação do site nem sua chave de API do solvethree.
Consulte Encontre a ação do reCAPTCHA quando a ação da página não estiver clara.
Escolha a tarefa correspondente
| Integração confirmada | O que fazer |
|---|---|
| reCAPTCHA Enterprise baseado em pontuação | Use a tarefa reCAPTCHA v3 Enterprise. O valor padrão de recaptchaType é enterprise-v3; você também pode selecioná-lo explicitamente. |
| reCAPTCHA v3 clássico baseado em pontuação | O gateway aceita recaptchaType definido como v3. Selecione esse valor explicitamente em vez de depender do padrão Enterprise. |
| reCAPTCHA v2 com caixa de seleção ou invisível, incluindo um fluxo Enterprise com caixa de seleção | Não compatível com o solvethree. Alterar recaptchaType não transforma um fluxo v2 em v3. |
| Script Enterprise, mas o fluxo ainda não está claro | Confirme o tipo de chave e o fluxo de execução antes de criar uma tarefa. |
Depois de identificar a variante, configure o perfil do site antes da primeira resolução.
Continue com a configuração do perfil do site e a integração com a API de reCAPTCHA.
Fontes e referência da API
Execute sua primeira tarefa.
Comece com $5 em créditos no espaço de trabalho.