Migre do reCAPTCHA clássico

Este documento explica como migrar uma chave de site ativa do reCAPTCHA clássico para os níveis do reCAPTCHA numGoogle Cloud projeto. Pode migrar a chave do site através da consola do administrador do reCAPTCHA (recomendado) ou através da Google Cloud consola. O processo de migração demora 5 a 10 minutos a ser concluído e não requer alterações ao código.

Se gere as suas chaves na consola de administração do reCAPTCHA, está a usar o reCAPTCHA clássico, que tem capacidades limitadas e limites rigorosos na utilização mensal. As funcionalidades mais recentes do reCAPTCHA só estão disponíveis para chaves de site geridas num Google Cloud projeto. Para mais informações sobre as funcionalidades disponíveis, consulte o artigo Compare os níveis do reCAPTCHA.

As seguintes alterações ocorrem depois de concluir o processo de migração:

• As chaves do site estão disponíveis num Google Cloud projeto sem alterações.
• A sua integração do reCAPTCHA existente continua a funcionar sem exigir alterações ao código. Pode manter a mesma instrumentação da página Web e chamadas de back-end. No entanto, para aceder a funcionalidades como o Account defender ou a Password defense, tem de modificar a instrumentação da página Web e as chamadas de back-end. Para mais informações, consulte o artigo Usar funcionalidades do reCAPTCHA após a migração.
• A cobrança é feita quando excede a permissão mensal gratuita do reCAPTCHA, que é de 10 000 avaliações por mês. Para mais informações, consulte o artigo Informações de faturação.

Nota: não é possível migrar as chaves do reCAPTCHA v2 para Android.

Migre através da consola do administrador do reCAPTCHA

1. Aceda à consola do administrador do reCAPTCHA.

   Aceda à consola de administração do reCAPTCHA

2. Selecione o projeto para o qual quer migrar as chaves.

3. Selecione as chaves a migrar.

4. Clique em Enviar.

A Google Cloud consola é aberta com o seu projeto e as chaves que migrou.

Nota: para resolver falhas de migração, consulte o artigo Resolva problemas de migração.

Migre através da Google Cloud consola

Antes de começar

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

   O reCAPTCHA requer que a faturação esteja associada e ativada no projeto para a migração. Pode ativar a faturação através de um cartão de crédito ou de um ID de faturação do projeto Google Cloud existente. Se precisar de assistência com a faturação, contacte o apoio técnico do Cloud Billing.

3. Se quiser executar a CLI gcloud fora da Google Cloud consola, instale e inicialize a CLI gcloud. Para ver instruções, consulte

   Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

   gcloud init

   Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Ative a API reCAPTCHA Enterprise

Todos os níveis do reCAPTCHA (Essentials, Standard e Enterprise) são executados na API reCAPTCHA Enterprise.

Consola

1. Na Google Cloud consola, aceda à página API reCAPTCHA Enterprise.

   Aceder à API reCAPTCHA Enterprise

2. Verifique se o nome do seu projeto aparece no seletor de projetos na parte superior da página.

   Se não vir o nome do seu projeto, clique no seletor de projetos e, de seguida, selecione o seu projeto.

3. Clique em Ativar.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. Para definir o seu Google Cloud projeto na sessão do gcloud, execute o comando gcloud config set project. Substitua PROJECT_ID pelo ID do seu Google Cloud projeto.

          gcloud config set project PROJECT_ID
          

3. Para ativar a API reCAPTCHA Enterprise, execute o comando gcloud services enable:

            gcloud services enable recaptchaenterprise.googleapis.com
          

4. 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á na lista de APIs ativadas.

Migre para o reCAPTCHA

Para migrar do reCAPTCHA clássico para o reCAPTCHA, escolha uma chave de site ativa na consola de administração do reCAPTCHA e migre a chave de site. Pode migrar uma ou mais chaves de sites ativas. No entanto, só pode migrar uma chave do site de cada vez.

Para executar o processo de migração, tem de ter uma conta de utilizador do reCAPTCHA que satisfaça os seguintes requisitos:

• Na consola de administração do reCAPTCHA, a conta de utilizador está listada como proprietária da chave de site que quer migrar.
• A conta de utilizador tem uma das seguintes funções de IAM para o Google Cloud projeto para o qual a API reCAPTCHA Enterprise está ativada:
  • Proprietário do projeto (roles/owner)
  • Editor de projetos (roles/editor)
  • Administrador do reCAPTCHA (roles/recaptchaenterprise.admin)
  Se a sua conta de utilizador não tiver uma destas funções, peça ao seu administrador para conceder a função ou siga as instruções em Conceder, alterar e revogar o acesso.

