Configure um perfil de site para reCAPTCHA

Por solvethree3 min de leitura

Configure o site em Perfis de sites e espere o perfil exibir active antes de solicitar um token. Enviar um hostname e uma ação à API de tarefas não cria um perfil.

Nesta página

Adicione o site no console

  1. 1.

    Verifique o espaço de trabalho

    Configure o perfil no espaço de trabalho cuja chave de API você usará para criar tarefas. Um perfil em outro espaço de trabalho não basta. Se o console exibir Adicione crédito para continuar, siga essa orientação antes de prosseguir com a configuração.

  2. 2.

    Abra Adicionar um site

    Em Perfis de sites, selecione Adicionar um site. Insira a página HTTPS de destino em URL da página. Em Tipo de reCAPTCHA, escolha Enterprise v3 ou Regular v3 conforme a página.

  3. 3.

    Defina os parâmetros de captura

    A ação de captura é obrigatória. Use a ação para a qual você pretende solicitar a resolução; se não tiver certeza, encontre a ação do reCAPTCHA primeiro. O formulário também tem os campos opcionais URL de navegação, Chave do site e Valor de Referer. A chave do site pode ser descoberta automaticamente.

  4. 4.

    Envie o formulário

    Selecione Adicionar site. Perfis de sistema revisados podem preencher o contrato conhecido da página e a ação de captura sem uma coleta ao vivo; o formulário explica a ação escolhida. Outros envios podem entrar nos estados na fila, capturando, validando ou em revisão.

Verifique o status do perfil resultante. ACTIVE é exibido como active, e esse é o estado necessário para a resolução. Se a captura falhar, o console mostra o motivo e permite tentar novamente.

Solicite um token usando o perfil ativo

Este corpo de tarefa usa o hostname e a ação do perfil:

reCAPTCHA Enterprise · estrutura da requisição
{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}
  • site é o hostname da URL da página, sem o esquema ou o caminho.
  • action é a ação da solicitação protegida. Use a ação correspondente ao perfil que você pretende usar.
  • O valor padrão de recaptchaType é enterprise-v3. Para um perfil Regular v3, defina-o explicitamente como v3.
  • Substitua o marcador de proxy pelo proxy HTTP(S) que você também usará na solicitação ao destino.

O guia de início rápido em Python e o guia de início rápido em Node.js mostram como enviar a solicitação e usar o resultado.

Corrija um perfil ausente ou inativo

Nenhum perfil está disponível para a tarefa.

Compare o espaço de trabalho associado à sua chave de API e o hostname da tarefa com o perfil que você configurou.

Experimente: Adicione o perfil do site pretendido no espaço de trabalho que criará a tarefa. Repetir a criação da tarefa não criará o perfil ausente.

O perfil está na fila, em captura, em validação ou em revisão.

Consulte o estado atual em Perfis de sites.

Experimente: Espere o perfil ficar ativo antes de solicitar uma resolução. Esses estados não substituem um perfil ativo.

A captura falhou.

Leia o motivo da falha exibido no console.

Experimente: Corrija o problema indicado por esse motivo e tente capturar novamente.

Um perfil está ativo, mas a ação pretendida ainda não é resolvida.

Compare o hostname, a ação de captura e o tipo de reCAPTCHA. Se a ação de execução for diferente, verifique se existe um único alvo de captura inequívoco.

Experimente: Configure um perfil que corresponda ao hostname, à ação e ao tipo pretendidos, em vez de alterar a tarefa para uma ação sem relação apenas para selecionar um perfil existente.

Fontes e referência da API

Execute sua primeira tarefa.

Comece com $5 em créditos no espaço de trabalho.

Criar um espaço de trabalho
Configure um perfil de site para reCAPTCHA · solvethree