E-mailservice

Verzend e-mailberichten vanuit AEM as a Cloud Service door AEM DefaultMailService te configureren voor het gebruik van geavanceerde poorten voor netwerktoegang.

Omdat (de meeste) de postdiensten niet over HTTP/HTTPS lopen, moeten de verbindingen aan de postdiensten van AEM as a Cloud Service proxied uit zijn.

  • smtp.host wordt ingesteld op de OSGi-omgevingsvariabele $[env:AEM_PROXY_HOST;default=proxy.tunnel] , zodat deze door het egress wordt geleid.

    • $[env:AEM_PROXY_HOST] is een gereserveerde variabele die AEM as a Cloud Service toewijst aan de interne proxy.tunnel -host.
    • Probeer NIET om AEM_PROXY_HOST via Cloud Manager in te stellen.
  • smtp.port wordt ingesteld op de portForward.portOrig -poort die wordt toegewezen aan de host en poort van de e-mailservice van het doel. In dit voorbeeld wordt de toewijzing AEM_PROXY_HOST:30465smtp.sendgrid.com:465 gebruikt.

    • smpt.port wordt geplaatst aan de portForward.portOrig haven, en NIET de daadwerkelijke haven van de server SMTP. De toewijzing tussen de smtp.port en de portForward.portOrig -poort wordt bepaald door de Cloud Manager portForwards -regel (zoals hieronder wordt getoond).

Aangezien de geheimen niet in code moeten worden opgeslagen, worden de gebruikersbenaming en het wachtwoord van de e-maildienst best verstrekt gebruikend geheime OSGi configuratievariabelen, geplaatst gebruikend AIO CLI, of Cloud Manager API.

Typisch, flexibel havenuitgangwordt gebruikt om het integreren met de e-maildienst tevreden te stellen tenzij het aan allowlist Adobe IP noodzakelijk is, waarin specifiek adres van de uitgangkan worden gebruikt.

Bovendien, herzie AEM documentatie op verzendend e-mail.

Geavanceerde netwerkondersteuning

Het volgende codevoorbeeld wordt gesteund door de volgende geavanceerde voorzien van een netwerkopties.

Verzeker aangewezengeavanceerde voorzien van een netwerkconfiguratie voorafgaand aan het volgen van dit leerprogramma is opstelling.

Geen geavanceerde netwerken
Flexibele havenuitgang
Dedicated egress IP adres
Virtueel Privé Netwerk

OSGi-configuratie

Dit OSGi configuratievoorbeeld vormt AEM de Dienst van Mail OSGi om een externe postdienst, als volgende Cloud Manager portForwards regel van de enableEnvironmentAdvancedNetworkingConfigurationverrichting te gebruiken.

...
"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

Vorm AEM DefaultMailServicezoals vereist door uw e-mailleverancier (b.v. smtp.ssl, enz.).

{
    "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
}

De variabele EMAIL_USERNAME en EMAIL_PASSWORD OSGi en het geheim kunnen per milieu worden geplaatst, gebruikend één van beiden:

  • de Configuratie van het Milieu van Cloud Manager

  • of met de opdracht 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