Este documento descreve as diferenças na terminologia e no gerenciamento de chaves entre o Admin Console do reCAPTCHA legado e o console Google Cloud . Também explicamos como recuperar chaves de site e chaves secretas do reCAPTCHA necessárias para plug-ins de terceiros, como integrações do WordPress.
Mapear a terminologia legada para o console Google Cloud
Muitos plug-ins de sistema de gerenciamento de conteúdo (CMS) se referem a tipos de reCAPTCHA usando convenções de nomenclatura legadas, como v2 Checkbox, v2 Invisible e v3.O console Google Cloud usa descritores baseados em plataforma, em vez de números de versão.
A tabela a seguir mapeia a terminologia legada para a terminologia do console Google Cloud :
| Terminologia do Admin Console | Terminologia do console doGoogle Cloud | Mecanismo de verificação |
|---|---|---|
| Com base em pontuação (v3) | Site • pontuação | Verificação simplificada baseada em pontuação. |
| Desafio (v2) | Site • caixa de seleção | Exige que o usuário clique em um desafio "Não sou um robô". |
| N/A | Site • desafio com base em políticas | Desafio configurado com base no limite definido pelo usuário. |
| N/A | iOS | Chave móvel do iOS sem desafio. |
| N/A | Android | Chave móvel do Android sem desafio. |
| Invisível (v2) | Site • Invisível com substituição de desafio* | Pode mostrar desafios de captcha após a análise de risco. |
Verificar o tipo de chave no console do Google Cloud
Para verificar o tipo de uma chave no console Google Cloud , faça o seguinte:
No console do Google Cloud , acesse a página Fraud Defense.
Mude da visualização Cards para Tabela.
Localize a coluna Detalhes da plataforma para ver descritores como
Website • score.
Como alternativa, na visualização padrão Cards, clique em Detalhes principais para uma chave específica e selecione Editar chave. O campo Tipo mostra a configuração.
Encontrar a chave do site e a chave secreta
Os plug-ins de terceiros geralmente exigem uma chave de site e uma chave secreta para a integração do reCAPTCHA.
- Chave do site: no console do Google Cloud , o ID da chave corresponde à chave do site.
- Chave secreta: o Google Cloud console não mostra a chave secreta por padrão porque a autenticação Google Cloud normalmente usa chaves de API ou papéis do IAM. No entanto, é possível recuperar a chave secreta legada para plug-ins que exigem isso.
Recuperar a chave secreta no console do Google Cloud
Para recuperar a chave secreta, faça o seguinte:
No console do Google Cloud , acesse a página Fraud Defense.
Na seção Chaves reCAPTCHA, acesse a chave para a qual você precisa da chave secreta.
- Se você estiver na visualização Cards, clique em Detalhes principais no card da chave. O ID da chave é exibido na parte de cima da página.
- Se você estiver na visualização Tabela, o ID da chave vai aparecer nela. Clique na chave para acessar a página de detalhes.
O ID da chave exibido na parte de cima da página é sua chave do site.
Acesse a guia Integração.
Dependendo do status da chave:
- Se a chave estiver configurada para uso legado, clique em Usar chave legada.
- Se a chave não estiver integrada a um serviço legado, clique em Integrar com um serviço ou plug-in de terceiros.
Uma caixa de diálogo aparece com sua chave secreta. Copie esse valor com segurança. Trate este secret como dados sensíveis.
Integrar usando avaliações
O método CreateAssessment fornece uma análise de risco detalhada e códigos de motivo, além de permitir o acesso a recursos avançados do Fraud Defense. Você pode chamar o método CreateAssessment usando as bibliotecas de cliente do reCAPTCHA ou a API REST.
Para mais informações, consulte Criar uma avaliação para seu site.