O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Reconciliar a terminologia do Admin Console e do console do Google Cloud

Neste documento, descrevemos como identificar a versão da chave do reCAPTCHA (v2 ou v3), mapear a terminologia legada do Admin Console do reCAPTCHA para o console do Google Cloud e recuperar as chaves do site e as chaves secretas exigidas por plataformas de sistema de gerenciamento de conteúdo (CMS) e plug-ins de terceiros, como integrações do WordPress ou do Shopify.

Mapear a terminologia legada para o console do Google Cloud

Se você gerencia suas chaves apenas no Admin Console do reCAPTCHA, está usando o reCAPTCHA Clássico. Se você gerencia suas chaves na página do Google Cloud Fraud Defense no console do Google Cloud , você está usando o Fraud Defense. Os dois consoles são compatíveis com as chaves de site v2 e v3.

Muitas plataformas e plug-ins de CMS se referem às chaves reCAPTCHA usando números de versão legados, como v2 Checkbox, v2 Invisible e v3. O console doGoogle Cloud usa descritores baseados em plataforma em vez de números de versão.

A tabela a seguir mapeia a terminologia legada do CMS e do Admin Console para a terminologia do console doGoogle Cloud :

Terminologia do CMS ou do Admin Console	Console doGoogle Cloud (detalhes da plataforma)	Editar chave (campo Tipo)	Mecanismo de verificação e compatibilidade com CMS
Com base em pontuação (v3)	`Website • score`	`Website • Score`	Verificação sem atrito e baseada em pontuação. Use para plug-ins de CMS que exigem o reCAPTCHA v3.
Desafio (v2)	`Website • checkbox`	`Website • Checkbox challenge`	Exige que o usuário marque a caixa de seleção "Não sou um robô". Use para plug-ins de CMS que exigem a caixa de seleção do reCAPTCHA v2.
Invisível (v2)	`Website • invisible`	`Website • Invisible integration`	Analisa o risco em segundo plano e pode mostrar um desafio. Use para plug-ins de CMS que exigem o reCAPTCHA v2 invisível.
N/A	`Website • policy-based challenge`	`Website • Policy-based challenge`	Aciona testes com base em um limite de pontuação configurado. Requer uma integração personalizada do `CreateAssessment`.
N/A	`iOS`	`iOS app`	Chave para dispositivos móveis iOS sem desafio.
N/A	`Android`	`Android app`	Chave para dispositivos móveis Android sem desafio.

Ver a versão da chave no console do Google Cloud

Para ver a versão da chave no console do Google Cloud , faça o seguinte:

No console do Google Cloud , acesse a página Fraud Defense.

Acessar o Fraud Defense
Selecione a guia Chaves.
Se as chaves estiverem na visualização Cards, mude para a visualização Tabela.
Verifique a coluna Detalhes da plataforma para encontrar sua chave. Por exemplo, Website • score corresponde a v3, e Website • checkbox corresponde a v2 Checkbox.
Opcional. Na visualização Cards, clique em Detalhes da chave em um card de chave e selecione Editar chave. O campo Tipo mostra a configuração da chave, como Website • Score para v3 ou Website • Checkbox challenge para v2 Checkbox.

Encontrar a chave do site e a chave secreta

Os plug-ins de terceiros e as plataformas de CMS geralmente exigem uma chave de site e uma chave secreta para a integração com o reCAPTCHA:

Chave do site: no console do Google Cloud , o ID da chave corresponde à chave do site.
Chave secreta: o console do Google Cloud não exibe a chave secreta por padrão porque a autenticação do Google Cloud normalmente usa chaves de API ou papéis do Identity and Access Management. No entanto, é possível recuperar a chave secreta legada para plug-ins que exigem isso. Algumas bibliotecas ou documentações de terceiros podem se referir à chave secreta legada como uma chave privada.

Recuperar a chave secreta no console do Google Cloud

Para recuperar a chave do site e a chave secreta, faça o seguinte:

No console do Google Cloud , acesse a página Fraud Defense.

Acessar o Fraud Defense
Selecione a guia Chaves.
Na seção Chaves reCAPTCHA, acesse a chave que precisa da chave secreta:
- Se você estiver na visualização Cards, clique em Detalhes da chave 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 na tabela. Clique na chave para acessar a página de detalhes.
Copie o ID da chave exibido na parte de cima da página. Esse valor é a chave do site.
Acesse a guia Integração.
Dependendo do status da chave, siga um destes procedimentos:
- 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 externo.
Uma caixa de diálogo vai aparecer com sua chave secreta. Copie esse valor com segurança. Trate esse secret como dados sensíveis.

Como alternativa, na página Detalhes da chave, clique em Editar chave e, em seguida, clique em Revelar ao lado do campo Chave secreta.

Integração com o WordPress, Shopify ou outras plataformas de CMS

Se você usa um criador de sites, uma plataforma de e-commerce ou um plug-in de CMS, a plataforma ou o plug-in carrega o script do reCAPTCHA e verifica os tokens do usuário automaticamente. Não é necessário instalar bibliotecas de cliente do reCAPTCHA nem escrever código de back-end personalizado.

Para configurar o reCAPTCHA em um CMS ou plug-in de terceiros, faça o seguinte:

Verifique a versão do reCAPTCHA exigida pelo CMS ou pelo plug-in: abra as configurações de integração do reCAPTCHA no CMS ou no plug-in e verifique o tipo de chave compatível (normalmente, reCAPTCHA v3 ou caixa de seleção do reCAPTCHA v2).
Selecione ou crie uma chave de correspondência:
- Se você já tiver uma chave, confira a versão dela para confirmar se ela corresponde à versão selecionada no plug-in (Website • score para v3 ou Website • checkbox para v2 Checkbox).
- Se você precisar de uma nova chave, crie uma chave para seu site que corresponda à versão necessária e adicione o domínio do site (por exemplo, example.com) à lista de domínios da chave.
Observação: usar uma chave baseada em pontuação do v3 em um plug-in configurado para o v2 Checkbox (ou o contrário) causa um erro Invalid key type no seu site.
Copie a chave do site e a chave secreta legada: siga as etapas em Recuperar a chave secreta no console doGoogle Cloud para receber o ID da chave (chave do site) e a chave secreta.
Insira as chaves nas configurações do CMS ou do plug-in:
- Cole o ID da chave no campo Chave do site.
- Cole a chave secreta no campo Chave secreta (ou Chave privada) e salve as configurações.
Observação : alguns plug-ins também oferecem um modo integrado do reCAPTCHA Enterprise que solicita um ID do projeto e uma chave de API em vez de uma chave secreta legada. Para esses plug-ins, forneça o ID do projeto do Google Cloud , o ID da chave e uma chave de API restrita doGoogle Cloud .

Integrar sites personalizados usando avaliações

Importante: para integrações personalizadas que não usam plug-ins de terceiros, use o método CreateAssessment em vez do método legado SiteVerify.

O método CreateAssessment fornece análise de risco detalhada e códigos de motivo, além de permitir o acesso a recursos avançados do Fraud Defense. É possível 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.

Método `SiteVerify` legado

Embora recomendemos o método CreateAssessment para integrações novas e personalizadas, alguns sistemas ou plug-ins de terceiros ainda dependem do método legado SiteVerify. Esse método requer uma chave secreta associada à sua chave reCAPTCHA.

Se você precisar de integração com um sistema que exige a API SiteVerify legada, consulte Verificar tokens de resposta do usuário com o SiteVerify legado.