DocumentazioneAEMGuida utente

Aggiungere Google reCAPTCHA ai moduli nell’editor universale

Ultimo aggiornamento: 21 ottobre 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Intermedio
  • Sviluppatore
  • Amministratore

Google reCAPTCHA aiuta a proteggere i moduli distinguendo tra utenti umani e bot automatizzati. Edge Delivery Services Forms supporta solo reCAPTCHA Enterprise con chiavi del sito basate su punteggi. Questa guida spiega come configurare questa protezione per i moduli in Universal Editor.

Obiettivi:

  • Configurare reCAPTCHA Enterprise con una chiave del sito basata su punteggio
  • Aggiungere reCAPTCHA ai moduli
  • Convalidare e testare l’implementazione
  • Monitorare e ottimizzare le prestazioni

Prerequisiti

Prima di iniziare, assicurati di disporre dei seguenti prerequisiti:

Requisiti di accesso

  • Accesso all’authoring di AEM as a Cloud Service
  • Accesso all’editor universale con autorizzazioni di modifica dei moduli

Requisiti tecnici

  • Account Google attivo
  • Progetto Google Cloud Platform con fatturazione abilitata
  • Verifica della proprietà del dominio per i moduli

Requisiti di conoscenza

  • Informazioni di base su AEM Forms e l’editor universale
  • Familiarità con le configurazioni del servizio cloud
  • Informazioni sui concetti di sicurezza dei moduli

Perché utilizzare reCAPTCHA nei moduli?

reCAPTCHA Enterprise valuta le interazioni degli utenti per proteggere i moduli dallo spam e dall’abuso automatizzato. Google documenta le seguenti funzionalità:

Funzionalità
Cosa fornisce Google
Valutazioni basate sul rischio
Un punteggio da 0,0 a 1,0 per ogni interazione valutata. Punteggi più alti indicano un rischio minore; punteggi più bassi indicano un rischio maggiore. Consulta Interpretare le valutazioni per i siti Web.
Protezione senza problemi
Le chiavi basate su punteggio valutano le interazioni senza visualizzare una casella di controllo o una richiesta CAPTCHA. Vedi chiavi reCAPTCHA.
Analisi e reporting
Dashboard, report globali sulle frodi e registrazione della piattaforma. Il livello Enterprise di Google offre anche analisi avanzate, report di frodi specifici per cliente e indagini sugli attacchi. Vedi Confronto delle funzionalità di Google.
Restrizioni di dominio
Le chiavi del sito web possono essere limitate a domini specifici e ai relativi sottodomini. Una chiave può coprire più domini. Vedi Creare chiavi reCAPTCHA per i siti Web.
Ulteriori protezioni contro le frodi
Il servizio più ampio di Google offre criteri personalizzati, codici dei motivi di rischio avanzati e funzioni di protezione degli account e delle transazioni. La disponibilità dipende dal livello e dalla configurazione specifica della funzione. Vedi Confronto delle funzionalità di Google.

Prezzi, quote e supporto: I costi dipendono dal livello di servizio e dal volume di valutazione di Google. L’utilizzo è soggetto a quote di Google, non illimitate. Per informazioni sui prezzi, i requisiti di abbonamento e le opzioni di supporto correnti, vedere Dettagli livello di Google. Google elenca l’assistenza clienti su tutti i suoi livelli e la gestione degli account dedicati per il suo livello Enterprise.

Configurare reCAPTCHA Enterprise

Passaggio 1: preparare l’ambiente Google Cloud

Requisiti:

  1. Progetto Google Cloud con fatturazione abilitata
  2. ID progetto (dalla dashboard GCP)
  3. Verifica del dominio per i moduli
  4. Accesso amministratore a GCP e AEM

Configurazione:

  1. Crea o seleziona un progetto Google Cloud.

    • Passa alla console di Google Cloud.
    • Crea un nuovo progetto o selezionane uno esistente.
    • Prendi nota dell’ID del progetto.

  2. Abilita API reCAPTCHA Enterprise.

    • Passa a API e servizi > Libreria.
    • Cerca “API reCAPTCHA Enterprise”.
    • Fai clic su Abilita.

  3. Crea le credenziali API.

    • Passa a API e servizi > Credenziali.
    • Fai clic su Crea credenziali > Chiave API.
    • Copia e memorizza la chiave API.

  4. Crea la chiave del sito.

    • Vai a Sicurezza > Difesa dalle frodi > Chiavi
    • Fare clic su Crea chiave e selezionare Web come tipo di applicazione
    • Aggiungi i tuoi domini.
    • Fare clic su Passaggio successivo (facoltativo) per aprire le impostazioni aggiuntive
    • Conserva: utilizzerai le sfide? disattivato per creare una chiave del sito basata su punteggio
    • Fai clic su Crea chiave e copia la chiave del sito

Checkpoint di convalida: assicurati di disporre di:

  • ID progetto
  • Chiave API
  • Chiave sistema
  • Dominio verificato in Google Cloud
