DocumentazioneCommerceRiferimento configurazione

Security > Google reCAPTCHA Storefront

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

Creato per:

  • Principiante
  • Intermedio
  • Amministratore
  • Sviluppatore
  • Utente
IMPORTANT
Prima di configurare Google reCAPTCHA, è necessario assicurarsi che il file PHP.ini includa l'impostazione seguente: allow_url_fopen = 1. Questo potrebbe richiedere l’assistenza dello sviluppatore. Vedere Impostazioni PHP nella Guida all'installazione.

Per accedere alle impostazioni di configurazione dell'archivio, scegliere Stores > Settings>Configuration​dalla barra laterale_ Amministratore _.

Per ulteriori informazioni sull'utilizzo di Google reCAPTCHA per proteggere l'archivio, vedere Google reCAPTCHA nella Guida ai sistemi di amministrazione.

reCAPTCHA v2 (“I am not a robot”)

reCAPTCHA v2 (Non sono un robot)

Campo
Ambito
Descrizione
Google API Website Key
Sito Web
Chiave del sito Web creata al momento della registrazione dell'account Google reCAPTCHA.
Google API Secret Key
Sito Web
La chiave segreta associata al tuo account Google reCAPTCHA.
Size
Sito Web
La dimensione della casella Google reCAPTCHA che viene visualizzata quando un cliente accede al proprio account. Opzioni: Normal (predefinito) / Compact
Theme
Sito Web
Determina lo stile della casella Google reCAPTCHA. Opzioni: Light Theme (predefinito) / Dark Theme
Language Code
Visualizzazione store
codice a due caratteri che specifica il linguaggio utilizzato per il testo e i messaggi reCAPTCHA di Google.

reCAPTCHA v2 Invisible

reCAPTCHA v2 invisibile

Campo
Ambito
Descrizione
Google API Website Key
Sito Web
Chiave del sito Web creata al momento della registrazione dell'account Google reCAPTCHA.
Google API Secret Key
Sito Web
La chiave segreta associata al tuo account Google reCAPTCHA.
Invisible Badge Position
Sito Web
La posizione del badge reCAPTCHA invisibile su ogni pagina. Opzioni: Inline / Bottom Right / Bottom Left
Theme
Globale
Determina lo stile della casella Google reCAPTCHA. Opzioni: Light Theme (predefinito) / Dark Theme
Language Code
Visualizzazione store
codice a due caratteri che specifica il linguaggio utilizzato per il testo e i messaggi reCAPTCHA di Google.

reCAPTCHA v3 Invisible

reCAPTCHA v3 invisibile

Campo
Ambito
Descrizione
Google API Website Key
Sito Web
Chiave del sito Web creata al momento della registrazione dell'account Google reCAPTCHA.
Google API Secret Key
Sito Web
La chiave segreta associata al tuo account Google reCAPTCHA.
Minimum Score Threshold
Globale
Punteggio minimo che identifica un’interazione dell’utente come rischio potenziale, dove 1,0 è una tipica interazione dell’utente e 0,0 è probabilmente un bot. Predefinito: 0.5
Invisible Badge Position
Sito Web
La posizione del badge reCAPTCHA invisibile su ogni pagina. Opzioni: Inline / Bottom Right / Bottom Left
Theme
Sito Web
Determina lo stile della casella Google reCAPTCHA. Opzioni: Light Theme (predefinito) / Dark Theme
Language Code
Visualizzazione store
codice a due caratteri che specifica il linguaggio utilizzato per il testo e i messaggi reCAPTCHA di Google.

reCAPTCHA Enterprise

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

reCAPTCHA v3 Enterprise

Campo
Ambito
Descrizione
Site Key
Sito Web
Chiave del sito creata al momento della registrazione dell'account Google reCAPTCHA Enterprise.
Google Cloud Project ID
Sito Web
L'ID del progetto viene visualizzato nella sezione Informazioni progetto del dashboard del progetto.
Service Account JSON
Sito Web
Scarica la chiave dell’account del servizio dalla console Google Cloud e incollane il contenuto in questo campo.
Minimum Score Threshold
Sito Web
Punteggio minimo che identifica un’interazione dell’utente come rischio potenziale, dove 1,0 è una tipica interazione dell’utente e 0,0 è probabilmente un bot. Predefinito: 0.5
Badge Position
Sito Web
La posizione del badge reCAPTCHA invisibile su ogni pagina. Opzioni: Inline / Bottom Right / Bottom Left
Theme
Sito Web
Determina lo stile della casella Google reCAPTCHA. Opzioni: Light Theme (predefinito) / Dark Theme
Language Code
Visualizzazione store
codice a due caratteri che specifica il linguaggio utilizzato per il testo e i messaggi reCAPTCHA di Google. Lascia vuoto il campo per utilizzare la lingua predefinita del browser dell’utente.
Validation Failure Message
Visualizzazione store
Messaggio da visualizzare quando la convalida non riesce.

