Integrazione con Google Cloud Armor per i siti web

Questo documento mostra come integrare reCAPTCHA Enterprise per WAF con Google Cloud Armor sui siti web.

Per completare l'integrazione, devi implementare una o più funzionalità di reCAPTCHA Enterprise per WAF e configurare i criteri di sicurezza di Google Cloud Armor.

Prima di iniziare

1. Abilita l'API reCAPTCHA Enterprise.

   Abilita l'API

2. Pianifica come implementare le funzionalità di reCAPTCHA Enterprise per WAF per proteggere il tuo sito web.

   1. Scegli una o più funzionalità WAF più adatte al tuo caso d'uso.
   2. Identifica le pagine da proteggere e il tipo di funzionalità WAF da implementare su tali pagine.

Implementa le funzionalità di reCAPTCHA Enterprise per WAF

A seconda dei requisiti, puoi utilizzare una o più funzionalità di reCAPTCHA Enterprise per WAF in una singola applicazione.

Se vuoi usare più funzionalità, devi creare una chiave reCAPTCHA per ognuna di queste funzionalità e utilizzarle nella tua applicazione. Ad esempio, se vuoi utilizzare i token di azione reCAPTCHA e la pagina di verifica reCAPTCHA, devi creare una chiave token di azione e una chiave della pagina di verifica e utilizzarle nella tua applicazione.

Implementare i token di azione reCAPTCHA

Per generare token di azione, è necessario che reCAPTCHA Enterprise sia in esecuzione sulle tue pagine web. Dopo che reCAPTCHA Enterprise ha generato un token di azione, lo colleghi a un'intestazione di richiesta predefinita ogni volta che devi proteggere qualsiasi azione dell'utente, ad esempio checkout. Per impostazione predefinita, i token di azione sono validi per 30 minuti, ma possono variare in base al traffico. Devi collegare il token di azione a un'intestazione della richiesta predefinita prima che scada, in modo che Google Cloud Armor possa valutare gli attributi del token.

Per implementare un token di azione reCAPTCHA:

