E-mailmelding configureren

AEM stuurt e-mailmeldingen naar gebruikers die:

  • Hebt u zich op paginagebeurtenissen geabonneerd, bijvoorbeeld aanpassing of replicatie. De Melding in vak in deze sectie wordt beschreven hoe u zich op dergelijke gebeurtenissen kunt abonneren.

  • Hebt u zich geabonneerd op forumgebeurtenissen.

  • Een stap in een werkstroom uitvoeren. De Stap deelnemer in deze sectie wordt beschreven hoe u e-mailmeldingen in een workflow kunt activeren.

Voorwaarden:

  • Voor de gebruiker(s) moet(en) een geldig e-mailadres zijn gedefinieerd in dit profiel.
  • De CQ-mailservice op dag moet correct worden geconfigureerd.

Wanneer een gebruiker op de hoogte wordt gesteld, ontvangt hij een e-mail in de taal die in zijn profiel wordt bepaald. Elke taal heeft zijn eigen malplaatje dat kan worden aangepast. U kunt nieuwe e-mailsjablonen toevoegen voor nieuwe talen.

OPMERKING

Wanneer het werken met AEM zijn er verscheidene methodes om de configuratiemontages voor dergelijke diensten te beheren; zie OSGi configureren voor meer details en de aanbevolen werkwijzen.

De Mail Service configureren

Als AEM e-mailberichten wilt kunnen verzenden, CQ-mailservice op dag moet correct worden geconfigureerd. U kunt de configuratie in de console van het Web bekijken. Wanneer het werken met AEM zijn er verscheidene methodes om de configuratiemontages voor dergelijke diensten te beheren; zie OSGi configureren voor meer details en de aanbevolen werkwijzen.

De volgende beperkingen zijn van toepassing:

  • De SMTP-serverpoort moet 25 of hoger zijn.

  • De hostnaam SMTP-server mag niet leeg zijn.

  • De Adres "Van" mag niet leeg zijn.

Om u te helpen een probleem met CQ-mailservice op dag kunt u de logbestanden van de service bekijken:

com.day.cq.mailer.DefaultMailService

De configuratie kijkt als volgt in de console van het Web:

chlimage_1-276

Het kanaal voor e-mailmeldingen configureren

Wanneer u zich abonneert op berichten voor pagina- of forumgebeurtenissen, wordt het e-mailadres ingesteld op no-reply@acme.com standaard. U kunt deze waarde wijzigen door het dialoogvenster E-mailkanaal voor meldingen in de webconsole.

Als u het e-mailadres wilt configureren, voegt u een sling:OsgiConfig aan de gegevensopslagruimte. Gebruik de volgende procedure om de knoop direct toe te voegen gebruikend CRXDE Lite:

  1. Voeg in CRXDE Lite een map met de naam config onder de toepassingsmap.

  2. Voeg in de configuratiemap een knooppunt met de naam:

    com.day.cq.wcm.notification.email.impl.EmailChannel van het type sling:OsgiConfig

  3. Voeg een String eigenschap voor de benoemde node email.from. Geef voor de waarde het e-mailadres op dat u wilt gebruiken.

  4. Klikken Alles opslaan.

Gebruik de volgende procedure om het knooppunt in de bronmappen van het inhoudspakket te definiëren:

  1. In uw jcr_root/apps/*app_name*/config folder, maakt u een bestand met de naam com.day.cq.wcm.notification.email.impl.EmailChannel.xml

  2. Voeg de volgende XML toe om het knooppunt te vertegenwoordigen:

    <?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" jcr:primaryType="sling:OsgiConfig" email.from="name@server.com"/>

  3. Vervang de waarde van de optie email.from attribute ( name@server.com) met uw e-mailadres.

  4. Sla het bestand op.

De Workflow Email Notification Service configureren

Wanneer u e-mailmeldingen over de workflow ontvangt, worden zowel het adres van de e-mail als het URL-voorvoegsel van de host ingesteld op standaardwaarden. U kunt deze waarden wijzigen door het dialoogvenster Day CQ Workflow Email Notification Service in de webconsole. Als u dat doet, wordt aanbevolen de wijziging in de opslagplaats voort te zetten.

De standaardconfiguratie kijkt als volgt in de Console van het Web:

