Creare chiavi reCAPTCHA per i siti web

In questa pagina viene spiegato come creare chiavi reCAPTCHA (dette anche chiavi) per verificare le interazioni degli utenti sulle tue pagine web.

Le chiavi reCAPTCHA rappresentano il modo in cui reCAPTCHA Enterprise è configurato per un sito web. La configurazione include opzioni importanti, ad esempio se mostrare o meno le verifiche CAPTCHA.

Prima di iniziare

• Prepara l'ambiente per reCAPTCHA Enterprise.
• Assicurati di disporre del seguente ruolo di Identity and Access Management: Amministratore reCAPTCHA Enterprise (roles/recaptchaenterprise.admin).
• Scegli il tipo di chiave più adatto al tuo caso d'uso.

Crea una chiave reCAPTCHA

Non esiste un limite al numero di chiavi reCAPTCHA che puoi creare per un progetto Google Cloud. È preferibile creare una chiave reCAPTCHA per sito web.

Consigliamo di creare chiavi reCAPTCHA separate per gli ambienti di gestione temporanea e produzione. In caso contrario, rischi di inquinare l'analisi del rischio reCAPTCHA con i dati del tuo ambiente di test.

Il modo più semplice per creare una chiave reCAPTCHA è utilizzare la console Google Cloud. In alternativa, puoi utilizzare l'API reCAPTCHA Enterprise o Google Cloud CLI.

Console

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. Fai clic su Crea chiave.

   
4. Nel campo Nome visualizzato, inserisci un nome visualizzato per la chiave.

5. Nel menu Scegli il tipo di piattaforma, seleziona Sito web.

   

   Viene visualizzata la sezione Elenco di domini.

6. Inserisci il nome di dominio per il tuo sito web:

   1. Nella sezione Elenco di domini, fai clic su Aggiungi un dominio.

      
   2. Nel campo Domain (Dominio), inserisci il nome del tuo dominio.

   3. (Facoltativo) Per aggiungere un altro dominio, fai clic su Aggiungi un dominio e inserisci il nome di un altro dominio nel campo Dominio. Puoi aggiungere fino a un massimo di 250 domini.

      Per i siti web, la chiave reCAPTCHA è univoca per i domini e i sottodomini specificati. Puoi specificare più di un dominio se pubblichi il tuo sito web da più domini. Se specifichi un dominio (ad esempio examplepetstore.com), non è necessario specificare i relativi sottodomini (ad esempio subdomain.examplepetstore.com).

7. A seconda del tipo di chiave reCAPTCHA che vuoi creare per il tuo sito web, esegui l'azione appropriata:

Crea chiavi reCAPTCHA basate sul punteggio

Nota: la creazione di una chiave basata sul punteggio è l'opzione predefinita nella console Google Cloud.

1. (Facoltativo) Se vuoi disattivare la verifica del dominio o consentire le pagine AMP, espandi la sezione Web Application Firewall (WAF), Verifica del dominio, pagine AMP e richiesta di verifica.
   
   1. Per proteggere la chiave reCAPTCHA per il tuo dominio e i tuoi sottodomini, assicurati che l'opzione Disattiva verifica dominio sia disattivata.

      La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non prevede limitazioni, pertanto la chiave reCAPTCHA è accessibile e utilizzabile da chiunque.

      
   2. Se vuoi consentire il funzionamento della chiave basata sul punteggio con Accelerated Mobile Pages (AMP), attiva l'opzione Consenti il funzionamento di questa chiave con le pagine AMP.

   3. Per l'ambiente non di produzione, se vuoi specificare un punteggio che vuoi che venga restituito dalla chiave al momento della creazione delle valutazioni, segui questi passaggi:

      1. Fai clic sul pulsante di attivazione/disattivazione Questa è una chiave di test.
      2. Nella casella Punteggio, specifica un punteggio compreso tra 0 e 1,0.
      
   4. Fai clic su Crea chiave.

   La chiave appena creata viene elencata nella pagina Chiavi reCAPTCHA.

Crea chiavi reCAPTCHA della casella di controllo

Sconsigliamo di utilizzare le chiavi delle caselle di controllo perché aumentano l'attrito per l'utente e non migliorano in modo significativo l'accuratezza.

1. Espandi la sezione Web Application Firewall (WAF), Verifica del dominio, pagine AMP e verifica.
   
2. Per proteggere la chiave reCAPTCHA per il tuo dominio e i tuoi sottodomini, assicurati che l'opzione Disattiva verifica dominio sia disattivata.

   La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non prevede limitazioni, pertanto la chiave reCAPTCHA è accessibile e utilizzabile da chiunque.

   
3. Attiva l'opzione Usa la verifica tramite casella di controllo.
   
4. Seleziona l'opzione Sfida di sicurezza appropriata.

   L'opzione di sicurezza della verifica controlla la probabilità che a un utente venga richiesta una challenge secondaria in cui agli utenti viene chiesto di selezionare immagini in base a una categoria identificata (ad esempio, selezionare le immagini con una motocicletta o scale).

   

   Se vuoi assicurarti la migliore protezione antifrode, seleziona Difficoltà maggiore (più sicurezza contro i bot).

   Se selezioni Difficoltà di verifica più semplice, è meno probabile che agli utenti venga richiesta la verifica visiva.

