Creare chiavi reCAPTCHA per le applicazioni mobile

Le chiavi mobile in reCAPTCHA ti consentono di configurare l'identità dell'applicazione e i parametri di rischio per i deployment Android e iOS. Crea chiavi mobile dedicate per proteggere la comunicazione client-server e impedire il traffico di bot automatici nelle applicazioni mobile.

Le chiavi reCAPTCHA rappresentano la configurazione di reCAPTCHA per un'applicazione mobile.

Prima di iniziare

• Prepara il tuo ambiente per Google Cloud Fraud Defense.
• Assicurati di disporre del seguente ruolo Identity and Access Management: Amministratore reCAPTCHA Enterprise (roles/recaptchaenterprise.admin).

Crea una chiave reCAPTCHA

Puoi creare solo chiavi basate sul punteggio per le applicazioni mobile.

Quando crei chiavi reCAPTCHA per le applicazioni mobile, ti consigliamo di:

• Crea una chiave reCAPTCHA per ogni applicazione mobile.

• Per Android, crea chiavi separate per i seguenti scenari:

  • Il pacchetto Android è disponibile solo sul Google Play Store.
  • Il pacchetto Android è disponibile solo su app store diversi dal Google Play Store.

• Crea chiavi reCAPTCHA separate per gli ambienti di gestione temporanea e di produzione. In caso contrario, rischi di contaminare l'analisi dei rischi di reCAPTCHA con i dati del tuo ambiente di test.

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

Console

1. Nella console Google Cloud , vai alla pagina Google Cloud Fraud Defense.

   Vai a Google Cloud Fraud Defense

2. Verifica che il nome del 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, quindi seleziona il progetto.

3. Seleziona la scheda Chiavi.
4. Fai clic su Crea chiave.
5. Nel campo Nome visualizzato, inserisci un nome visualizzato per la chiave.
6. A seconda del tipo di chiave reCAPTCHA che vuoi creare per la tua applicazione mobile, esegui l'azione appropriata:

Crea chiavi reCAPTCHA per le applicazioni per iOS

Ti consigliamo di creare una chiave reCAPTCHA per ogni applicazione per iOS.

1. Per Tipo di applicazione, seleziona iOS.
1. Nella sezione Elenco ID pacchetto iOS, fai clic su Aggiungi ID pacchetto iOS.

2. Nel campo ID pacchetto, inserisci il nome dell'ID pacchetto iOS.

3. (Facoltativo) Per aggiungere un ID pacchetto aggiuntivo, fai clic su Aggiungi ID pacchetto iOS e inserisci il nome dell'ID pacchetto iOS nel campo ID pacchetto.
4. Per proteggere la chiave reCAPTCHA per i tuoi ID pacchetto, assicurati che l'opzione Disattiva verifica ID pacchetto sia disattivata. Se disattivi la verifica dell'ID pacchetto, devi verificare il campo tokenProperties.iosBundleId nelle valutazioni che crei.

5. (Facoltativo) Specifica le impostazioni di Apple Developer.

   Ti consigliamo di fornire questi dati perché consentono a Fraud Defense di fornire scoring del rischio più accurati per il tuo traffico.

   Inserisci le seguenti informazioni:

   • Chiave privata (.p8): viene generata nell'Apple Developer Center in Certificati, ID e profili.
   • Identificatore chiave: l'identificatore chiave sviluppatore Apple (stringa di 10 caratteri).
   • ID team: l'ID team Apple (stringa di 10 caratteri) proprietario del profilo di provisioning utilizzato per creare l'applicazione.
6. (Facoltativo) Fai clic su Passaggio successivo (facoltativo).

1. Per l'ambiente non di produzione, se vuoi specificare un punteggio che vuoi che la chiave restituisca quando vengono create valutazioni per questa chiave, segui questi passaggi:

   1. In Impostazioni aggiuntive, 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,0.
7. Fai clic su Crea chiave.

La chiave appena creata è elencata nella pagina Chiavi reCAPTCHA.

Crea chiavi reCAPTCHA per le app per Android

1. Per Tipo di applicazione, seleziona Android.
   