chlimage_1-277

E-mailsjablonen voor paginamelding

De e-mailsjablonen voor paginaberichten staan hieronder:

/libs/settings/notification-templates/com.day.cq.wcm.core.page

De standaardsjabloon Engels ( en.txt) wordt als volgt gedefinieerd:

subject=[CQ Page Event Notification]: Page Event

header=-------------------------------------------------------------------------------------\n \
Time: ${time}\n \
User: ${userFullName} (${userId})\n \
-------------------------------------------------------------------------------------\n\n

message=The following pages were affected by the event: \n \
 \n \
${modifications} \n \
 \n\n
footer=\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

E-mailsjablonen aanpassen voor paginamelding

U kunt als volgt de Engelse e-mailsjabloon voor paginabeldingen aanpassen:

  1. Open het bestand in CRXDE:

    /libs/settings/notification-templates/com.day.cq.wcm.core.page/en.txt

  2. Wijzig het bestand naar wens.

  3. Sla de wijzigingen op.

De sjabloon moet de volgende indeling hebben:

 subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

Wanneer <text_x> Dit kan een combinatie zijn van statische tekst en dynamische tekenreeksvariabelen. De volgende variabelen kunnen in de e-mailsjabloon voor paginaberichten worden gebruikt:

  • ${time}, de datum en het tijdstip van de gebeurtenis.

  • ${userFullName}, de volledige naam van de gebruiker die de gebeurtenis heeft geactiveerd.

  • ${userId}, de id van de gebruiker die de gebeurtenis heeft geactiveerd.

  • ${modifications}beschrijft het type paginagebeurtenis en het paginapad in de notatie:

    <page event="" type=""> => <page path="">

    Bijvoorbeeld:

    PageModified => /content/geometrixx/nl/products

E-mailsjablonen voor forumkennisgeving

E-mailsjablonen voor forummeldingen vindt u onder:

/etc/notification/email/default/com.day.cq.collab.forum

De standaardsjabloon Engels ( en.txt) wordt als volgt gedefinieerd:

subject=[CQ Forum Notification]

header=-------------------------------------------------------------------------------------\n \
Time: Time: ${time}\n \
Forum Page Path: ${forum.path}\n \
-------------------------------------------------------------------------------------\n\n

message=Page: ${host.prefix}${forum.path}.html\n

footer=\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

E-mailsjablonen aanpassen voor forummelding

U kunt als volgt de Engelse e-mailsjabloon voor forumkennisgeving aanpassen:

  1. Open het bestand in CRXDE:

    /etc/notification/email/default/com.day.cq.collab.forum/en.txt

  2. Wijzig het bestand naar wens.

  3. Sla de wijzigingen op.

De sjabloon moet de volgende indeling hebben:

 subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

Wanneer <text_x> Dit kan een combinatie zijn van statische tekst en dynamische tekenreeksvariabelen.

De volgende variabelen kunnen binnen het e-mailmalplaatje voor forumberichten worden gebruikt:

  • ${time}, de datum en het tijdstip van de gebeurtenis.

  • ${forum.path}, het pad naar de forumpagina.

E-mailsjablonen voor workflowmelding

Het e-mailsjabloon voor workflowmeldingen (Engels) bevindt zich op:

/libs/settings/workflow/notification/email/default/en.txt

Het wordt als volgt gedefinieerd:

subject=Workflow notification: ${event.EventType}

header=-------------------------------------------------------------------------------------\n \
Time: ${event.TimeStamp}\n \
Step: ${item.node.title}\n \
User: ${participant.name} (${participant.id})\n \
Workflow: ${model.title}\n \
-------------------------------------------------------------------------------------\n\n

message=Content: ${host.prefix}${payload.path.open}\n

footer=\n \
-------------------------------------------------------------------------------------\n \
View the overview in your ${host.prefix}/aem/inbox\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

E-mailsjablonen aanpassen voor workflowmelding

U kunt als volgt de Engelse e-mailsjabloon voor workflowgebeurtenismeldingen aanpassen:

  1. Open het bestand in CRXDE:

    /libs/settings/workflow/notification/email/default/en.txt

  2. Wijzig het bestand naar wens.

  3. Sla de wijzigingen op.