1. Crea una chiave token di azione per il tuo sito web.

   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 il nome visualizzato per la chiave.
   5. A seconda della piattaforma per cui vuoi creare chiavi reCAPTCHA per WAF, esegui l'azione appropriata:

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

      

      Viene visualizzata la sezione Elenco di domini.

   2. Inserisci il nome di dominio del tuo sito web:

      1. Nella sezione Elenco 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 devi specificare i relativi sottodomini (ad esempio subdomain.examplepetstore.com).

   3. Espandi la sezione Web application firewall (WAF), verifica del dominio, pagine AMP e verifica.
      
   4. Attiva l'opzione Web application firewall (WAF).
      Nota:per impostazione predefinita, le chiavi reCAPTCHA per WAF vengono create per Google Cloud Armor. Se vuoi creare chiavi reCAPTCHA per un altro fornitore di servizi WAF, contatta il nostro team di vendita per abilitarlo.
      
      

   5. Nel menu Funzionalità, seleziona Token azione.

      

   6. (Facoltativo) Attiva l'opzione Utilizza la verifica con caselle di controllo.

   7. Fai clic su Crea chiave.

   La chiave appena creata è elencata nella pagina Chiavi reCAPTCHA.

   gcloud

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

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

   • DISPLAY_NAME: nome della chiave. In genere il nome di un sito.
   • INTEGRATION_TYPE: tipo di integrazione. Specifica score o checkbox.
   • DOMAIN_NAME: i domini o i sottodomini di siti web a cui è consentito utilizzare la chiave.

     Specifica più domini sotto forma di elenco separato da virgole. (Facoltativo) Specifica --allow-all-domains per disabilitare la verifica del dominio.

     La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non ha limitazioni, pertanto chiunque può accedere alla chiave reCAPTCHA e utilizzarla.

   • WAF_FEATURE: nome della funzionalità WAF. Specifica action-token.
   • WAF_SERVICE: nome del fornitore di servizi WAF. Specifica CA per Google Cloud Armor.

   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 \
   --waf-feature=WAF_FEATURE \
   --waf-service=WAF_SERVICE
   
   

   Windows (PowerShell)

   
   gcloud recaptcha keys create `
   --web `
   --display-name=DISPLAY_NAME  `
   --integration-type=INTEGRATION_TYPE `
   --domains=DOMAIN_NAME `
   --waf-feature=WAF_FEATURE `
   --waf-service=WAF_SERVICE
   
   

   Windows (cmd.exe)

   
   gcloud recaptcha keys create ^
   --web ^
   --display-name=DISPLAY_NAME  ^
   --integration-type=INTEGRATION_TYPE ^
   --domains=DOMAIN_NAME ^
   --waf-feature=WAF_FEATURE ^
   --waf-service=WAF_SERVICE
   
   

   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. Specifica score o checkbox.
   • DOMAIN_NAME: i domini o i sottodomini di siti web a cui è consentito utilizzare la chiave.

     Specifica più domini sotto forma di elenco separato da virgole. (Facoltativo) Specifica --allow-all-domains per disabilitare la verifica del dominio.

     La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non ha limitazioni, pertanto chiunque può accedere alla chiave reCAPTCHA e utilizzarla.

   • WAF_FEATURE: nome della funzionalità WAF. Specifica action-token.
   • WAF_SERVICE: nome del fornitore di servizi WAF. Specifica CA per Google Cloud Armor.

   Metodo HTTP e URL:

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

   Corpo JSON della richiesta:

   
   {
     "displayName": "DISPLAY_NAME",
      'wafSettings': "  {
          "wafService": "WAF_SERVICE",
   "wafFeature": "WAF_FEATURE"
     }
     "webSettings": {
       "allowedDomains": "DOMAINS",
       "integrationType": "TYPE_OF_INTEGRATION"
      }
   }
   

   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.

   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 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.

   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/7Ldqgs0UBBBBBIn4k7YxEB-LwEh5S9-Gv6QQIWB8m",
   "displayName": "DISPLAY_NAME,
   "webSettings": {
     "allowAllDomains": true,
     "allowedDomains": [
       "localhost"
     ],
   
    "integrationType": "SCORE",
   
   },
   "wafSettings": {
     "wafService": "CA",
     "wafFeature": "ACTION_TOKEN"
   
   }
   }
   
   

2. Integra il codice JavaScript reCAPTCHA nelle tue pagine web con la chiave del token di azione che hai creato. Per le istruzioni, consulta il documento corrispondente al tipo di integrazione della chiave del token di azione.

   • Per il tipo di integrazione SCORE, consulta Integrare le chiavi basate sul punteggio con il frontend.
   • Per il tipo di integrazione CHECKBOX, consulta Eseguire il rendering del widget reCAPTCHA sul frontend.

3. Dopo aver ricevuto il token da reCAPTCHA Enterprise, collegalo a un'intestazione della richiesta predefinita nel seguente formato:

    X-Recaptcha-Token: value-of-your-action-token
   

   Puoi utilizzare linguaggi come XHR, Ajax o Fetch API per collegare il token a un'intestazione della richiesta predefinita.

   Il seguente script di esempio mostra come proteggere l'azione execute e collegare il token a un'intestazione di richiesta predefinita utilizzando JavaScript + XHR:

   
     <script>
       src="https://www.google.com/recaptcha/enterprise.js?render=ACTION_TOKEN_KEY"></script>
   
       <script>
       function onSuccess(action_token) {
            const xhr = new XMLHttpRequest();
            xhr.open('GET','YOUR_URL', false);
            // Attach the action-token to the predefined request header
            xhr.setRequestHeader("X-Recaptcha-Token", action_token);
            xhr.send(null);
          }
          function onError(reason) {
            alert('Response promise rejected: ' + reason);
          grecaptcha.enterprise.ready(function () {
            document.getElementById("execute-button").onclick = () => {
              grecaptcha.enterprise.execute('ACTION_TOKEN_KEY', {
              }).then(onSuccess, onError);
            };
          });
         }
       </script>
   
     

