Esegui la migrazione da reCAPTCHA (versione non Enterprise)

Questo documento mostra come eseguire la migrazione da reCAPTCHA (versione non Enterprise) a reCAPTCHA Enterprise utilizzando una chiave di sito attiva. Il processo di migrazione richiede 5-10 minuti e non richiede modifiche al codice.

Se attualmente accedi alla Console di amministrazione reCAPTCHA, stai utilizzando la versione non Enterprise di reCAPTCHA, che ha funzionalità limitate e limiti rigidi all'utilizzo mensile. Per ulteriori informazioni sul confronto delle funzionalità, consulta il Confronto delle funzionalità tra le versioni reCAPTCHA.

Dopo la migrazione, diventi un utente di reCAPTCHA Enterprise e ricevi un addebito quando superi 1.000.000 di richieste al mese. Per ulteriori informazioni, consulta i prezzi di reCAPTCHA Enterprise.

Nota: non è possibile eseguire la migrazione delle chiavi Android reCAPTCHA v2.

Nota: il processo di migrazione non consente di accedere alle funzionalità aggiuntive di reCAPTCHA Enterprise come l'autenticazione a più fattori (MFA) o il rilevamento di fughe di password. Per utilizzare queste funzionalità aggiuntive, consulta Utilizzo delle funzionalità di reCAPTCHA Enterprise dopo la migrazione.

Nota: i controlli dell'accesso nel progetto Google Cloud di destinazione potrebbero impedirti di accedere alla chiave nella Console di amministrazione reCAPTCHA dopo la migrazione. In questo caso, devi utilizzare invece la console Google Cloud.

Prima di iniziare

1. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

2. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

   reCAPTCHA Enterprise richiede che la fatturazione sia collegata e abilitata nel progetto per la migrazione. Puoi abilitare la fatturazione utilizzando una carta di credito o un ID fatturazione del progetto Google Cloud esistente. Se hai bisogno di aiuto con la fatturazione, contatta l'assistenza per la fatturazione Cloud.

3. Se vuoi eseguire gcloud CLI al di fuori della console Google Cloud, installalo e inizializzalo. Per istruzioni, consulta

   Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

   gcloud init

Abilita l'API reCAPTCHA Enterprise

Console

1. Nella console Google Cloud, vai alla pagina dell'API reCAPTCHA Enterprise.

   Vai all'API reCAPTCHA Enterprise

2. Verifica che il nome del progetto venga visualizzato nel selettore di progetti nella parte superiore della pagina.

   Se non vedi il nome del progetto, fai clic sul selettore dei progetti e selezionalo.

3. Fai clic su Abilita.

gcloud

1. Nella console Google Cloud, attiva Cloud Shell.

   Attiva Cloud Shell

   Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

2. Per impostare il tuo progetto Google Cloud nella sessione gcloud, esegui il comando gcloud config set project. Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

          gcloud config set project PROJECT_ID
          

3. Per abilitare l'API reCAPTCHA Enterprise, esegui il comando gcloud services enable:

            gcloud services enable recaptchaenterprise.googleapis.com
          

4. Per verificare che l'API reCAPTCHA Enterprise sia abilitata, esegui il comando gcloud services list:

            gcloud services list --enabled
          

   Verifica che l'API reCAPTCHA Enterprise sia elencata nell'elenco delle API abilitate.

Esegui la migrazione a reCAPTCHA Enterprise

La migrazione da una versione non Enterprise di reCAPTCHA a reCAPTCHA Enterprise prevede la scelta di una chiave di sito attiva dalla Console di amministrazione reCAPTCHA e la migrazione della chiave di sito. Puoi eseguire la migrazione di una o più chiavi di sito attive. Tuttavia, puoi eseguire la migrazione di una sola chiave di sito alla volta.

Per eseguire il processo di migrazione, devi avere un account utente reCAPTCHA che soddisfi i seguenti requisiti:

• Nella Console di amministrazione reCAPTCHA, l'account utente è indicato come proprietario della chiave di sito di cui vuoi eseguire la migrazione.
• L'account utente ha uno dei seguenti ruoli IAM per il progetto Google Cloud per cui è abilitata l'API reCAPTCHA Enterprise:
  • Proprietario progetto (roles/owner)
  • Editor progetto (roles/editor)
  • Amministratore reCAPTCHA Enterprise (roles/recaptchaenterprise.admin)
  Se il tuo account utente non dispone di uno di questi ruoli, chiedi all'amministratore di concederti il ruolo o segui le istruzioni in Concessione, modifica e revoca dell'accesso.