5. Per l'ambiente non di produzione, se vuoi specificare un punteggio che vuoi che venga restituito dalla chiave al momento della creazione delle valutazioni, segui questi passaggi:

   1. Fai clic sul pulsante di attivazione/disattivazione Questa è una chiave di test.
   2. Nella casella Punteggio, specifica un punteggio compreso tra 0 e 1,0.
   3. Seleziona l'opzione Tipo di sfida appropriata.
      • A volte la sfida viene visualizzata da Auto.
      • Nessun CAPTCHA non mostra un test.
      • Verifica non risolvibile mostra le immagini, ma la sfida non è stata superata.
      
   4. Fai clic su Crea chiave.

   La chiave appena creata viene elencata nella pagina Chiavi reCAPTCHA.

gcloud

Per creare chiavi reCAPTCHA, utilizza il comando gcloud recaptcha Keys create.

Prima di utilizzare uno qualsiasi dei dati del comando riportati di seguito, apporta le seguenti sostituzioni:

• DISPLAY_NAME: nome della chiave. In genere il nome di un sito.
• INTEGRATION_TYPE: tipo di integrazione. A seconda del tipo di chiavi, specifica i seguenti valori:
  • score per le chiavi basate sul punteggio.
  • checkbox per le chiavi delle caselle di controllo.
  Nota: sconsigliamo di utilizzare CHECKBOX perché aumenta i problemi per l'utente e non migliora in modo significativo l'accuratezza. Per ulteriori informazioni, consulta le Domande frequenti.
• DOMAIN_NAME: domini o sottodomini di siti web autorizzati a utilizzare la chiave.

  Specifica più domini sotto forma di elenco separato da virgole.

  La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non prevede limitazioni, pertanto la chiave reCAPTCHA è accessibile e utilizzabile da chiunque.

  Nota: la chiave reCAPTCHA è univoca per i domini e i sottodomini che specifichi. Puoi specificare più di un dominio se pubblichi il tuo sito web da più domini. Se specifichi un dominio (ad esempio examplepetstore.com), non è necessario specificare i relativi sottodomini (ad esempio, subdomain.examplepetstore.com).

Esegui il comando gcloud recaptcha Keys create:

Linux, macOS o Cloud Shell

gcloud recaptcha keys create \
        --web \
        --display-name=DISPLAY_NAME  \
        --integration-type=INTEGRATION_TYPE \
        --domains=DOMAIN_NAME

Windows (PowerShell)

gcloud recaptcha keys create `
        --web `
        --display-name=DISPLAY_NAME  `
        --integration-type=INTEGRATION_TYPE `
        --domains=DOMAIN_NAME

Windows (cmd.exe)

gcloud recaptcha keys create ^
        --web ^
        --display-name=DISPLAY_NAME  ^
        --integration-type=INTEGRATION_TYPE ^
        --domains=DOMAIN_NAME

La risposta contiene la chiave reCAPTCHA appena creata.

REST

Per informazioni di riferimento sulle API sui tipi di chiave e di integrazione, consulta Chiave e Tipo di integrazione.

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

• DISPLAY_NAME: nome della chiave. In genere il nome di un sito.
• INTEGRATION_TYPE: tipo di integrazione. A seconda del tipo di chiavi, specifica i seguenti valori:
  • score per le chiavi basate sul punteggio.
  • checkbox per le chiavi delle caselle di controllo.
  Nota: sconsigliamo di utilizzare CHECKBOX perché aumenta i problemi per l'utente e non migliora in modo significativo l'accuratezza. Per ulteriori informazioni, consulta le Domande frequenti.
• DOMAIN_NAME: domini o sottodomini di siti web autorizzati a utilizzare la chiave.

  Specifica più domini sotto forma di elenco separato da virgole.

  La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non prevede limitazioni, pertanto la chiave reCAPTCHA è accessibile e utilizzabile da chiunque.

  Nota: la chiave reCAPTCHA è univoca per i domini e i sottodomini che specifichi. Puoi specificare più di un dominio se pubblichi il tuo sito web da più domini. Se specifichi un dominio (ad esempio examplepetstore.com), non è necessario specificare i relativi sottodomini (ad esempio, subdomain.examplepetstore.com).

Metodo HTTP e URL:

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

Corpo JSON richiesta:

{
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "TYPE_OF_INTEGRATION"
  }
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

arricciare

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

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"

PowerShell

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

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowAllDomains": false,
    "allowedDomains": [
      DOMAINS
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}

Nota: dopo aver creato le chiavi reCAPTCHA, puoi modificarle o eliminarle. Non puoi recuperare le chiavi eliminate.

(Facoltativo) Trova una chiave secret reCAPTCHA legacy

Se vuoi eseguire l'integrazione con un'applicazione di terze parti che utilizza la versione non Enterprise di reCAPTCHA, hai bisogno della chiave segreta precedente.

Per ogni chiave del sito che crei, reCAPTCHA Enterprise crea una chiave secret reCAPTCHA legacy (chiave segreta precedente), che puoi utilizzare con la tua applicazione di terze parti.

Per trovare la chiave segreta precedente:

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

   Vai a reCAPTCHA Enterprise

2. Nella sezione Chiavi aziendali, trova la chiave reCAPTCHA che hai creato e fai clic sulla chiave.

   

3. Nella pagina Dettagli chiave, nella scheda Integrazione, fai clic su Utilizza chiave precedente. Si apre una finestra di dialogo con le istruzioni su come utilizzare la chiave segreta precedente.

   

Passaggi successivi

• Installa chiavi basate sul punteggio sulle tue pagine web.
• Installa le chiavi delle caselle di controllo nelle tue pagine web.