Documentazione AEM as a Cloud Service Guida utente

Pubblicare un modulo adattivo in Edge Delivery Services

Last update: Fri Mar 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Edge Delivery Services

Creato per:

Amministratore
Sviluppatore

Questa funzione è disponibile tramite il programma per i primi utilizzatori. Per richiedere l’accesso, invia un’e-mail con il nome dell’organizzazione e il nome dell’archivio GitHub dall’indirizzo ufficiale a aem-forms-ea@adobe.com. Ad esempio, se l’URL dell’archivio è https://github.com/adobe/abc, il nome dell’organizzazione è adobe e il nome dell’archivio è abc.

Quando un modulo è finalizzato e pronto per l’uso, puoi pubblicarlo per renderlo accessibile ai tuoi clienti per la raccolta e l’invio di dati. Una volta pubblicato, il modulo diventa disponibile su Edge Delivery e gli utenti possono interagire direttamente con esso. Questo processo consente ai clienti di compilare e inviare il modulo in tempo reale, rende più efficiente l’acquisizione dei dati e ne semplifica l’elaborazione.

Prerequisiti

Modulo creato utilizzando il modello Edge Delivery Services. Ulteriori informazioni su come creare un modulo basato su EDS.

Pubblicare il modulo

Puoi pubblicare qualsiasi modulo adattivo basato su EDS in Edge Delivery seguendo questi passaggi:

Apri il modulo adattivo nell’editor e fai clic sull’icona Pubblica nella barra superiore.
Quando fai clic su Pubblica, viene visualizzata una schermata o una finestra a comparsa che mostra le risorse da pubblicare, incluso il titolo del modulo. In questo esempio viene utilizzato il modello Wknd_Form.
Fai di nuovo clic su Pubblica per visualizzare un messaggio a comparsa di conferma, che indica che il modulo è ora pubblicato.
Per verificare lo stato di pubblicazione del modulo, fai di nuovo clic su Pubblica.
Per annullare la pubblicazione di un modulo, apri il modulo nell’editor, fai clic sul menu con i tre punti in alto a destra e fai clic su Annulla pubblicazione.

Abilitare l’invio di moduli su Edge Delivery configurando un filtro Referrer per AEM Publisher

Per garantire l’invio sicuro dei moduli, è necessario configurare un filtro referrer in AEM Publish. Questo filtro garantisce che solo le richieste autorizzate da Edge Delivery possano eseguire operazioni di scrittura (POST, PUT, DELETE, COPY, MOVE), impedendo modifiche non autorizzate. Di seguito sono riportati i passaggi necessari per configurare un filtro Referrer per AEM Publish:

Aggiornare l’URL dell’istanza di AEM in Edge Delivery

Modifica il valore submitBaseUrl nel file constant.js all’interno del blocco del modulo per specificare l’URL dell’istanza di AEM:

Per la configurazione cloud:

export const submitBaseUrl = 'https://publish-p120-e12.adobeaemcloud.com';

Per lo sviluppo locale:

export const submitBaseUrl = 'http://localhost:4503';

Modificare la configurazione CORS

Regola le impostazioni CORS per consentire le richieste di invio di moduli dai domini Edge Delivery. Per informazioni, consulta la Guida alla configurazione CORS.

Configurazione CORS di esempio:

# Developer Localhost
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(http://localhost(:\d+)?$)#" CORSTrusted=true

# Franklin Stage
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.page$)#" CORSTrusted=true

# Franklin Live
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.live$)#" CORSTrusted=true

Per lo sviluppo locale, consulta la documentazione per abilitare CORS dall’URL host dell’interfaccia utente di sviluppo.

Configurare il filtro Referrer

Configura il filtro Referrer in AEM Cloud Service tramite Cloud Manager. Ulteriori informazioni sulla configurazione del filtro referrer in un’istanza di AEM Cloud Service tramite Cloud Manager.

Configurazione JSON per il filtro Referrer:

{
  "allow.empty": false,
  "allow.hosts": [],
  "allow.hosts.regexp": [
    "https://.*\\.hlx\\.page:443",
    "https://.*\\.hlx\\.live:443"
  ],
  "filter.methods": [
    "POST",
    "PUT",
    "DELETE",
    "COPY",
    "MOVE"
  ],
  "exclude.agents.regexp": [
    ""
  ]
}

Questa configurazione specifica quali metodi HTTP vengono filtrati, quali referrer sono consentiti e quali agenti utente sono esclusi dal filtro. Implementando queste configurazioni, gli invii di moduli tramite Edge Delivery saranno protetti e limitati alle sole origini autorizzate.

Accedere al modulo adattivo pubblicato

Il modulo adattivo è ora accessibile tramite Edge Delivery utilizzando il seguente formato URL:

https://<branch>--<repo>--<owner>.aem.page/content/forms/af/<form_name>

Ad esempio, l’URL per Wknd-Form è:

https://main--universaleditor--wkndforms.aem.live/content/forms/af/wknd-form

Consulta anche

recommendation-more-help