Guia de início rápido: como migrar do reCAPTCHA

Este guia de início rápido mostra como migrar do reCAPTCHA (versão não corporativa) para o reCAPTCHA Enterprise usando uma chave de site ativa. O processo de migração leva de 5 a 10 minutos para ser concluído e não requer alterações no código.

Se você acessar o Admin Console do reCAPTCHA (em inglês), está usando a versão não corporativa do reCAPTCHA, que tem funcionalidade limitada e limites rígidos no uso mensal. Para mais informações sobre a comparação de recursos, consulte Comparação de recursos entre as versões do reCAPTCHA.

Após a migração, você se torna um usuário do reCAPTCHA Enterprise e é cobrado quando exceder 1 milhão de solicitações por mês. Para mais informações, consulte Preços do reCAPTCHA Enterprise (em inglês).

Para migrar, é preciso ter uma chave de site ativa. Se você não tiver uma chave de site ativa, não será possível fazer a migração usando esse método. Configure o reCAPTCHA Enterprise escolhendo um método de configuração apropriado.

Antes de começar

  1. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  2. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

    O reCAPTCHA Enterprise exige que o faturamento seja vinculado e ativado no projeto para acessar a API. É possível ativar o faturamento usando um cartão de crédito ou um ID de faturamento de um projeto do Google Cloud existente. Se você precisar de ajuda com o faturamento, entre em contato com o suporte do Cloud Billing.

  3. Instale e inicialize o SDK do Cloud..

Como ativar a API do reCAPTCHA Enterprise

Console

  1. No Console do Cloud, acesse a página da API ReCAPTCHA Enterprise.

    Acessar a API reCAPTCHA Enterprise

  2. 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 e selecione seu projeto.

  3. Clique em Enable.

gcloud

  1. Para definir seu projeto do Google Cloud na sessão da gcloud, execute o comando gcloud config set project. Substitua PROJECT_ID pelo ID do seu projeto do Google Cloud.
           gcloud config set project PROJECT_ID
           
  2. Para ativar a API reCAPTCHA Enterprise, execute o comando gcloud services enable:
             gcloud services enable recaptchaenterprise.googleapis.com
           
  3. 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.

Como migrar para o reCAPTCHA Enterprise

Migrar de uma versão não corporativa do reCAPTCHA para o reCAPTCHA reCAPTCHA envolve a escolha de uma chave de site ativa no Admin Console do reCAPTCHA e a migração da chave do site. Você pode migrar uma ou mais chaves de sites ativas. No entanto, é possível migrar apenas 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 do site que você quer migrar.
  • A conta de usuário tem o papel do IAM Administrador do reCAPTCHA Enterprise (roles/recaptchaenterprise.admin) para o projeto do Google Cloud em que a API reCAPTCHA Enterprise está ativada. Se sua conta de usuário não tiver esse papel, peça ao administrador para conceder o papel ou siga as instruções em Como conceder, alterar e revogar o acesso.

Para migrar uma chave de site ativa para o reCAPTCHA Enterprise, faça o seguinte:

  1. 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 tem a chave do site escolhida e tenha o papel de reCAPTCHA Enterprise Admin.

  2. Escolha e copie uma chave de site ativa que você usou para integrar o reCAPTCHA às suas páginas da Web:

    1. Acesse o Admin Console do reCAPTCHA e clique em .
    2. 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.

    3. Para copiar a chave, clique em Copiar a chave do site.

  3. Migre a chave do site usando a ferramenta de linha de comando gcloud ou a API reCAPTCHA reCAPTCHA.

    gcloud

    Use o comando gcloud alpha recaptcha keys migrate conforme mostrado no exemplo a seguir:

     gcloud alpha recaptcha keys migrate SITE_KEY --project PROJECT-ID
    

    Forneça os valores a seguir:

    • SITE_KEY: a chave do site ativa que você copiou do Admin Console do reCAPTCHA.
    • PROJECT-ID: o ID do projeto do Google Cloud em que a API reCAPTCHA Enterprise está ativada.

    REST e LINHA DE CMD

    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 Enterprise está ativada.
    • SITE_KEY: a chave do site ativa que você copiou do 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 Content

    Você 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"
      }
    }
    

  4. Para verificar se a chave do site foi migrada, faça o seguinte:

    gcloud

    Execute o comando gcloud alpha recaptcha keys list e encontre a chave do site migrada na lista de chaves.

    Console

    Acesse a página reCAPTCHA Enterprise e encontre a chave do site migrada na lista de chaves.

    Acessar o reCAPTCHA Enterprise

Depois de migrar para o reCAPTCHA Enterprise, continue usando o método siteverify para avaliar o token de resposta do reCAPTCHA de um usuário.

Limpeza

Revogue o papel de IAM Administrador do reCAPTCHA Enterprise (roles/recaptchaenterprise.admin) da conta de usuário do reCAPTCHA. Você pode pedir ao administrador para revogar o acesso ou seguir as instruções em Como conceder, alterar e revogar o acesso.

A seguir