reCAPTCHA Failure Messages

Messaggi di errore

Campo
Ambito
Descrizione
reCAPTCHA Validation Failure Message
Visualizzazione store
Messaggio visualizzato nella vetrina se la verifica non riesce. Testo predefinito: reCAPTCHA verification failed.
reCAPTCHA Technical Failure Message
Visualizzazione store
Messaggio visualizzato nella vetrina se reCAPTCHA non restituisce un risultato di verifica. Testo predefinito: Something went wrong with reCAPTCHA. Please contact the store owner.

Storefront

Vetrina

NOTE
Il tipo reCAPTCHA scelto deve corrispondere al tipo associato alla chiave API dell’account Google reCAPTCHA.
WARNING
Quando si utilizza reCAPTCHA versione 3, un utente autentico con un punteggio basso non può procedere. Per la versione 2, un utente autentico con un punteggio basso riceve una sfida. Valuta attentamente se gli utenti autentici con un punteggio basso devono avere l’opportunità di risolvere un problema (versione 2) o essere bloccati (versione 3).
Campo
Ambito
Descrizione
Enable for Customer Login
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando i clienti accedono ai propri account. Opzioni:
No- (predefinito) Non convalida la richiesta di accesso.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Forgot Password
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando i clienti richiedono una reimpostazione password. Opzioni:
No- (impostazione predefinita) non convalida la richiesta di reimpostazione della password.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Create New Customer Account
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando il cliente si registra per un nuovo account. Opzioni:
No- (impostazione predefinita) non convalida la richiesta dell'account.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Edit Customer Account
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando il cliente modifica le informazioni sull'account. Opzioni:
No- (impostazione predefinita) non convalida la richiesta dell'account.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Create New Company Account
Sito Web
Adobe Commerce B2B (disponibile solo con Adobe Commerce B2B) Specifica il tipo di reCAPTCHA utilizzato per la creazione di un nuovo account società. Opzioni:
No- (impostazione predefinita) non convalida la richiesta dell'account.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Contact Us
Sito Web
Specifica il tipo di reCAPTCHA utilizzato per inviare un messaggio dalla pagina Contattaci dell'archivio. Opzioni:
No- (impostazione predefinita) non convalida la richiesta del messaggio.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Product Review
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando i clienti inviano una recensione prodotto. Opzioni:
No- (impostazione predefinita) non convalida la richiesta di revisione del prodotto.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Newsletter Subscription
Sito Web
Specifica il tipo di reCAPTCHA invisibile utilizzato quando i clienti si registrano a un abbonamento a newsletter. Opzioni:
No- (impostazione predefinita) non convalida la richiesta di abbonamento alla newsletter.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Gift Card
Sito Web
Adobe Commerce (solo Adobe Commerce) Specifica il tipo di reCAPTCHA utilizzato quando i clienti immettono un codice gift card. Opzioni:
No- (impostazione predefinita) Non convalida l'invio del codice gift card.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Invitation Create Account
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando i clienti inviano un codice di creazione account invito. Opzioni:
No- (predefinito) Non convalida l'invio dell'e-mail di invito.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Send to Friend
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando i clienti condividono un prodotto con un amico. Opzioni:
No- (impostazione predefinita) non convalida l'invio dell'e-mail.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Wishlist Sharing
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando i clienti condividono una lista dei desideri. Opzioni:
No- (impostazione predefinita) non convalida l'invio del messaggio e dell'e-mail.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for Coupon Codes
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando i clienti immettono un codice coupon. Opzioni:
No- (predefinito) Non convalida l'invio del codice coupon.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
Enable for PayPal Payflow Pro payment form
Sito Web
Specifica il tipo di reCAPTCHA utilizzato quando i clienti pagano un acquisto con PayPal Payflow Pro. Opzioni:
No- (impostazione predefinita) non convalida la richiesta di reimpostazione della password.
reCAPTCHA v2 ("I am not a robot") - Richiede che l'utente selezioni la casella di controllo Non sono un robot.
Invisible reCAPTCHA v2- Convalida il comportamento dell'utente in background senza richiedere interazioni in base al punteggio.
Invisible reCAPTCHA v3 - (consigliato) convalida il comportamento dell'utente in background in base al punteggio di interazione.
recommendation-more-help
d39aca6f-58a0-41c6-83eb-39fd0ef30672