1. Migre a chave do site através da Google Cloud consola, da Google Cloud CLI ou da API reCAPTCHA Enterprise.

   A migração da chave do site não afeta a chave nem os pontos finais da API. Adiciona a chave à licença empresarial.

   Google Cloud consola

   1. Na Google Cloud consola, aceda à página reCAPTCHA.

      Aceder ao reCAPTCHA

   2. Verifique se o nome do seu projeto é apresentado no seletor de recursos na parte superior da página. Se não vir o nome do seu projeto, clique no seletor de recursos e, de seguida, selecione o seu projeto.

   3. Na secção Chaves clássicas, identifique a chave que quer migrar e clique em Atualizar chave.

      

   4. Para concluir a migração da chave selecionada, clique em Confirmar.

   CLI gcloud

   1. Para configurar a autenticação, execute o seguinte comando gcloud:

      gcloud auth login
      

      Inicie sessão com a conta de utilizador do reCAPTCHA que detém a chave do site escolhida e tem uma das seguintes funções: proprietário do projeto, editor do projeto ou função de administrador do reCAPTCHA Enterprise.

   2. Escolha e copie uma chave de site ativa que tenha usado para integrar o reCAPTCHA com as suas páginas Web:

      1. Aceda à consola do administrador do reCAPTCHA e clique em .

      2. Escolha uma chave do site. As seguintes chaves de site reCAPTCHA são suportadas para migração: caixa de verificação do reCAPTCHA v2, reCAPTCHA v2 invisível e reCAPTCHA v3.

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

   3. Migre a chave do site.

      Use o comando gcloud recaptcha keys migrate conforme mostrado no exemplo seguinte:

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      Indique os seguintes valores:

      • SITE_KEY: a chave do site ativa que copiou da consola de administração do reCAPTCHA.
      • PROJECT-ID: o ID do projeto para o qual a API reCAPTCHA Enterprise está ativada. Google Cloud

   API REST

   1. Escolha e copie uma chave de site ativa que tenha usado para integrar o reCAPTCHA com as suas páginas Web:

      1. Aceda à consola do administrador do reCAPTCHA e clique em .

      2. Escolha uma chave do site. As seguintes chaves de site reCAPTCHA são suportadas para migração: caixa de verificação do reCAPTCHA v2, reCAPTCHA v2 invisível e reCAPTCHA v3.

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

   2. Migre a chave do site.

      Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

      • PROJECT_ID: o ID do Google Cloud projeto para o qual a API reCAPTCHA está ativada.
      • SITE_KEY: a chave do site ativa que copiou da consola de administração do reCAPTCHA.

      Método HTTP e URL:

      POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate

      Para enviar o seu pedido, escolha uma destas opções:

      curl

      Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

      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

      Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

      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

      Deve receber uma resposta JSON semelhante à seguinte:

      {
        "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"
        }
      }
      

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

   Google Cloud consola

   Aceda à página do reCAPTCHA e encontre a chave de site migrada na secção Chaves do reCAPTCHA.

   Aceder ao reCAPTCHA

   CLI gcloud

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

Após a migração para o reCAPTCHA, pode continuar a usar o método siteverify para avaliar o token de resposta do reCAPTCHA de um utilizador. Para obter informações acerca da resposta, consulte a secção Resposta do siteverify method.

Depois de uma chave do site ser migrada para o reCAPTCHA, a respetiva utilização começa a ser registada para apresentação na consola no prazo de uma hora, incluindo dashboards relacionados com a utilização e a pontuação. Google Cloud Geralmente, a utilização antes da migração não é apresentada na Google Cloud consola.

Nota: não deve eliminar chaves de site da consola do administrador do reCAPTCHA nem da página do reCAPTCHA da Google Cloud consola. Quando elimina uma chave de site, esta é eliminada de ambas as consolas e remove a proteção que o reCAPTCHA oferece.

Pode revogar a função do IAM administrador do reCAPTCHA Enterprise (roles/recaptchaenterprise.admin) da sua conta de utilizador do reCAPTCHA. Pode pedir ao administrador para revogar o acesso ou seguir as instruções em Conceder, alterar e revogar o acesso.

O que se segue?

• Use as funcionalidades do reCAPTCHA após a migração.