Questa pagina è stata tradotta dall'API Cloud Translation.

Creazione di chiavi reCAPTCHA per le applicazioni mobile

Questa pagina spiega come creare chiavi reCAPTCHA (note anche come chiavi) per verificare le interazioni degli utenti sulle tue applicazioni mobile.

Le chiavi reCAPTCHA rappresentano il modo in cui è configurato reCAPTCHA per un'applicazione per dispositivi mobili (app).

Prima di iniziare

Prepara l'ambiente per reCAPTCHA.
Assicurati di disporre del seguente ruolo Identity and Access Management: Amministratore di reCAPTCHA Enterprise (roles/recaptchaenterprise.admin)

Crea una chiave reCAPTCHA

Puoi creare solo chiavi basate su punteggi per le applicazioni mobile.

Ti consigliamo quanto segue quando crei le chiavi reCAPTCHA per le applicazioni mobile:

Crea una chiave reCAPTCHA per ogni applicazione mobile.
Per Android, crea chiavi separate per gli scenari seguenti:
- Il pacchetto Android è disponibile soltanto sul Google Play Store.
- Il pacchetto Android è disponibile soltanto negli app store non Google Play Store.
Crea chiavi reCAPTCHA separate per gestione temporanea e produzione ambienti cloud-native. In caso contrario, rischi di inquinare 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 console Google Cloud. In alternativa, puoi utilizzare l'API reCAPTCHA Enterprise o Google Cloud CLI.

Console

Nella console Google Cloud, vai alla pagina reCAPTCHA.

Vai a reCAPTCHA
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 poi seleziona il progetto.
Fai clic su Crea chiave.
Nel campo Nome visualizzato, inserisci un nome visualizzato per la chiave.
A seconda del tipo di chiave reCAPTCHA che vuoi creare per la tua applicazione mobile, esegui l'azione appropriata:

Creazione di chiavi reCAPTCHA per le applicazioni iOS

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

Nel menu Scegli il tipo di piattaforma, seleziona App per iOS.

Nella sezione Elenco ID bundle iOS, fai clic su Aggiungi ID pacchetto iOS.
Nel campo ID bundle, inserisci il nome dell'ID bundle iOS.
(Facoltativo) Per aggiungere un altro ID pacchetto, fai clic su Aggiungi ID pacchetto iOS. e inserisci il nome del tuo ID pacchetto iOS nel campo ID pacchetto.
(Facoltativo) Fornisci le impostazioni di Apple Developer.

Ti consigliamo di fornire questi dati perché consentono a reCAPTCHA di fornire punteggi di rischio più accurati per il tuo traffico.

Inserisci le seguenti informazioni:
- Chiave privata (.p8): viene generata in Apple Developer Center in Certificati, identificatori e Profili.
- Identificatore chiave: l'identificatore della 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.
Espandi Verifica dell'ID pacchetto e tipo di chiave.
1. Per proteggere la chiave reCAPTCHA per gli ID pacchetto, assicurati che il parametro L'opzione Disabilita verifica dell'ID pacchetto sia disattivata.
2. Per il tuo ambiente non di produzione, se vuoi specificare un punteggio che deve essere da restituire quando vengono create valutazioni:
  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.
Fai clic su Crea chiave.

La chiave appena creata è elencata nella pagina Chiavi reCAPTCHA.

Creare chiavi reCAPTCHA per le applicazioni per Android

Nel menu Scegli il tipo di piattaforma, seleziona App per Android.
Nella sezione Elenco dei pacchetti Android, fai clic su Aggiungi pacchetto Android.
Nel campo Pacchetto Android, inserisci il nome del tuo dispositivo Android. pacchetto.
(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.
Espandi Verifica del nome del pacchetto, distribuzione delle app e chiavi di test.

Per imporre che la chiave reCAPTCHA venga utilizzata solo all'interno della tua app, disattiva l'opzione di attivazione/disattivazione Disattiva la verifica del nome pacchetto.
Se vuoi creare una chiave per un'applicazione disponibile in altri store oltre che nel Google Play Store, attiva l'opzione Supporta le applicazioni distribuite al di fuori del Google Play Store.
Per il tuo ambiente non di produzione, se vuoi specificare un punteggio che deve essere da restituire quando vengono create valutazioni:
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.

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 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.
BUNDLE_IDs: ID bundle iOS delle app autorizzate a utilizzare la chiave. Specifica più ID set come 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 uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:

DISPLAY_NAME: il nome della chiave. In genere, il nome di un sito.
PACKAGE_NAMES: nomi dei pacchetti Android delle app a cui è consentito la chiave. Specifica più nomi di pacchetti come elenco separato da virgole.

Esegui la 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 seguenti sostituzioni:

DISPLAY_NAME: il nome della chiave. In genere il nome di un'app.
BUNDLE_IDs: ID bundle iOS delle app autorizzate a utilizzare la chiave. Specifica più ID pacchetto come 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 delle seguenti 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 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, 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

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 seguenti sostituzioni:

DISPLAY_NAME: nome della chiave. In genere il nome di un'app.
PACKAGE_NAMES: nomi dei pacchetti Android delle app a cui è consentito la chiave. Specifica più nomi di pacchetti come 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 delle seguenti opzioni:

curl

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'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 di Google. 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 alla CLI 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": {},
}

Creazione di chiavi reCAPTCHA per le applicazioni mobile

Prima di iniziare

Crea una chiave reCAPTCHA

Console

Creazione di chiavi reCAPTCHA per le applicazioni iOS

Creare chiavi reCAPTCHA per le applicazioni per Android

gcloud (iOS)

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

gcloud (Android)

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST (iOS)

curl

PowerShell

REST (Android)

curl

PowerShell

Passaggi successivi