E-mailmelding configureren configuring-email-notification
AEM stuurt e-mailmeldingen naar gebruikers die:
-
Hebt u zich op paginagebeurtenissen geabonneerd, bijvoorbeeld, wijziging 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 Day CQ Mail Service 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.
De e-mailservice configureren configuring-the-mail-service
Als AEM e-mailberichten wilt kunnen verzenden, Day CQ Mail Service 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 Day CQ Mail Service kunt u de logbestanden van de service bekijken:
com.day.cq.mailer.DefaultMailService
De configuratie kijkt als volgt in de console van het Web:
Het kanaal voor e-mailmeldingen configureren configuring-the-email-notification-channel
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:
-
Voeg in CRXDE Lite een map met de naam
config
onder de toepassingsmap. -
Voeg in de configuratiemap een knooppunt met de naam:
com.day.cq.wcm.notification.email.impl.EmailChannel
van het typesling:OsgiConfig
-
Voeg een
String
eigenschap voor de benoemde nodeemail.from
. Geef voor de waarde het e-mailadres op dat u wilt gebruiken. -
Klikken Alles opslaan.
Gebruik de volgende procedure om het knooppunt in de bronmappen van het inhoudspakket te definiëren:
-
In uw
jcr_root/apps/*app_name*/config folder
, maakt u een bestand met de naamcom.day.cq.wcm.notification.email.impl.EmailChannel.xml
-
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"/>
-
Vervang de waarde van de optie
email.from
attribute (name@server.com
) met uw e-mailadres. -
Sla het bestand op.
De Workflow Email Notification Service configureren configuring-the-workflow-email-notification-service
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:
E-mailsjablonen voor paginamelding email-templates-for-page-notification
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 customizing-email-templates-for-page-notification
U kunt als volgt de Engelse e-mailsjabloon voor paginabeldingen aanpassen:
-
Open het bestand in CRXDE:
/libs/settings/notification-templates/com.day.cq.wcm.core.page/en.txt
-
Wijzig het bestand naar wens.
-
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 workflowmelding email-templates-for-workflow-notification
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 customizing-email-templates-for-workflow-notification
U kunt als volgt de Engelse e-mailsjabloon voor workflowgebeurtenismeldingen aanpassen:
-
Open het bestand in CRXDE:
/libs/settings/workflow/notification/email/default/en.txt
-
Wijzig het bestand naar wens.
-
Sla de wijzigingen op.
De sjabloon moet de volgende indeling hebben:
subject=<text_1>
header=<text_2>
message=<text_3>
footer=<text_4>
<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>
tekenreeksvariabeleDe 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, daarom wordt dit door de sjabloon voorafgegaan ${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 adding-an-email-template-for-a-new-language
Een sjabloon toevoegen voor een nieuwe taal:
-
Voeg in CRXDE een bestand toe
<language-code>.txt
hieronder:/libs/settings/notification-templates/com.day.cq.wcm.core.page
: voor paginameldingen/libs/settings/workflow/notification/email/default
: voor workflowmeldingen
-
Pas het bestand aan de taal aan.
-
Sla de wijzigingen op.
<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 assetsconfig
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.
- De e-mailservice configureren, zoals hierboven beschreven in De e-mailservice configureren.
- Meld u aan bij AEM als beheerder. Klikken Gereedschappen > Bewerkingen > Webconsole om de Configuratie van de Console van het Web te openen.
- Bewerken Day CQ DAM Resource Collection Servlet. Selecteren e-mail verzenden. Klikken Opslaan.
OAuth instellen setting-up-oauth
AEM biedt OAuth2 steun 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.
Gmail gmail
-
Uw project maken op
https://console.developers.google.com/projectcreate
-
Selecteer uw project en ga naar API's en services - Dashboard - Credentials
-
Configureer het scherm voor OAuth-instemming naar wens
-
Voeg de volgende twee bereiken toe in het scherm Bijwerken:
https://mail.google.com/
https://www.googleapis.com//auth/gmail.send
-
Als u het bereik hebt toegevoegd, gaat u terug naar Credentials in het linkermenu, ga dan naar Credentials maken - OAuth-client-id - Desktop-app
-
Er wordt een nieuw venster geopend met daarin de client-id en het clientgeheim.
-
Sla deze gegevens op.
AEM zijconfiguraties
Eerst, vorm de Dienst van de Post:
-
Open de AEM webconsole door naar
http://serveraddress:serverport/system/console/configMgr
-
Zoeken naar en klik vervolgens op Day CQ Mail Service
-
Voeg de volgende instellingen toe:
- Naam SMTP-serverhost:
smtp.gmail.com
- SMTP-serverpoort:
25
of587
, afhankelijk van de vereisten - Schakel de vakjes in voor SMPT gebruik StarTLS en SMTP vereist StarTLS
- Controleren OAuth-flow en klik op Opslaan.
- Naam SMTP-serverhost:
Daarna, vorm uw leverancier SMTP OAuth door de hieronder procedure te volgen:
-
Open de AEM webconsole door naar
http://serveraddress:serverport/system/console/configMgr
-
Zoeken naar en klik vervolgens op SMTP OAuth2-provider van CQ-mailer
-
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
enhttps://mail.google.com/
. U kunt meer dan één bereik toevoegen door op de knop + knoop aan de rechterkant van elk gevormd werkingsgebied. - Client ID and Client Secret: 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
- Autorisatie-URL:
-
Klikken Opslaan.
Zodra gevormd, zouden de montages als dit moeten kijken:
Activeer nu de OAuth-componenten. U kunt dit doen door:
-
Ga naar de componentenconsole door deze URL te bezoeken:
http://serveraddress:serverport/system/console/components
-
De volgende componenten zoeken
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
-
Druk het pictogram van het Spel links van de componenten
Bevestig ten slotte de configuratie door:
- Ga naar het adres van de instantie Publiceren en meld u aan als beheerder.
- 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. - Aanmelding en toestemming voor het verlenen van de vereiste machtigingen
- Na instemming wordt het token opgeslagen in de opslagplaats. U hebt toegang tot dit bestand onder
accessToken
door deze URL rechtstreeks te openen op uw publicatieexemplaar:http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth
- Het bovenstaande voor elke publicatie-instantie herhalen
Microsoft Outlook microsoft-outlook
-
Ga naar https://portal.azure.com/ en aanmelden.
-
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
-
Klikken op Toepassingsregistratie - Nieuwe registratie
-
Vul de gegevens naar wens in en klik op Registreren
-
Ga naar de nieuwe app en selecteer API-machtigingen
-
Ga naar Machtiging toevoegen - Grafiekmachtigingen - Gedelegeerde machtigingen
-
Selecteer de onderstaande machtigingen voor uw app en klik op Machtiging toevoegen:
SMTP.Send
Mail.Read
Mail.Send
openid
offline_access
-
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
-
Het bovenstaande voor elke publicatie-instantie herhalen
-
Configureer de instellingen volgens uw vereisten
-
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
-
Druk Overzicht in het linkerdeelvenster en kopieer de waarden voor Toepassings-id (client) en Directory (huurder)-id voor later gebruik
Om opnieuw te verpakken, moet u de volgende informatie 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:
-
Ga naar de webconsole van uw lokale instantie door naar
http://serveraddress:serverport/system/console/configMgr
-
Zoeken en klikken Day CQ Mail Service
-
Voeg de volgende instellingen toe:
- Naam SMTP-serverhost:
smtp.office365.com
- SMTP-gebruiker: uw gebruikersnaam in e-mailindeling
- Het adres 'Van': Het e-mailadres dat moet worden gebruikt in het veld 'Van:' van berichten die door de mailer worden verzonden
- SMTP-serverpoort:
25
of587
afhankelijk van de vereisten - Schakel de vakjes in voor SMPT gebruik StarTLS en SMTP vereist StarTLS
- Controleren OAuth-flow en klik op Opslaan.
- Naam SMTP-serverhost:
-
Zoeken naar en klik vervolgens op SMTP OAuth2-provider van CQ-mailer
-
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
-
Clientid 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
-
Token-URL vernieuwen: deze moet dezelfde waarde hebben als de bovenstaande token-URL
-
-
Klikken Opslaan.
Zodra gevormd, zouden de montages als dit moeten kijken:
Activeer nu de OAuth-componenten. U kunt dit doen door:
-
Ga naar de componentenconsole door deze URL te bezoeken:
http://serveraddress:serverport/system/console/components
-
De volgende componenten zoeken
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
-
Druk het pictogram van het Spel links van de componenten
Bevestig ten slotte de configuratie door:
- Ga naar het adres van de instantie Publiceren en meld u aan als beheerder.
- 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 Vooruitzichten opnieuw richten. - Aanmelding en toestemming voor het verlenen van de vereiste machtigingen
- Na instemming wordt het token opgeslagen in de opslagplaats. U hebt toegang tot dit bestand onder
accessToken
door deze URL rechtstreeks te openen op uw publicatieexemplaar:http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth