Creare chiavi reCAPTCHA per i siti web

Console di amministrazione

1. Vai alla Console di amministrazione reCAPTCHA.

   Vai alla console di amministrazione di reCAPTCHA

2. Nel campo Etichetta, inserisci un nome che puoi utilizzare per identificare il tuo sito.
3. Se vuoi creare una chiave basata sul punteggio, seleziona In base al punteggio (v3). Se vuoi creare una chiave della casella di controllo, seleziona Verifica (v2).
4. Per aggiungere un dominio, inserisci il nome del dominio e fai clic su add .

   Per aggiungere un altro dominio, puoi ripetere questo passaggio. Puoi aggiungere fino a un massimo di 250 domini.

5. Se non hai mai utilizzato la console Google Cloud , leggi i Termini di servizio e seleziona la casella di controllo.
6. Fai clic su Invia.

Se non hai mai utilizzato la console, viene creato un progetto e vengono abilitate le API necessarie per iniziare. Google Cloud Google Cloud Se hai già un progetto Google Cloud , le API necessarie sono abilitate per iniziare.

console Cloud

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

   Vai a reCAPTCHA

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

   Se non vedi il nome del tuo progetto, fai clic sul selettore di risorse, poi seleziona il tuo progetto.

3. Fai clic su Crea chiave.
4. Nel campo Nome visualizzato, inserisci un nome visualizzato per la chiave.
5. Per Tipo di applicazione, seleziona Web.

   Viene visualizzata la sezione Elenco domini.

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

   1. Nella sezione Elenco domini, fai clic su Aggiungi un dominio.
   2. Nel campo 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 che specifichi. Puoi specificare più di un dominio se il tuo sito web viene pubblicato da più domini. Se specifichi un dominio (ad esempio examplepetstore.com), non devi specificarne i sottodomini (ad esempio, subdomain.examplepetstore.com).

      Per utilizzare una chiave su più di 250 domini, fai clic sul pulsante di attivazione/disattivazione Disattiva verifica dominio. reCAPTCHA ignorerà l'elenco dei domini. Devi eseguire personalmente la verifica del dominio esaminando il campo tokenProperties.hostname nelle valutazioni che crei.

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

1. Per proteggere la chiave reCAPTCHA per il tuo dominio e i tuoi sottodomini, assicurati che l'opzione Disattiva verifica del dominio sia disattivata.

   La disattivazione della verifica del dominio è un rischio per la sicurezza perché non ci sono restrizioni sul sito, quindi chiunque può accedere e utilizzare la chiave reCAPTCHA.

2. Se vuoi consentire il funzionamento della chiave basata sul punteggio con Accelerated Mobile Pages (AMP), attiva il pulsante di attivazione/disattivazione Consenti il funzionamento di questa chiave con le pagine AMP.

3. Per l'ambiente non di produzione, se vuoi specificare un punteggio che la chiave deve restituire quando vengono create valutazioni, procedi nel seguente modo:

   1. Fai clic su Passaggio successivo (facoltativo).
   2. Nel passaggio Impostazioni aggiuntive, fai clic sul pulsante di attivazione/disattivazione Stai creando questa chiave solo a scopo di test?.
   3. Utilizza il cursore Imposta punteggio per specificare un punteggio compreso tra 0 e 1.
4. Fai clic su Crea chiave.

La chiave appena creata è elencata nella pagina Chiavi reCAPTCHA.

Crea chiavi reCAPTCHA con casella di controllo

1. Per proteggere la chiave reCAPTCHA per il tuo dominio e i tuoi sottodomini, assicurati che il pulsante di attivazione/disattivazione Disattiva verifica del dominio sia disattivato.

   La disattivazione della verifica del dominio è un rischio per la sicurezza perché non ci sono restrizioni sul sito, quindi chiunque può accedere e utilizzare la chiave reCAPTCHA.

2. Fai clic su Passaggio successivo (facoltativo).
3. Nel passaggio Impostazioni aggiuntive, attiva l'opzione Utilizzerai le verifiche? pulsante di attivazione/disattivazione.
4. Seleziona l'opzione Challenge security (Sicurezza della verifica) appropriata.

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

   Se vuoi assicurarti la migliore protezione antifrode, seleziona Difficile.

   Se selezioni Facile, gli utenti hanno meno probabilità di visualizzare la verifica visiva.

5. Per l'ambiente non di produzione, se vuoi specificare un punteggio che la chiave deve restituire quando vengono creati test, procedi nel seguente modo:

   1. Fai clic sul pulsante di attivazione/disattivazione Stai creando questa chiave solo a scopo di test?.
   2. Utilizza il cursore Imposta punteggio per specificare un punteggio compreso tra 0 e 1.
   3. Seleziona l'opzione Tipo di verifica appropriata.
      • A volte viene visualizzata la sfida Auto.
      • No CAPTCHA non mostra una sfida.
      • Verifica irrisolvibile mostra le immagini, ma la verifica non viene superata.
   4. 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 i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

• DISPLAY_NAME: il 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.
• DOMAIN_NAME: i domini o i sottodomini dei siti web autorizzati a utilizzare la chiave.

  Specifica più domini come elenco separato da virgole.

  Per utilizzare una chiave su più di 250 domini, specifica --allow-all-domains per disattivare la verifica del dominio. reCAPTCHA ignorerà l'elenco dei domini. Devi eseguire personalmente la verifica del dominio esaminando il campo tokenProperties.hostname nelle valutazioni che crei.

  La disattivazione della verifica del dominio è un rischio per la sicurezza perché non ci sono restrizioni sul sito, quindi chiunque può accedere e utilizzare la chiave reCAPTCHA.

Esegui il comando gcloud recaptcha keys create:

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

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

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

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

• DISPLAY_NAME: il 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.
• DOMAIN_NAME: i domini o i sottodomini dei siti web autorizzati a utilizzare la chiave.

  Specifica più domini come elenco separato da virgole.

  Per utilizzare una chiave su più di 250 domini, specifica --allow-all-domains per disattivare la verifica del dominio. reCAPTCHA ignorerà l'elenco dei domini. Devi eseguire personalmente la verifica del dominio esaminando il campo tokenProperties.hostname nelle valutazioni che crei.

  La disattivazione della verifica del dominio è un rischio per la sicurezza perché non ci sono restrizioni sul sito, quindi chiunque può accedere e utilizzare la chiave reCAPTCHA.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, scegli una di queste opzioni:

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"

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