Implementare i token di sessione reCAPTCHA

Il codice JavaScript reCAPTCHA imposta un token di sessione reCAPTCHA come cookie sul browser dell'utente finale dopo la valutazione. Il browser dell'utente finale allega il cookie e lo aggiorna finché il codice JavaScript reCAPTCHA rimane attivo.

Per fornire un token di sessione come cookie, installa una chiave token di sessione su almeno una delle tue pagine web che soddisfino i seguenti requisiti:

• La pagina web deve essere la pagina visitata dall'utente finale prima della pagina che deve essere protetta. Ad esempio, se vuoi proteggere la pagina di pagamento, installa una chiave token di sessione nella home page o nella pagina del prodotto.
• La pagina web è protetta da un criterio di sicurezza di Google Cloud Armor.

Puoi utilizzare questo cookie per proteggere le successive richieste e i caricamenti delle pagine dell'utente finale su un dominio specifico. Per impostazione predefinita, i token di sessione sono validi per 30 minuti. Tuttavia, se l'utente finale rimane nella pagina in cui hai implementato il token di sessione, reCAPTCHA Enterprise lo aggiorna periodicamente per evitare che scada.

Installa i token di sessione su ogni pagina che deve essere protetta da reCAPTCHA Enterprise. Ti consigliamo di proteggere ogni pagina con reCAPTCHA Enterprise e di utilizzare le regole di Google Cloud Armor per applicare l'accesso a tutte le pagine, tranne la prima pagina visitata dagli utenti finali.

Di seguito è riportato un token di sessione reCAPTCHA di esempio:

   recaptcha-ca-t=value-of-your-session-token;domain=domain;expires=expiration_time

Per implementare un token di sessione reCAPTCHA, segui questi passaggi:

1. Creare una chiave token di sessione per il tuo sito web.

   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 il nome visualizzato per la chiave.
   5. A seconda della piattaforma per cui vuoi creare chiavi reCAPTCHA per WAF, esegui l'azione appropriata:

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

      

      Viene visualizzata la sezione Elenco di domini.

   2. Inserisci il nome di dominio del tuo sito web:

      1. Nella sezione Elenco 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 devi specificare i relativi sottodomini (ad esempio subdomain.examplepetstore.com).

   3. Espandi la sezione Web application firewall (WAF), verifica del dominio, pagine AMP e verifica.
      
   4. Attiva l'opzione Web application firewall (WAF).
      Nota:per impostazione predefinita, le chiavi reCAPTCHA per WAF vengono create per Google Cloud Armor. Se vuoi creare chiavi reCAPTCHA per un altro fornitore di servizi WAF, contatta il nostro team di vendita per abilitarlo.
      
      

   5. Nel menu Funzionalità, seleziona Token sessione.

      
   6. (Facoltativo) Attiva l'opzione Disattiva la verifica del dominio.

      La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non ha limitazioni, pertanto chiunque può accedere alla chiave reCAPTCHA e utilizzarla.

   7. Fai clic su Crea chiave.

   La chiave appena creata è elencata nella pagina Chiavi reCAPTCHA.

   gcloud

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

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

   • DISPLAY_NAME: nome della chiave. In genere il nome di un sito.
   • INTEGRATION_TYPE: tipo di integrazione. Specifica score.
   • DOMAIN_NAME: i domini o i sottodomini di siti web a cui è consentito utilizzare la chiave.

     Specifica più domini sotto forma di elenco separato da virgole. (Facoltativo) Specifica --allow-all-domains per disabilitare la verifica del dominio.

     La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non ha limitazioni, pertanto chiunque può accedere alla chiave reCAPTCHA e utilizzarla.

   • WAF_FEATURE: nome della funzionalità WAF. Specifica session-token.
   • WAF_SERVICE: nome del fornitore di servizi WAF. Specifica CA per Google Cloud Armor.

   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 \
   --waf-feature=WAF_FEATURE \
   --waf-service=WAF_SERVICE
   
   

   Windows (PowerShell)

   
   gcloud recaptcha keys create `
   --web `
   --display-name=DISPLAY_NAME  `
   --integration-type=INTEGRATION_TYPE `
   --domains=DOMAIN_NAME `
   --waf-feature=WAF_FEATURE `
   --waf-service=WAF_SERVICE
   
   

   Windows (cmd.exe)

   
   gcloud recaptcha keys create ^
   --web ^
   --display-name=DISPLAY_NAME  ^
   --integration-type=INTEGRATION_TYPE ^
   --domains=DOMAIN_NAME ^
   --waf-feature=WAF_FEATURE ^
   --waf-service=WAF_SERVICE
   
   

   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. Specifica score.
   • DOMAIN_NAME: i domini o i sottodomini di siti web a cui è consentito utilizzare la chiave.

     Specifica più domini sotto forma di elenco separato da virgole. (Facoltativo) Specifica --allow-all-domains per disabilitare la verifica del dominio.

     La disattivazione della verifica del dominio rappresenta un rischio per la sicurezza perché il sito non ha limitazioni, pertanto chiunque può accedere alla chiave reCAPTCHA e utilizzarla.

   • WAF_FEATURE: nome della funzionalità WAF. Specifica session-token.
   • WAF_SERVICE: nome del fornitore di servizi WAF. Specifica CA per Google Cloud Armor.

   Metodo HTTP e URL:

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

   Corpo JSON della richiesta:

   
   {
     "displayName": "DISPLAY_NAME",
      'wafSettings': "  {
          "wafService": "WAF_SERVICE",
   "wafFeature": "WAF_FEATURE"
     }
     "webSettings": {
       "allowedDomains": "DOMAINS",
       "integrationType": "TYPE_OF_INTEGRATION"
      }
   }
   

   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.

   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 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.

   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/7Ldqgs0UBBBBBIn4k7YxEB-LwEh5S9-Gv6QQIWB8m",
   "displayName": "DISPLAY_NAME,
   "webSettings": {
     "allowAllDomains": true,
     "allowedDomains": [
       "localhost"
     ],
   
    "integrationType": "SCORE",
   
   },
   "wafSettings": {
     "wafService": "CA",
     "wafFeature": "SESSION_TOKEN"
   
   }
   }
   
   

2. Aggiungi la chiave token di sessione e waf=session al codice JavaScript reCAPTCHA.

   Lo script di esempio seguente mostra come implementare un token di sessione su una pagina web:

   
   <!DOCTYPE html>
   <html lang="en">
   <head>
    <meta charset="UTF-8">
    <title>reCAPTCHA WAF Session Token</title>
    <script src="https://www.google.com/recaptcha/enterprise.js?render=SESSION_TOKEN_KEY&waf=session" async defer></script>
    <body></body>
   </head>
   </html>
   
   

Implementa una pagina di verifica reCAPTCHA

Quando implementi una pagina di test reCAPTCHA, reCAPTCHA Enterprise reindirizza a una pagina interstitial in cui determina se è necessario mostrare un test CAPTCHA a un utente. Pertanto, le verifiche CAPTCHA potrebbero non essere visibili a tutti gli utenti.

Per implementare una pagina di test reCAPTCHA, crea una chiave di pagina di test per il tuo sito web.

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 il nome visualizzato per la chiave.
5. A seconda della piattaforma per cui vuoi creare chiavi reCAPTCHA per WAF, esegui l'azione appropriata:

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

   
2. Espandi la sezione Web application firewall (WAF), verifica del dominio, pagine AMP e verifica.
   
3. Attiva l'opzione Web application firewall (WAF).
   Nota:per impostazione predefinita, le chiavi reCAPTCHA per WAF vengono create per Google Cloud Armor. Se vuoi creare chiavi reCAPTCHA per un altro fornitore di servizi WAF, contatta il nostro team di vendita per abilitarlo.
   
   

4. Dal menu Funzionalità, seleziona Pagina Sfida.

   
5. Attiva Disattiva la verifica del dominio.

   Quando disattivi la verifica del dominio per le chiavi di verifica, Google Cloud Armor verifica il dominio.

6. Fai clic su Crea chiave.

