DocumentaciónAEMTutoriales de AEMTutoriales de AEM as a Cloud Service

Servicio de correo electrónico

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

Creado para:

  • Intermedio
  • Desarrollador

Envíe correos electrónicos desde AEM as a Cloud Service AEM configurando el uso de puertos de salida de red avanzados de DefaultMailService para que se utilicen.

Como la mayoría de los servicios de correo no se ejecutan a través de HTTP/HTTPS, las conexiones a los servicios de correo de AEM as a Cloud Service deben procesarse como proxy de salida.

  • smtp.host se ha establecido en la variable de entorno OSGi $[env:AEM_PROXY_HOST;default=proxy.tunnel], de modo que se enrute a través de la salida.

    • $[env:AEM_PROXY_HOST] es una variable reservada que AEM as a Cloud Service asigna al host proxy.tunnel interno.
    • NO intente establecer AEM_PROXY_HOST a través de Cloud Manager.

  • smtp.port se ha establecido en el puerto portForward.portOrig que se asigna al host y al puerto del servicio de correo electrónico de destino. Este ejemplo utiliza la asignación: AEM_PROXY_HOST:30465 → smtp.sendgrid.com:465.

    • smpt.port está establecido en el puerto portForward.portOrig y NO en el puerto real del servidor SMTP. La regla portForwards de Cloud Manager ha establecido la asignación entre el puerto smtp.port y el puerto portForward.portOrig (como se muestra a continuación).

Dado que los secretos no deben almacenarse en el código, es mejor proporcionar el nombre de usuario y la contraseña del servicio de correo electrónico utilizando variables de configuración OSGi secretas, configuradas mediante AIO CLI o la API de Cloud Manager.

Normalmente, salida de puerto flexible se usa para satisfacer la integración con un servicio de correo electrónico a menos que sea necesario allowlist la IP de Adobe, en cuyo caso se puede usar dirección IP de salida dedicada.

AEM Además, revise la documentación de la sobre envío de correo electrónico.

Compatibilidad avanzada con redes

Las siguientes opciones avanzadas de red admiten el siguiente ejemplo de código.

Asegúrese de que la configuración avanzada de red proper se haya configurado antes de seguir este tutorial.

Sin redes avanzadas
Salida de puerto flexible
Dirección IP de salida dedicada
Red privada virtual
✘
✔
✔
✔

Configuración de OSGi

AEM En este ejemplo de configuración de OSGi se configura el servicio OSGi de correo electrónico de los usuarios para que utilicen un servicio de correo externo, mediante la siguiente regla de Cloud Manager portForwards de la operación 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

AEM Configure la configuración de DefaultMailService según lo requiera su proveedor de correo electrónico (por ejemplo, smtp.ssl, etc.).

{
    "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 variable OSGi EMAIL_USERNAME y EMAIL_PASSWORD, así como el secreto, se pueden establecer por entorno mediante:

  • Configuración del entorno de Cloud Manager

  • o utilizando el 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