1. Esegui la migrazione della chiave di sito utilizzando la console Google Cloud, Cloud Shell, Google Cloud CLI o l'API reCAPTCHA Enterprise:

   Console Google Cloud

   1. Nella console Google Cloud, vai alla pagina reCAPTCHA Enterprise.

      Vai a reCAPTCHA Enterprise

   2. Verifica che il nome del progetto venga visualizzato nel selettore di risorse nella parte superiore della pagina. Se non vedi il nome del progetto, fai clic sul selettore di risorse e seleziona il progetto.

   3. Nella sezione Chiavi classiche, identifica la chiave di cui vuoi eseguire la migrazione e fai clic su Upgrade della chiave.

      

   4. Per completare la migrazione della chiave selezionata, fai clic su Conferma.

   Cloud Shell

   1. Nella console Google Cloud, vai a Cloud Shell.

      Vai a Cloud Shell

   2. Se richiesto, fai clic su Autorizza.

   3. Scegli e copia una chiave di sito attiva che hai utilizzato per integrare reCAPTCHA con le tue pagine web:

      1. Vai alla Console di amministrazione reCAPTCHA e fai clic su .

      2. Scegli una chiave di sito. Per la migrazione sono supportate le seguenti chiavi di sito reCAPTCHA: casella di controllo reCAPTCHA v2, reCAPTCHA v2 Invisible e reCAPTCHA v3.

      3. Per copiare la chiave di sito, fai clic su Copia chiave di sito.

   4. Esegui la migrazione della chiave di sito.

      Utilizza il comando gcloud recaptcha keys migrate come mostrato nell'esempio seguente:

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      Fornisci i seguenti valori:

      • SITE_KEY: la chiave di sito attiva che hai copiato dalla Console di amministrazione reCAPTCHA.
      • PROJECT-ID: l'ID del progetto Google Cloud per cui è abilitata l'API reCAPTCHA Enterprise.

   Interfaccia a riga di comando gcloud

   1. Per configurare l'autenticazione, esegui questo comando gcloud:

      gcloud auth login
      

      Accedi con l'account utente reCAPTCHA proprietario della chiave di sito scelta e che ha uno dei seguenti ruoli: Proprietario progetto, Editor progetto o Amministratore reCAPTCHA Enterprise.

   2. Scegli e copia una chiave di sito attiva che hai utilizzato per integrare reCAPTCHA con le tue pagine web:

      1. Vai alla Console di amministrazione reCAPTCHA e fai clic su .

      2. Scegli una chiave di sito. Per la migrazione sono supportate le seguenti chiavi di sito reCAPTCHA: casella di controllo reCAPTCHA v2, reCAPTCHA v2 Invisible e reCAPTCHA v3.

      3. Per copiare la chiave di sito, fai clic su Copia chiave di sito.

   3. Esegui la migrazione della chiave di sito.

      Utilizza il comando gcloud recaptcha keys migrate come mostrato nell'esempio seguente:

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      Fornisci i seguenti valori:

      • SITE_KEY: la chiave di sito attiva che hai copiato dalla Console di amministrazione reCAPTCHA.
      • PROJECT-ID: l'ID del progetto Google Cloud per cui è abilitata l'API reCAPTCHA Enterprise.

   API REST

   1. Scegli e copia una chiave di sito attiva che hai utilizzato per integrare reCAPTCHA con le tue pagine web:

      1. Vai alla Console di amministrazione reCAPTCHA e fai clic su .

      2. Scegli una chiave di sito. Per la migrazione sono supportate le seguenti chiavi di sito reCAPTCHA: casella di controllo reCAPTCHA v2, reCAPTCHA v2 Invisible e reCAPTCHA v3.

      3. Per copiare la chiave di sito, fai clic su Copia chiave di sito.

   2. Esegui la migrazione della chiave di sito.

      Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

      • PROJECT_ID: l'ID del progetto Google Cloud per cui è abilitata l'API reCAPTCHA Enterprise.
      • SITE_KEY: la chiave di sito attiva che hai copiato dalla Console di amministrazione reCAPTCHA.

      Metodo HTTP e URL:

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

      Per inviare la richiesta, scegli una delle seguenti opzioni:

      arricciatura

      Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

      Esegui questo 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: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

      Esegui questo 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

      Dovresti ricevere una risposta JSON simile alla seguente:

      {
        "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. Per verificare che venga eseguita la migrazione della chiave di sito:

   Console Google Cloud

   Vai alla pagina reCAPTCHA Enterprise e trova la chiave di sito di cui è stata eseguita la migrazione nella sezione Chiavi Enterprise.

   Vai a reCAPTCHA Enterprise

   Cloud Shell

   Esegui il comando gcloud recaptcha keys list e trova la chiave di sito di cui è stata eseguita la migrazione nell'elenco delle chiavi.

   Interfaccia a riga di comando gcloud

   Esegui il comando gcloud recaptcha keys list e trova la chiave di sito di cui è stata eseguita la migrazione nell'elenco delle chiavi.

Dopo la migrazione a reCAPTCHA Enterprise, puoi continuare a utilizzare il metodo siteverify per valutare il token di risposta reCAPTCHA di un utente.

Nota: non devi eliminare le chiavi di sito dalla Console di amministrazione reCAPTCHA o dalla pagina reCAPTCHA Enterprise della Google Cloud Console. Quando elimini una chiave di sito, questa viene eliminata da entrambe le console e rimuove la protezione offerta da reCAPTCHA Enterprise.

Puoi revocare il ruolo IAM Amministratore reCAPTCHA Enterprise (roles/recaptchaenterprise.admin) dal tuo account utente reCAPTCHA. Puoi chiedere all'amministratore di revocare l'accesso o seguire le istruzioni in Concessione, modifica e revoca dell'accesso.

Passaggi successivi

• Utilizza le funzionalità di reCAPTCHA Enterprise dopo la migrazione.