DocumentazioneAEMTutorial su AEMTutorial su AEM as a Cloud Service

Servizio e-mail

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Intermedio
  • Sviluppatore

Invia e-mail da AEM as a Cloud Service configurando DefaultMailService dell'AEM per utilizzare porte di uscita di rete avanzate.

Poiché la maggior parte dei servizi di posta non viene eseguita su HTTP/HTTPS, le connessioni ai servizi di posta da AEM as a Cloud Service devono essere escluse.

  • smtp.host è impostato sulla variabile di ambiente OSGi $[env:AEM_PROXY_HOST;default=proxy.tunnel] in modo che venga instradato attraverso l'uscita.

    • $[env:AEM_PROXY_HOST] è una variabile riservata mappata da AEM as a Cloud Service all'host proxy.tunnel interno.
    • NON tentare di impostare AEM_PROXY_HOST tramite Cloud Manager.

  • smtp.port è impostato sulla porta portForward.portOrig mappata all'host e alla porta del servizio e-mail di destinazione. In questo esempio viene utilizzata la mappatura: AEM_PROXY_HOST:30465 → smtp.sendgrid.com:465.

    • smpt.port è impostato sulla porta portForward.portOrig e NON sulla porta effettiva del server SMTP. Il mapping tra smtp.port e la porta portForward.portOrig è stabilito dalla regola Cloud Manager portForwards (come illustrato di seguito).

Poiché i segreti non devono essere archiviati nel codice, è consigliabile fornire il nome utente e la password del servizio e-mail utilizzando variabili di configurazione OSGi segrete, impostate utilizzando la CLI AIO o l'API Cloud Manager.

In genere, l'uscita da porta flessibile viene utilizzata per soddisfare l'integrazione con un servizio e-mail a meno che non sia necessario allowlist l'IP Adobe, nel qual caso è possibile utilizzare l'indirizzo IP in uscita dedicato.

Inoltre, esaminare la documentazione AEM in invio di posta elettronica.

Supporto di rete avanzato

Il codice di esempio seguente è supportato dalle seguenti opzioni di rete avanzate.

Prima di seguire questa esercitazione, assicurati che la configurazione di rete avanzata appropriata sia stata configurata.

Nessuna rete avanzata
Uscita porta flessibile
Indirizzo IP in uscita dedicato
Rete privata virtuale
✘
✔
✔
✔

Configurazione OSGi

Questo esempio di configurazione OSGi configura il servizio OSGi Mail di AEM per l'utilizzo di un servizio di posta esterno, tramite la seguente regola di Cloud Manager portForwards dell'operazione enableEnvironmentAdvancedNetworkingConfiguration.

...
"portForwards": [{
    "name": "smtp.mymail.com",
    "portDest": 465,
    "portOrig": 30465
}]
...
  • ui.config/src/jcr_root/apps/wknd-examples/osgiconfig/config/com.day.cq.mailer.DefaultMailService.cfg.json

Configura il DefaultMailService dell'AEM come richiesto dal tuo provider di posta elettronica (ad esempio smtp.ssl, ecc.).

{
    "smtp.host": "$[env:AEM_PROXY_HOST;default=proxy.tunnel]",
    "smtp.port": "30465",
    "smtp.user": "$[env:EMAIL_USERNAME;default=myApiKey]",
    "smtp.password": "$[secret:EMAIL_PASSWORD]",
    "from.address": "noreply@wknd.site",
    "smtp.ssl": true,
    "smtp.starttls": false,
    "smtp.requiretls": false,
    "debug.email": false,
    "oauth.flow": false
}

La variabile OSGi EMAIL_USERNAME e EMAIL_PASSWORD e il segreto possono essere impostati per ambiente utilizzando:

  • Configurazione ambiente Cloud Manager

  • o utilizzando il comando aio CLI

    code language-shell 
    $ aio cloudmanager:set-environment-variables --programId=<PROGRAM_ID> <ENVIRONMENT_ID> --secret EMAIL_USERNAME "myApiKey" --secret EMAIL_PASSWORD "password123"
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69