De sjabloon moet de volgende indeling hebben:

subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>
OPMERKING

Wanneer <text_x> Dit kan een combinatie zijn van statische tekst en dynamische tekenreeksvariabelen. Elke regel van een <text_x> item moet worden beëindigd met een backslash ( \), behalve in de laatste instantie, wanneer de afwezigheid van de backslash het einde van de <text_x> tekenreeksvariabele.

Meer informatie over de sjabloonindeling vindt u in de javadocs van the Properties.load() methode.

De methode ${payload.path.open} onthult de weg aan de lading van het werkpunt. Voor bijvoorbeeld een pagina in Sites, dan payload.path.open zou vergelijkbaar zijn met /bin/wcmcommand?cmd=open&path=….; dit is zonder de servernaam, die is waarom het malplaatje dit met presteert ${host.prefix}.

De volgende variabelen kunnen binnen het e-mailmalplaatje worden gebruikt:

  • ${event.EventType}, type gebeurtenis

  • ${event.TimeStamp}, datum en tijdstip van de gebeurtenis

  • ${event.User}, de gebruiker die de gebeurtenis heeft geactiveerd

  • ${initiator.home}, het pad naar het initiatorknooppunt

  • ${initiator.name}, de naam van de aanvrager

  • ${initiator.email}, e-mailadres van de aanvrager

  • ${item.id}, de id van het werkitem

  • ${item.node.id}, id van het knooppunt in het workflowmodel dat aan dit werkitem is gekoppeld

  • ${item.node.title}, titel van het werkitem

  • ${participant.email}, e-mailadres van de deelnemer

  • ${participant.name}, naam van de deelnemer

  • ${participant.familyName}, familienaam van de deelnemer

  • ${participant.id}, id van de deelnemer

  • ${participant.language}, de taal van de deelnemer

  • ${instance.id}, de workflow-id

  • ${instance.state}, de workflowstatus

  • ${model.title}, titel van het workflowmodel

  • ${model.id}, de id van het workflowmodel

  • ${model.version}, de versie van het workflowmodel

  • ${payload.data}, de lading

  • ${payload.type}, het ladingstype

  • ${payload.path}, pad van de lading

  • ${host.prefix}, hostvoorvoegsel, bijvoorbeeld: http://localhost:4502

Een e-mailsjabloon toevoegen voor een nieuwe taal

Een sjabloon toevoegen voor een nieuwe taal:

  1. Voeg in CRXDE een bestand toe <language-code>.txt hieronder:

    • /libs/settings/notification-templates/com.day.cq.wcm.core.page : voor paginameldingen
    • /etc/notification/email/default/com.day.cq.collab.forum : voor forummeldingen
    • /libs/settings/workflow/notification/email/default : voor workflowmeldingen
  2. Pas het bestand aan de taal aan.

  3. Sla de wijzigingen op.

OPMERKING

De <language-code> gebruikt als de bestandsnaam van de e-mailsjabloon moet een taalcode van twee letters in kleine letters zijn die door AEM wordt herkend. Voor taalcodes is AEM gebaseerd op ISO-639-1.

E-mailberichten voor AEM Assets configureren

Wanneer Verzamelingen in AEM Assets worden gedeeld of niet gedeeld, kunnen gebruikers e-mailmeldingen ontvangen van AEM. Voer de volgende stappen uit om e-mailmeldingen te configureren.

  1. De e-mailservice configureren, zoals hierboven beschreven in De Mail Service configureren.
  2. Meld u aan bij AEM als beheerder. Klikken Gereedschappen > Bewerkingen > Webconsole om Webconsoleconfiguratie te openen.
  3. Bewerken Day CQ DAM Resource Collection Servlet. Selecteren e-mail verzenden. Klikken Opslaan.

OAuth instellen

AEM biedt OAuth2 ondersteuning voor zijn geïntegreerde Dienst van de Aannemer, om organisaties toe te staan om e-mailvereisten te beveiligen.

U kunt OAuth configureren voor meerdere e-mailproviders, zoals hieronder wordt beschreven.

OPMERKING

Deze procedure is een voorbeeld voor een instantie Publish. Als u e-mailmeldingen wilt inschakelen voor een auteur, moet u dezelfde stappen uitvoeren voor de auteur.

Gmail

  1. Uw project maken op https://console.developers.google.com/projectcreate
  2. Selecteer uw project en ga naar API's en services - Dashboard - Credentials
  3. Configureer het scherm voor OAuth-instemming naar wens
  4. Voeg de volgende twee bereiken toe in het scherm Bijwerken:
    • https://mail.google.com/
    • https://www.googleapis.com//auth/gmail.send
  5. Als u het bereik hebt toegevoegd, gaat u terug naar Credentials in het linkermenu, ga dan naar Credentials maken - OAuth Client ID - Desktop-app
  6. Er wordt een nieuw venster geopend met daarin de client-id en het clientgeheim.
  7. Sla deze gegevens op.

AEM zijconfiguraties

OPMERKING

Adobe Managed Service-klanten kunnen met hun Customer Service Engineer samenwerken om deze wijzigingen aan te brengen in productieomgevingen.

Eerst, vorm de Dienst van de Post:

  1. Open de AEM webconsole door naar http://serveraddress:serverport/system/console/configMgr
  2. Zoeken naar en klik op CQ-mailservice op dag
  3. Voeg de volgende instellingen toe:
    • Naam SMTP-serverhost: smtp.gmail.com
    • SMTP-serverpoort: 25 of 587, afhankelijk van de vereisten
    • Schakel de vakjes in voor SMPT gebruik StarTLS en SMTP vereist StarTLS
    • Controleren OAuth-flow en klik op Opslaan.

Daarna, vorm uw leverancier SMTP OAuth door de hieronder procedure te volgen:

  1. Open de AEM webconsole door naar http://serveraddress:serverport/system/console/configMgr
  2. Zoeken naar en klik op SMTP OAuth2-provider van CQ-mailer
  3. Vul de vereiste informatie als volgt in:
    • Autorisatie-URL: https://accounts.google.com/o/oauth2/auth
    • Token-URL: https://accounts.google.com/o/oauth2/token
    • Scopes: https://www.googleapis.com/auth/gmail.send en https://mail.google.com/. U kunt meer dan één bereik toevoegen door op de knop + knoop aan de rechterkant van elk gevormd werkingsgebied.
    • Client-id en clientgeheim: configureer deze velden met de waarden die u hebt opgehaald, zoals beschreven in de bovenstaande alinea.
    • URL token vernieuwen: https://accounts.google.com/o/oauth2/token
    • Vervaldatum token vernieuwen: nooit
  4. Klikken Opslaan.

Zodra gevormd, zouden de montages als dit moeten kijken:

oauth smtp provider

Activeer nu de OAuth-componenten. U kunt dit doen door:

  1. Ga naar de componentenconsole door deze URL te bezoeken: http://serveraddress:serverport/system/console/components

  2. De volgende componenten zoeken

    • com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
    • com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
  3. Druk het pictogram van het Spel links van de componenten

    componenten

Bevestig ten slotte de configuratie door:

  1. Ga naar het adres van de instantie Publiceren en meld u aan als beheerder.
  2. Open een nieuw tabblad in de browser en ga naar http://serveraddress:serverport/services/mailer/oauth2/authorize. Dit zal u aan de pagina van uw leverancier SMTP, in dit geval Gmail opnieuw richten.
  3. Aanmelding en toestemming voor het verlenen van de vereiste machtigingen
  4. Na instemming wordt het token opgeslagen in de opslagplaats. U hebt toegang tot de accessToken door deze URL rechtstreeks te openen op uw publicatieexemplaar: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth
  5. Het bovenstaande voor elke publicatie-instantie herhalen