La chiave appena creata è elencata nella pagina Chiavi reCAPTCHA.

gcloud

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

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

• DISPLAY_NAME: nome della chiave. In genere il nome di un sito.
• INTEGRATION_TYPE: tipo di integrazione. Specifica invisible.
• DOMAIN_NAME: i domini o i sottodomini di siti web a cui è consentito utilizzare la chiave. Specifica --allow-all-domains.
• WAF_FEATURE: nome della funzionalità WAF. Specifica challenge-page.
• WAF_SERVICE: nome del fornitore di servizi WAF. Specifica CA per Google Cloud Armor.

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 \
--waf-feature=WAF_FEATURE \
--waf-service=WAF_SERVICE

Windows (PowerShell)

gcloud recaptcha keys create `
--web `
--display-name=DISPLAY_NAME  `
--integration-type=INTEGRATION_TYPE `
--domains=DOMAIN_NAME `
--waf-feature=WAF_FEATURE `
--waf-service=WAF_SERVICE

Windows (cmd.exe)

gcloud recaptcha keys create ^
--web ^
--display-name=DISPLAY_NAME  ^
--integration-type=INTEGRATION_TYPE ^
--domains=DOMAIN_NAME ^
--waf-feature=WAF_FEATURE ^
--waf-service=WAF_SERVICE

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. Specifica invisible.
• DOMAIN_NAME: i domini o i sottodomini di siti web a cui è consentito utilizzare la chiave. Specifica --allow-all-domains.
• WAF_FEATURE: nome della funzionalità WAF. Specifica challenge-page.
• WAF_SERVICE: nome del fornitore di servizi WAF. Specifica CA per Google Cloud Armor.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
   'wafSettings': "  {
       "wafService": "WAF_SERVICE",
"wafFeature": "WAF_FEATURE"
  }
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "TYPE_OF_INTEGRATION"
   }
}

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.

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 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.

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/7Ldqgs0UBBBBBIn4k7YxEB-LwEh5S9-Gv6QQIWB8m",
"displayName": "DISPLAY_NAME,
"webSettings": {
  "allowAllDomains": true,
  "allowedDomains": [
    "localhost"
  ],

  "integrationType": "INVISIBLE",

},
"wafSettings": {
  "wafService": "CA",
  "wafFeature": "CHALLENGE_PAGE"

}
}

Importante: non devi eliminare la chiave della pagina della verifica mentre è utilizzata in un criterio di sicurezza. Se la chiave della pagina challenge non è disponibile quando viene visualizzata la pagina della verifica reCAPTCHA, la pagina del test reCAPTCHA mostra un errore e gli utenti non possono superare la valutazione. Pertanto, dovrai annullare l'associazione della chiave al criterio di sicurezza prima di eliminarla. Per maggiori dettagli, consulta Configurare le regole per la gestione dei bot.

Configura i criteri di sicurezza di Google Cloud Armor

Dopo aver implementato le funzionalità di reCAPTCHA Enterprise per WAF, devi configurare i criteri di sicurezza di Google Cloud Armor per la gestione dei bot.

Se hai implementato una pagina di verifica reCAPTCHA, devi fare quanto segue:

1. Associa la chiave della pagina challenge al criterio di sicurezza.
2. Configura una regola del criterio di sicurezza per reindirizzare una richiesta di valutazione di reCAPTCHA Enterprise.

Se hai implementato i token di azione o di sessione reCAPTCHA, devi configurare una regola del criterio di sicurezza che valuti i token reCAPTCHA Enterprise.

Prima di configurare i criteri di sicurezza di Google Cloud Armor consulta gli attributi del token reCAPTCHA per Google Cloud Armor.

Per informazioni su come configurare i criteri di sicurezza di Google Cloud Armor e utilizzare le chiavi reCAPTCHA per WAF con i criteri di sicurezza, consulta Configurare le regole per la gestione dei bot.

Passaggi successivi

• Esempi di integrazione con Google Cloud Armor.
• Scopri come implementare le funzionalità di reCAPTCHA WAF con Google Cloud Armor.