2. Nella sezione Elenco pacchetti Android, fai clic su Aggiungi pacchetto Android.
3. Nel campo Pacchetto Android, inserisci il nome del tuo pacchetto Android.
4. (Facoltativo) Per aggiungere un altro pacchetto, fai clic su Aggiungi pacchetto Android e inserisci il nome di un altro pacchetto Android nel campo Pacchetto Android.
5. Per applicare forzatamente l'utilizzo della chiave reCAPTCHA solo all'interno della tua app, disattiva l'opzione Disattiva la verifica del nome pacchetto. Se disattivi la verifica del nome del pacchetto, devi verificare il campo tokenProperties.androidPackageName nelle valutazioni che crei.
6. Se vuoi creare una chiave per un'applicazione disponibile su altri store oltre al Google Play Store, attiva l'opzione Supporta le applicazioni distribuite al di fuori del Google Play Store.
7. (Facoltativo) Fai clic su Passaggio successivo (facoltativo).

1. Per l'ambiente non di produzione, se vuoi specificare un punteggio che vuoi che la chiave restituisca quando vengono create valutazioni per questa chiave, segui questi passaggi:

   1. In Impostazioni aggiuntive, 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,0.
8. Fai clic su Crea chiave.

La chiave appena creata è elencata nella pagina Chiavi reCAPTCHA.

gcloud (iOS)

Per creare le 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.
• BUNDLE_IDs: gli ID pacchetto iOS delle app autorizzate a utilizzare la chiave. Specifica più ID pacchetto sotto forma di elenco separato da virgole.

Esegui il comando gcloud recaptcha keys create:

Linux, macOS o Cloud Shell

gcloud recaptcha keys create \
--display-name=DISPLAY_NAME  \
--ios --bundle-ids=BUNDLE_IDs

Windows (PowerShell)

gcloud recaptcha keys create `
--display-name=DISPLAY_NAME  `
--ios --bundle-ids=BUNDLE_IDs

Windows (cmd.exe)

gcloud recaptcha keys create ^
--display-name=DISPLAY_NAME  ^
--ios --bundle-ids=BUNDLE_IDs

La risposta contiene la chiave reCAPTCHA appena creata.

gcloud (Android)

Per creare le 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.
• PACKAGE_NAMES: i nomi dei pacchetti Android delle app autorizzate a utilizzare la chiave. Specifica più nomi di pacchetti sotto forma di elenco separato da virgole.

Esegui il comando gcloud recaptcha keys create:

Linux, macOS o Cloud Shell

gcloud recaptcha keys create \
--display-name=DISPLAY_NAME  \
--android --package-names=PACKAGE_NAMES

Windows (PowerShell)

gcloud recaptcha keys create `
--display-name=DISPLAY_NAME  `
--android --package-names=PACKAGE_NAMES

Windows (cmd.exe)

gcloud recaptcha keys create ^
--display-name=DISPLAY_NAME  ^
--android --package-names=PACKAGE_NAMES

La risposta contiene la chiave reCAPTCHA appena creata.

REST (iOS)

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

• DISPLAY_NAME: il nome della chiave. In genere, il nome di un'app.
• BUNDLE_IDs: gli ID pacchetto iOS delle app autorizzate a utilizzare la chiave. Specifica più ID pacchetto sotto forma di elenco separato da virgole.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "iosSettings": {
   "allowedBundleIds":"BUNDLE_IDs"

  }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando 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 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, quindi esegui il comando seguente:

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. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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/6LfhtywnAAAAABY3sCS2duZ6A55kmDXz-PNEgKgT",
  "displayName": "DISPLAY_NAME",
  "iosSettings": {
    "allowAllBundleIds": false,
    "allowedBundleIds": [
        BUNDLE_IDS
    ]
  },
  "labels": {},
}

REST (Android)

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

• DISPLAY_NAME: il nome della chiave. In genere, il nome di un'app.
• PACKAGE_NAMES: i nomi dei pacchetti Android delle app autorizzate a utilizzare la chiave. Specifica più nomi di pacchetti sotto forma di elenco separato da virgole.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "androidSettings": {
  "allowedPackageNames":"PACKAGE_NAMES"
  }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando 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 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, quindi esegui il comando seguente:

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. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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/6LcioSknAAAAABrjlMuZv2fjIGYMqwaAFC9izhoy",
  "displayName": "DISPLAY_NAME",
  "androidSettings": {
      "allowAllPackageNames": false,
      "allowedPackageNames": [
          PACKAGE_NAMES
      ],
      "supportNonGoogleAppStoreDistribution": false
  },
  "labels": {},
}

Nota: dopo aver creato le chiavi reCAPTCHA, puoi modificarle o eliminarle. Non puoi recuperare le chiavi eliminate. Inoltre, non puoi eseguire la migrazione delle chiavi reCAPTCHA da un progetto Google Cloud a un altro.

Passaggi successivi

• Installa le chiavi su iOS.
• Installa le chiavi su Android.