Microsoft Outlook

  1. Ga naar https://portal.azure.com/ en aanmelden.

  2. Zoeken naar Azure Active Directory in de zoekbalk en klik op het resultaat. U kunt ook rechtstreeks bladeren naar https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Overview

  3. Klikken op Toepassingsregistratie - Nieuwe registratie

  4. Vul de gegevens naar wens in en klik op Registreren

  5. Ga naar de nieuwe app en selecteer API-machtigingen

  6. Ga naar Machtiging toevoegen - Grafiekmachtigingen - Gedelegeerde machtigingen

  7. Selecteer de onderstaande machtigingen voor uw app en klik op Machtiging toevoegen:

    • SMTP.Send
    • Mail.Read
    • Mail.Send
    • openid
    • offline_access
  8. Ga naar Verificatie - Een platform toevoegen - Web en in de URL omleiden , voegt u de volgende URL toe voor het omleiden van de OAuth-code en drukt u vervolgens op Configureren:

    • http://localhost:4503/services/mailer/oauth2/token
  9. Het bovenstaande voor elke publicatie-instantie herhalen

  10. Configureer de instellingen volgens uw vereisten

  11. Ga vervolgens naar Certificaten en geheimen, klikt u op Nieuw clientgeheim en volg de stappen op het scherm om een geheim te maken. Let op dit geheim voor later gebruik

  12. Druk Overzicht in het linkerdeelvenster en kopieer de waarden voor Toepassings-id (client) en Directory (huurder)-id voor later gebruik

Om opnieuw te verpakken, zult u aan de volgende informatie nodig hebben om OAuth2 voor de dienst van de Aannemer op de AEM te vormen:

  • Auth URL, die met huurderidentiteitskaart zal worden geconstrueerd. Het heeft de volgende vorm: https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/authorize
  • De token-URL, die wordt samengesteld met de huurder-id. Het heeft de volgende vorm: https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/token
  • Vernieuwen URL, die met huurder identiteitskaart zal worden geconstrueerd. Het heeft de volgende vorm: https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/token
  • Client-id
  • Het clientgeheim

AEM zijconfiguraties

Vervolgens integreert u uw OAuth2-instellingen met AEM:

  1. Ga naar de webconsole van uw lokale instantie door naar http://serveraddress:serverport/system/console/configMgr
  2. Zoeken en klikken op CQ-mailservice op dag
  3. Voeg de volgende instellingen toe:
    • Naam SMTP-serverhost: smtp.office365.com
    • SMTP-gebruiker: uw gebruikersnaam in e-mailindeling
    • Adres "Van": Het e-mailadres dat moet worden gebruikt in het veld "Van:" van berichten die door de mailer worden verzonden
    • SMTP-serverpoort: 25 of 587 afhankelijk van de vereisten
    • Schakel de vakjes in voor SMPT gebruik StarTLS en SMTP vereist StarTLS
    • Controleren OAuth-flow en klik op Opslaan.
  4. Zoeken naar en klik op SMTP OAuth2-provider van CQ-mailer
  5. Vul de vereiste informatie als volgt in:
    • Vul de URL van de autorisatie-URL, de token-URL en de token-URL in door deze te maken zoals beschreven in het einde van deze procedure
    • Client-id en clientgeheim: Configureer deze velden met de waarden die u hebt opgehaald zoals hierboven beschreven.
    • Voeg de volgende Scopes aan de configuratie toe:
      • openhartig
      • offline_access
      • https://outlook.office365.com/Mail.Send
      • https://outlook.office365.com/Mail.Read
      • https://outlook.office365.com/SMTP.Send
    • AuthCode Redirect URL: http://localhost:4503/services/mailer/oauth2/token
    • URL token vernieuwen: dit zou de zelfde waarde moeten hebben zoals Symbolische Url hierboven
  6. Klikken Opslaan.

Zodra gevormd, zouden de montages als dit moeten kijken:

Activeer nu de OAuth-componenten. U kunt dit doen door:

  1. Ga naar de componentenconsole door deze URL te bezoeken: http://serveraddress:serverport/system/console/components
  2. De volgende componenten zoeken
    • com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
    • com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
  3. Druk het pictogram van het Spel links van de componenten

components2

Bevestig ten slotte de configuratie door:

  1. Ga naar het adres van de instantie Publiceren en meld u aan als beheerder.
  2. Open een nieuw tabblad in de browser en ga naar http://serveraddress:serverport/services/mailer/oauth2/authorize. Dit zal u aan de pagina van uw leverancier SMTP, in dit geval Gmail opnieuw richten.
  3. Aanmelding en toestemming voor het verlenen van de vereiste machtigingen
  4. Na instemming wordt het token opgeslagen in de opslagplaats. U hebt toegang tot de accessToken door deze URL rechtstreeks te openen op uw publicatieexemplaar: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth

Op deze pagina