DocumentazioneCommerceGuida ai sistemi di amministrazione

[Solo SaaS]{class="badge positive" title="Applicabile solo ai progetti Adobe Commerce as a Cloud Service (infrastruttura SaaS gestita da Adobe)."}

Google reCAPTCHA Enterprise

Last update: Tue Jan 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Principiante
  • Intermedio
  • Amministratore

Google reCAPTCHA Enterprise fornisce protezione avanzata da bot per la vetrina Adobe Commerce as a Cloud Service utilizzando l'analisi adattiva dei rischi e l'apprendimento automatico per distinguere utenti umani e bot. Questo aiuta a prevenire attività fraudolente, spam e abusi sul tuo sito.

NOTE
Questa funzione NON fornisce il supporto reCAPTCHA per l’amministratore.

Vedere Google reCAPTCHA V3 e V2 per informazioni sulla configurazione di altre versioni di Google reCAPTCHA.

Funzioni

Google reCAPTCHA Enterprise include le seguenti funzionalità:

  • Rilevamento avanzato bot: utilizza i modelli di apprendimento automatico di Google Cloud per il rilevamento avanzato dei bot
  • Analisi del punteggio di rischio: fornisce punteggi di rischio dettagliati (0,0-1,0) per ogni interazione
  • Soglie configurabili: imposta i punteggi minimi di rischio accettabili per tenant
  • Supporto multi-tenant: configurazione per tenant con progetti Google Cloud isolati
  • Credenziali crittografate: credenziali dell'account del servizio archiviate crittografate in un database
  • Protezione modulo: protegge tutti i moduli Commerce standard, inclusi accesso, pagamento, recensioni dei prodotti e altro ancora.

Prerequisiti

Prima di configurare Google reCAPTCHA Enterprise per la vetrina Adobe Commerce as a Cloud Service sono necessarie le seguenti risorse:

  • Un account Google Cloud attivo con reCAPTCHA Enterprise abilitato.
  • Accedi alla console Google Cloud per creare e gestire le chiavi aziendali reCAPTCHA.

Nelle installazioni Adobe Commerce as a Cloud Service con più tenant, ogni tenant deve disporre del proprio progetto Google Cloud e delle chiavi aziendali reCAPTCHA.

Passaggio 1: configurare Google reCAPTCHA Enterprise

Segui questi passaggi generali per configurare Google reCAPTCHA Enterprise per la vetrina. Per istruzioni dettagliate, consulta la documentazione aziendale di Google reCAPTCHA.

  1. Crea un progetto Google Cloud per l'implementazione reCAPTCHA Enterprise.

  2. Abilita l'API aziendale reCAPTCHA.

  3. Crea una chiave del sito dell'organizzazione reCAPTCHA basata su punteggio.

  4. Creare un account di servizio con il ruolo IAM roles/recaptchaenterprise.admin.

  5. Scarica il file della chiave JSON dell’account di servizio, che contiene le credenziali necessarie per autenticare la vetrina Adobe Commerce as a Cloud Service con Google reCAPTCHA Enterprise.

Passaggio 2: configurare Google reCAPTCHA per la vetrina

  1. Nel pannello a sinistra in Security, scegli Google reCAPTCHA Storefront.

  2. Completare la sezione reCAPTCHA Enterprise come segue.

    • Per Site Key, copia e incolla la chiave del sito aziendale reCAPTCHA dalla console Google Cloud.

    • Per Google Cloud Project ID, copia e incolla l'ID progetto dal tuo progetto Google Cloud.

    • Per Service Account JSON, copiare il contenuto del file di chiave JSON dell'account del servizio scaricato in Passaggio 1: configurare Google reCAPTCHA Enterprise.

    • Per Minimum Score Threshold, immetti il punteggio minimo (0,0-1,0) per identificare quando un'interazione dell'utente viene segnalata come rischio potenziale. Un punteggio di 1,0 è una tipica interazione dell’utente e 0,0 è probabilmente un bot.

    • Per Badge Position, scegli la posizione del badge reCAPTCHA invisibile su ogni pagina. Opzioni: Inline / Bottom Right / Bottom Left.

    • Per Theme, scegliere Light Theme (impostazione predefinita) o Dark Theme per determinare lo stile della casella reCAPTCHA di Google.

    • Per Language Code, immetti un codice a due caratteri che specifica il linguaggio utilizzato per il testo e i messaggi reCAPTCHA di Google.

    • Per Validation Failure Message, è possibile modificare il messaggio visualizzato nella vetrina quando la convalida non ha esito positivo.

  3. Espandere la sezione Storefront e impostare ogni modulo della vetrina che si desidera proteggere su reCAPTCHA Enterprise.

Passaggio 3: salvare la configurazione

  1. Al termine delle impostazioni di configurazione, fare clic su Save Config.

  2. Nel messaggio nella parte superiore dell'area di lavoro, fare clic su Cache Management e aggiornare ogni cache non valida.

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1