Passaggio 2: configurare un contenitore della configurazione cloud AEM

Configurazione della configurazione cloud dettagliata
Figura: abilitazione delle configurazioni cloud per il contenitore di moduli

Configurazione:

  1. Accedi al browser di configurazione

    • Accedi all’istanza di authoring di AEM.
    • Passare a Strumenti > Generale > Browser di configurazione

  2. Abilitare configurazioni cloud

    • Individuare il contenitore di configurazione del modulo
    • Selezionare le proprietà
    • Controllare le configurazioni cloud
    • Fare clic su Salva e chiudi

  3. Verifica la configurazione.

    • Confermare che “Configurazioni cloud” sia visualizzato nelle proprietà del contenitore

Punto di controllo di convalida:

  • Configurazioni cloud abilitate per il contenitore
  • Il contenitore viene visualizzato nel browser di configurazione
  • Le proprietà mostrano “Configurazioni cloud” come abilitato
Passaggio 3: configurare il servizio reCAPTCHA Enterprise in AEM

Schermata di configurazione di reCAPTCHA Enterprise
Figura: interfaccia di configurazione Enterprise reCAPTCHA in AEM

Configurazione:

  1. Accedere alla configurazione reCAPTCHA

    • Passa a Strumenti > Servizi cloud > reCAPTCHA.
    • Seleziona il contenitore di configurazione del modulo.
    • Fai clic su Crea.

  2. Configurare le impostazioni Enterprise

    • Titolo: nome descrittivo (ad esempio, “Produzione reCAPTCHA”)
    • Nome: nome del sistema (generato automaticamente o personalizzato)
    • Versione: seleziona ReCAPTCHA Enterprise
    • ID progetto: immetti l’ID del progetto Google Cloud
    • Chiave del sito: immetti la chiave del sito da Google Cloud
    • Chiave API: immetti la chiave API di Google Cloud
    • Tipo di chiave: seleziona la chiave del sito basata sul punteggio

  3. Imposta la soglia di sicurezza

    • Punteggio della soglia: imposta tra 0,0 e 1,0

    • Valori consigliati:

      • 0,7-0,9: sicurezza alta (può bloccare alcuni utenti legittimi)
      • 0,5-0,7: sicurezza bilanciata (consigliata)
      • 0,1-0,5: sicurezza ridotta (consente a più utenti)

  4. Salva e pubblica

    • Fai clic su Crea per salvare la configurazione
    • Fai clic su Pubblica per renderla disponibile

Punto di controllo per la convalida:

  • Configurazione salvata correttamente
  • Tutti i campi obbligatori completati
  • Configurazione pubblicata e visibile
  • Nessun messaggio di errore

Aggiungere reCAPTCHA a un modulo

Dopo aver configurato il servizio reCAPTCHA, aggiungi la protezione al modulo come segue:

Aggiunta del componente reCAPTCHA a un modulo
Figura: aggiunta del componente Captcha invisibile al modulo

​1. Apri modulo nell’editor universale

Passa al modulo in AEM Sites e fai clic su Modifica per aprirlo nell’editor universale. Attendi il caricamento dell’editor.

  • Passa al modulo in AEM Sites.
  • Fai clic su Modifica per aprirlo nell’editor universale.
  • Attendi il caricamento dell’editor
​2. Individuare la struttura del modulo

Nella struttura del contenuto (pannello a sinistra), individua la sezione Modulo adattivo ed espandi la struttura del modulo per visualizzare i punti di inserimento.

  • Nella struttura del contenuto (pannello a sinistra), individua la sezione Modulo adattivo.
  • Espandi la struttura del modulo per visualizzare i punti di inserimento.
​3. Aggiungi componente reCAPTCHA

Aggiungi al modulo il componente captcha (invisibile).

  • Fai clic sull’icona Aggiungi (+) nella sezione del modulo.
  • Dall’elenco dei componenti, seleziona Captcha (invisibile).
  • In alternativa, trascina il componente dal pannello Componenti.
​4. Configura componente (facoltativo)

Seleziona il componente captcha appena aggiunto e verifica che utilizzi la configurazione reCAPTCHA che hai creato.

  • Seleziona il componente Captcha appena aggiunto.
  • Nel pannello Proprietà, verifica che utilizzi la configurazione reCAPTCHA precedentemente salvata.
  • Non è necessaria alcuna configurazione aggiuntiva per la configurazione di base.
​5. Pubblicare Le Modifiche

Pubblica le modifiche e verifica che non vi siano errori.

  • Fai clic su Pubblica nell’editor universale.
  • Attendi la conferma.
  • Verifica che non vengano visualizzati errori.

Verificare l’implementazione

Il modulo protetto è ora disponibile all’indirizzo:

https://<branch>--<repo>--<owner>.aem.live/content/forms/af/
<form-name>

URL di esempio:

https://main--my-forms--company.aem.live/content/forms/af/
contact-us-form
recommendation-more-help
experience-manager-cloud-service-help-main-toc