Este documento mostra como migrar do reCAPTCHA Clássico para reCAPTCHA usando um site ativo de dados. O processo de migração leva de 5 a 10 minutos para ser concluído, e não exige alterações no código.
Se você acessar o Admin Console do reCAPTCHA, você está usando o reCAPTCHA Classic, que tem recursos limitados e limites rígidos de uso mensal. Para mais informações sobre a comparação de recursos, consulte Comparação de recursos entre versões do reCAPTCHA.
Após a migração, você se torna um usuário do reCAPTCHA, e é cobrado quando excede 10.000 solicitações por mês. Para mais informações, consulte os preços do reCAPTCHA.
Antes de começar
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
O reCAPTCHA exige que o faturamento seja vinculado e ativado no projeto para a migração. É possível ativar o faturamento usando um cartão de crédito ou um ID de projeto atual do Google Cloud. Se precisar de ajuda com o faturamento, entre em contato com o suporte do Cloud Billing.
- Se você quiser executar a CLI gcloud fora do console do Google Cloud,
instalar e inicializar a CLI gcloud. Para instruções, consulte
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Ativar a API reCAPTCHA Enterprise
Console
No console do Google Cloud, acesse a página API reCAPTCHA Enterprise.
Verifique se o nome do projeto aparece no seletor de projetos, na parte superior da página.
Se você não encontrar o nome do projeto, clique no seletor de projetos e selecione o projeto.
- Clique em Ativar.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
- Para definir o projeto do Google Cloud na sessão gcloud, execute o comando
gcloud config set project
. Substitua PROJECT_ID pelo ID do projeto do Google Cloud.gcloud config set project PROJECT_ID
- Para ativar a API reCAPTCHA Enterprise, execute o comando
gcloud services enable
:gcloud services enable recaptchaenterprise.googleapis.com
- Para verificar se a API reCAPTCHA Enterprise está ativada, execute o comando
gcloud services list
:gcloud services list --enabled
Verifique se a API reCAPTCHA Enterprise está listada na lista de APIs ativadas.
Migrar para o reCAPTCHA
Para migrar o reCAPTCHA Classic para o reCAPTCHA, escolha uma chave de site ativa no Admin Console do reCAPTCHA e migre a chave. É possível migrar uma ou mais chaves de site ativas. No entanto, só é possível migrar uma chave de site por vez.
Para executar o processo de migração, você precisa ter uma conta de usuário do reCAPTCHA que atenda aos seguintes requisitos:
- No Admin Console do reCAPTCHA, a conta de usuário é listada como proprietária da chave de site que você quer migrar.
- A conta de usuário tem um dos seguintes papéis do IAM para o
projeto do Google Cloud para que a API reCAPTCHA Enterprise está
ativada:
- Proprietário do projeto (
roles/owner
) - Editor do projeto (
roles/editor
) - Administrador do reCAPTCHA (
roles/recaptchaenterprise.admin
)
- Proprietário do projeto (
Migre a chave de site usando o console do Google Cloud, o Cloud Shell, a CLI do Google Cloud ou a API reCAPTCHA Enterprise.
A migração da chave do site não afeta a chave nem os endpoints da API. Ela adiciona a chave à licença empresarial.
Console do Google Cloud
No console do Google Cloud, acesse a página do reCAPTCHA.
Verifique se o nome do seu projeto aparece no seletor de recursos no topo da página. Se você não vir o nome do seu projeto, clique no seletor de recursos e selecione o projeto.
Na seção Chaves clássicas, identifique a chave que você quer migrar e Clique em Fazer upgrade da chave.
Para concluir a migração da chave selecionada, clique em Confirmar.
Cloud Shell
No console do Google Cloud, acesse o Cloud Shell.
Se for solicitado, clique em Autorizar.
Escolha e copie uma chave de site ativa que você usou para integrar o reCAPTCHA às suas páginas da Web:
- Acesse o Admin Console do reCAPTCHA e clique em .
Escolha uma chave de site. As seguintes chaves de site reCAPTCHA são compatíveis com migração: caixa de seleção reCAPTCHA v2, reCAPTCHA v2 invisível e reCAPTCHA v3.
Para copiar a chave do site, clique em Copiar chave do site.
Migre a chave do site.
Execute o comando
gcloud recaptcha keys migrate
conforme mostrado no exemplo a seguir:gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
Forneça os valores a seguir:
- SITE_KEY: a chave de site ativa que você copiou no Admin Console do reCAPTCHA.
- PROJECT-ID: o ID do projeto do Google Cloud em que a API reCAPTCHA Enterprise está ativada.
CLI da gcloud
Para configurar a autenticação, execute o seguinte comando
gcloud
:gcloud auth login
Faça login com a conta de usuário do reCAPTCHA que é proprietário da chave de site escolhida e que tenha um dos seguintes papéis: Proprietário do projeto, Editor do projeto ou Administrador do reCAPTCHA Enterprise.
Escolha e copie uma chave de site ativa que você usou para integrar o reCAPTCHA às suas páginas da Web:
- Acesse o Admin Console do reCAPTCHA e clique em .
Escolha uma chave de site. As seguintes chaves de site reCAPTCHA são compatíveis com a migração: caixa de seleção reCAPTCHA v2, reCAPTCHA v2 invisível e reCAPTCHA v3.
Para copiar a chave do site, clique em Copiar chave do site.
Migre a chave do site.
Execute o comando
gcloud recaptcha keys migrate
conforme mostrado no exemplo a seguir:gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
Forneça os valores a seguir:
- SITE_KEY: a chave de site ativa que você copiou no Admin Console do reCAPTCHA.
- PROJECT-ID: o ID do projeto do Google Cloud em que a API reCAPTCHA Enterprise está ativada.
API REST
Escolha e copie uma chave de site ativa que você usou para integrar o reCAPTCHA às suas páginas da Web:
- Acesse o Admin Console do reCAPTCHA e clique em .
Escolha uma chave de site. As seguintes chaves de site reCAPTCHA são compatíveis com a migração: caixa de seleção reCAPTCHA v2, reCAPTCHA v2 invisível e reCAPTCHA v3.
Para copiar a chave do site, clique em Copiar chave do site.
Migre a chave do site.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto do Google Cloud em que a API reCAPTCHA está ativada.
- SITE_KEY: a chave de site ativa que você copiou no Admin Console do reCAPTCHA.
Método HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate
Para enviar a solicitação, escolha uma destas opções:
curl
execute o seguinte comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate"PowerShell
execute o seguinte comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate" | Select-Object -Expand ContentVocê receberá uma resposta JSON semelhante a esta:
{ "name": "projects/PROJECT-ID/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m", "displayName": "My site key", "webSettings": { "allowAllDomains": false, "allowedDomains": [ recaptcha.net ], "allowAmpTraffic": false, "integrationType": "SCORE", "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED" } }
Para verificar se a chave de site foi migrada, faça o seguinte:
Console do Google Cloud
Acesse a página do reCAPTCHA e encontre a chave de site migrada na seção chaves do reCAPTCHA.
Cloud Shell
Execute o comando
gcloud recaptcha keys list
e encontre a chave de site migrada na lista.CLI da gcloud
Execute o comando
gcloud recaptcha keys list
e encontre a chave de site migrada na lista.
Depois de migrar para o reCAPTCHA, é possível continuar usando o método siteverify para avaliar o token de resposta reCAPTCHA de um usuário.
É possível revogar o papel do IAM de Administrador do reCAPTCHA Enterprise
(roles/recaptchaenterprise.admin
) na conta de usuário
do reCAPTCHA. Peça para o administrador revogar o acesso
ou siga as instruções sobre Como conceder, alterar e revogar acesso.