이메일 알림 구성 configuring-email-notification

AEM은 다음과 같은 사용자에게 이메일 알림을 보냅니다.

  • 페이지 이벤트(예: 수정 또는 복제)를 구독했습니다. 다음 알림 받은 편지함 섹션에서는 이러한 이벤트를 구독하는 방법에 대해 설명합니다.

  • 포럼 이벤트를 구독했습니다.

  • 워크플로우에서 단계를 수행해야 합니다. 다음 참가자 단계 섹션에서는 워크플로우에서 이메일 알림을 트리거하는 방법을 설명합니다.

전제 조건:

  • 사용자는 프로필에 유효한 이메일 주소가 정의되어 있어야 합니다.
  • 다음 일별 CQ 메일 서비스 을(를) 올바르게 구성해야 합니다.

사용자에게 알림이 전송되면 사용자는 프로필에 정의된 언어로 이메일을 수신하게 됩니다. 각 언어에는 사용자 지정할 수 있는 자체 템플릿이 있습니다. 새 언어에 대해 새 이메일 템플릿을 추가할 수 있습니다.

NOTE
AEM을 사용하여 작업할 때 이러한 서비스에 대한 구성 설정을 관리하는 방법에는 몇 가지가 있습니다. 다음을 참조하십시오. OSGi 구성 를 참조하십시오.

메일 서비스 구성 configuring-the-mail-service

AEM에서 이메일을 보낼 수 있도록 일별 CQ 메일 서비스 을(를) 올바르게 구성해야 합니다. 웹 콘솔에서 구성을 볼 수 있습니다. AEM을 사용하여 작업할 때 이러한 서비스에 대한 구성 설정을 관리하는 방법에는 몇 가지가 있습니다. 다음을 참조하십시오. OSGi 구성 를 참조하십시오.

다음과 같은 제한이 적용됩니다.

  • 다음 SMTP 서버 포트 은(는) 25 이상이어야 합니다.

  • 다음 SMTP 서버 호스트 이름 비워 둘 수 없습니다.

  • 다음 "보낸 사람" 주소 비워 둘 수 없습니다.

을(를) 사용하여 문제를 디버깅하는 데 도움이 됩니다 일별 CQ 메일 서비스, 다음과 같은 서비스 로그를 볼 수 있습니다.

com.day.cq.mailer.DefaultMailService

웹 콘솔에서 구성은 다음과 같습니다.

일별 CQ 메일 서비스 OSGi 구성 창

이메일 알림 채널 구성 configuring-the-email-notification-channel

페이지 또는 포럼 이벤트 알림을 구독하면 보낸 사람 이메일 주소가 로 설정됩니다. no-reply@acme.com 기본값입니다. 다음을 구성하여 이 값을 변경할 수 있습니다. 알림 이메일 채널 웹 콘솔의 서비스입니다.

보낸 사람 이메일 주소를 구성하려면 sling:OsgiConfig 노드를 리포지토리에 추가합니다. 다음 절차에 따라 CRXDE Lite을 사용하여 노드를 직접 추가합니다.

  1. CRXDE Lite에서 다음 폴더를 추가합니다. config 애플리케이션 폴더 아래에 있습니다.

  2. 구성 폴더에 라는 노드를 추가합니다.

    com.day.cq.wcm.notification.email.impl.EmailChannel 유형 sling:OsgiConfig

  3. 추가 String 속성을 (으)로 지정한 노드에 email.from. 값에 사용할 이메일 주소를 지정합니다.

  4. 모두 저장 ​을 클릭합니다.

다음 절차를 사용하여 콘텐츠 패키지 소스 폴더의 노드를 정의합니다.

  1. jcr_root/apps/*app_name*/config folder, (이)라는 이름의 파일 만들기 com.day.cq.wcm.notification.email.impl.EmailChannel.xml

  2. 노드를 나타내는 다음 XML을 추가합니다.

    <?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. 값 바꾸기 email.from 속성( name@server.com)을 클릭하여 제품에서 사용할 수 있습니다.

  4. 파일을 저장합니다.

워크플로우 이메일 알림 서비스 구성 configuring-the-workflow-email-notification-service

워크플로우 이메일 알림을 받을 때 보낸 사람 이메일 주소와 호스트 URL 접두어가 모두 기본값으로 설정됩니다. 다음을 구성하여 이러한 값을 변경할 수 있습니다. 일별 CQ 워크플로우 이메일 알림 서비스 웹 콘솔에서 게시할 수 있습니다. 이 경우 저장소에서 변경 사항을 유지하는 것이 좋습니다.

기본 구성은 웹 콘솔에서 다음과 같이 표시됩니다.

일별 CQ 워크플로우 이메일 알림 서비스 구성 창

페이지 알림용 이메일 템플릿 email-templates-for-page-notification

페이지 알림용 이메일 템플릿은 아래에 있습니다.

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

기본 영어 템플릿( en.txt)는 다음과 같이 정의됩니다.

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.

페이지 알림을 위한 이메일 템플릿 맞춤화 customizing-email-templates-for-page-notification

페이지 알림용 영어 이메일 템플릿을 사용자 정의하려면 다음 작업을 수행하십시오.

  1. CRXDE에서 다음 파일을 엽니다.

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

  2. 필요에 따라 파일을 수정합니다.

  3. 변경 사항을 저장합니다.

템플릿에는 다음 형식이 필요합니다.

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

위치 <text_x> 정적 텍스트와 동적 문자열 변수의 혼합일 수 있습니다. 페이지 알림을 위한 이메일 템플릿 내에서 다음 변수를 사용할 수 있습니다.

  • ${time}, 이벤트 날짜 및 시간입니다.

  • ${userFullName}: 이벤트를 트리거한 사용자의 전체 이름입니다.

  • ${userId}: 이벤트를 트리거한 사용자의 ID입니다.

  • ${modifications}에서는 페이지 이벤트 유형 및 페이지 경로를 다음 형식으로 설명합니다.

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

    예:

    PageModified => /content/geometrixx/en/products

워크플로우 알림용 이메일 템플릿 email-templates-for-workflow-notification

워크플로우 알림용 이메일 템플릿(영어)은 다음 위치에 있습니다.

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

이는 다음과 같이 정의됩니다.

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.

워크플로우 알림을 위한 이메일 템플릿 맞춤화 customizing-email-templates-for-workflow-notification

워크플로우 이벤트 알림을 위한 영어 이메일 템플릿을 사용자 정의하려면 다음 작업을 수행하십시오.

  1. CRXDE에서 다음 파일을 엽니다.

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

  2. 필요에 따라 파일을 수정합니다.

  3. 변경 사항을 저장합니다.

템플릿에는 다음 형식이 필요합니다.

subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>
NOTE
위치 <text_x> 정적 텍스트와 동적 문자열 변수의 혼합일 수 있습니다. 의 각 행 <text_x> 항목은 백슬래시()로 끝나야 합니다. \), 마지막 인스턴스를 제외하고, 백슬래시가 없으면 <text_x> 문자열 변수입니다.
템플릿 형식에 대한 자세한 내용은 Properties.load()의 javadocs 메서드를 사용합니다.

메서드 ${payload.path.open} 은 작업 항목의 페이로드에 대한 경로를 표시합니다. 예를 들어 Sites의 페이지에 대해 다음을 수행합니다. payload.path.open 는 과 유사합니다. /bin/wcmcommand?cmd=open&path=….; 이것은 서버 이름이 없기 때문에 템플릿에서 이 앞에 를 추가합니다. ${host.prefix}.

이메일 템플릿 내에서 사용할 수 있는 변수는 다음과 같습니다.

  • ${event.EventType}, 이벤트 유형

  • ${event.TimeStamp}, 이벤트 날짜 및 시간

  • ${event.User}, 이벤트를 트리거한 사용자

  • ${initiator.home}, 이니시에이터 노드 경로

  • ${initiator.name}, 개시자 이름

  • ${initiator.email}, 개시자의 이메일 주소

  • ${item.id}, 작업 항목의 id

  • ${item.node.id}, 이 작업 항목과 연결된 워크플로 모델의 노드 id

  • ${item.node.title}, 작업 항목의 제목

  • ${participant.email}, 참가자의 이메일 주소

  • ${participant.name}, 참가자 이름

  • ${participant.familyName}, 참가자의 성

  • ${participant.id}, 참가자의 id

  • ${participant.language}, 참가자 언어

  • ${instance.id}, 워크플로우 id

  • ${instance.state}, 워크플로 상태

  • ${model.title}, 워크플로우 모델의 제목

  • ${model.id}, 워크플로 모델의 id

  • ${model.version}, 워크플로 모델의 버전

  • ${payload.data}, 페이로드

  • ${payload.type}, 페이로드 유형

  • ${payload.path}, 페이로드 경로

  • ${host.prefix}, 호스트 접두사(예: ): http://localhost:4502

새 언어에 대한 이메일 템플릿 추가 adding-an-email-template-for-a-new-language

새 언어에 대한 템플릿을 추가하려면 다음 작업을 수행하십시오.

  1. CRXDE에서 파일을 추가합니다 <language-code>.txt 아래:

    • /libs/settings/notification-templates/com.day.cq.wcm.core.page : 페이지 알림용
    • /libs/settings/workflow/notification/email/default : 워크플로우 알림용
  2. 파일을 언어에 맞게 조정합니다.

  3. 변경 사항을 저장합니다.

NOTE
다음 <language-code> 이메일 템플릿의 파일 이름으로 사용되는 두 글자로 된 소문자 언어 코드는 AEM에서 인식해야 합니다. 언어 코드의 경우 AEM은 ISO-639-1을 사용합니다.

AEM Assets 이메일 알림 구성 assetsconfig

AEM Assets의 컬렉션이 공유되거나 공유되지 않으면 사용자는 AEM에서 이메일 알림을 받을 수 있습니다. 이메일 알림을 구성하려면 다음 단계를 수행합니다.

  1. 위에서 설명한 대로 이메일 서비스를 구성합니다. 메일 서비스 구성.
  2. 관리자로 AEM에 로그인합니다. 클릭 도구 > 작업 > 웹 콘솔 웹 콘솔 구성을 엽니다.
  3. 편집 일별 CQ DAM 리소스 컬렉션 서블릿. 선택 이메일 보내기. 저장 ​을 클릭합니다.

OAuth 설정 setting-up-oauth

AEM은 조직이 보안 이메일 요구 사항을 준수할 수 있도록 통합 Mailer 서비스에 대한 OAuth2 지원을 제공합니다.

아래 설명된 대로 여러 이메일 공급자에 대한 OAuth를 구성할 수 있습니다.

NOTE
이 절차는 게시 인스턴스의 예제입니다. 작성자 인스턴스에서 이메일 알림을 활성화하려면 작성자에 대해 동일한 단계를 수행해야 합니다.

Gmail gmail

  1. 다음에서 프로젝트를 만듭니다. https://console.developers.google.com/projectcreate

  2. 프로젝트를 선택한 다음 로 이동합니다. API 및 서비스 - 대시보드 - 자격 증명

  3. 요구 사항에 따라 OAuth 동의 화면 구성

  4. 다음에 나오는 업데이트 화면에서 다음 두 범위를 추가합니다.

    • https://mail.google.com/
    • https://www.googleapis.com//auth/gmail.send
  5. 범위를 추가했으면 다음으로 돌아갑니다. 자격 증명 왼쪽 메뉴에서 자격 증명 만들기 - OAuth 클라이언트 ID - 데스크탑 앱

  6. 클라이언트 ID 및 클라이언트 암호가 포함된 새 창이 열립니다.

  7. 이러한 자격 증명을 저장합니다.

AEM 측 구성

NOTE
Adobe Managed Service 고객은 고객 서비스 엔지니어와 협력하여 프로덕션 환경을 변경할 수 있습니다.

먼저 메일 서비스를 구성합니다.

  1. 로 이동하여 AEM 웹 콘솔 열기 http://serveraddress:serverport/system/console/configMgr

  2. 를 찾은 다음 를 클릭합니다. 일별 CQ 메일 서비스

  3. 다음 설정을 추가합니다.

    • SMTP 서버 호스트 이름: smtp.gmail.com
    • SMTP 서버 포트: 25 또는 587, 요구 사항에 따라
    • 다음에 대한 확인란을 선택합니다. SMPT StarTLS 사용SMTP에 StarTLS 필요
    • 확인 OAuth 흐름 및 클릭 저장.

그런 다음 아래 절차에 따라 SMTP OAuth 공급자를 구성합니다.

  1. 로 이동하여 AEM 웹 콘솔 열기 http://serveraddress:serverport/system/console/configMgr

  2. 를 찾은 다음 를 클릭합니다. CQ Mailer SMTP OAuth2 공급자

  3. 다음과 같이 필요한 정보를 입력합니다.

    • 인증 URL: https://accounts.google.com/o/oauth2/auth
    • 토큰 URL: https://accounts.google.com/o/oauth2/token
    • 범위: https://www.googleapis.com/auth/gmail.sendhttps://mail.google.com/. 을 눌러 두 개 이상의 범위를 추가할 수 있습니다. + 구성된 각 범위의 오른쪽에 있는 단추입니다.
    • 클라이언트 ID 및 클라이언트 암호: 위 단락에서 설명한 대로 검색한 값으로 이러한 필드를 구성합니다.
    • 새로 고침 토큰 URL: https://accounts.google.com/o/oauth2/token
    • 새로 고침 토큰 만료: 절대 안 함
  4. 저장 ​을 클릭합니다.

구성이 완료되면 설정은 다음과 같이 표시됩니다.

CQ Mailer SMTP Oauth2 공급자 구성 창

이제 OAuth 구성 요소를 활성화합니다. 다음을 통해 이 작업을 수행할 수 있습니다.

  1. 다음 URL을 방문하여 구성 요소 콘솔로 이동합니다. http://serveraddress:serverport/system/console/components

  2. 다음 구성 요소를 찾습니다

    • com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
    • com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
  3. 구성 요소 왼쪽에 있는 재생 아이콘을 누릅니다

    OAuthCodeGenerateServlet 및 OAuthCodeAccessTokenGenerator를 보여 주는 구성 요소 목록

마지막으로 다음 방법으로 구성을 확인합니다.

  1. Publish 인스턴스의 주소로 이동하고 관리자로 로그인합니다.
  2. 브라우저에서 새 탭을 열고 다음으로 이동 http://serveraddress:serverport/services/mailer/oauth2/authorize. SMTP 공급자의 페이지로 리디렉션됩니다(이 경우 Gmail).
  3. 로그인 및 필요한 권한 부여에 대한 동의
  4. 동의를 하면 토큰이 저장소에 저장됩니다. 다음에서 액세스할 수 있습니다. accessToken 게시 인스턴스에서 이 URL에 직접 액세스: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth
  5. 각 게시 인스턴스에 대해 위의 내용을 반복합니다

Microsoft Outlook microsoft-outlook

  1. https://portal.azure.com/으로 이동한 다음 로그인합니다.

  2. 검색창에서 Azure Active Directory ​를 검색한 다음, 결과를 클릭합니다. 또는 https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Overview에서 바로 검색할 수 있습니다.

  3. 앱 등록 - 신규 등록 ​을 클릭합니다.

    Microsoft Outlook 구성 시 새 등록 버튼

  4. 요구 사항에 따라 정보를 입력한 다음 등록

  5. 새로 생성된 앱으로 이동하여 API 권한 ​을 선택합니다.

  6. 권한 추가 - 그래프 권한 - 위임된 권한 ​으로 이동합니다.

  7. 아래의 앱에 대한 권한을 선택한 다음 권한 추가 ​를 클릭합니다.

    • SMTP.Send
    • Mail.Read
    • Mail.Send
    • openid
    • offline_access
  8. 다음으로 이동 인증 - 플랫폼 추가 - , 및 리디렉션 Url 섹션에서 OAuth 코드를 리디렉션하기 위해 다음 URL을 추가한 다음 키를 누릅니다 구성:

    • http://localhost:4503/services/mailer/oauth2/token
  9. 각 게시 인스턴스에 대해 위의 내용을 반복합니다

  10. 요구 사항에 따라 설정 구성

  11. 다음으로 이동 인증서 및 암호, 클릭 새 클라이언트 암호 화면에 표시되는 단계에 따라 암호를 만드십시오. 나중에 사용할 수 있도록 이러한 보안 내용을 메모해 두십시오.

  12. 왼쪽 창에서 개요 ​를 누르고 나중에 사용할 수 있도록 애플리케이션(클라이언트) ID디렉터리(테넌트) ID ​의 값을 복사합니다.

재점검하려면 AEM 측의 Mailer 서비스에 대한 OAuth2 구성에 대한 다음 정보가 있어야 합니다.

  • 테넌트 ID로 구성되는 인증 URL 형식: https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/authorize
  • 테넌트 ID로 구성되는 토큰 URL 형식: https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/token
  • 테넌트 ID로 구성되는 새로 고침 URL 형식: https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/token
  • 클라이언트 ID
  • 클라이언트 보안

AEM 측 구성

다음으로 OAuth2 설정을 AEM과 통합합니다.

  1. 을 찾아 로컬 인스턴스의 웹 콘솔로 이동합니다. http://serveraddress:serverport/system/console/configMgr

  2. 을(를) 찾아 클릭 일별 CQ 메일 서비스

  3. 다음 설정을 추가합니다.

    • SMTP 서버 호스트 이름: smtp.office365.com
    • SMTP 사용자: 이메일 형식의 사용자 이름
    • "보낸 사람" 주소: 발송자가 보낸 메시지의 "보낸 사람:" 필드에 사용할 이메일 주소
    • SMTP 서버 포트: 25 또는 587 요구 사항에 따라
    • 다음에 대한 확인란을 선택합니다. SMPT StarTLS 사용SMTP에 StarTLS 필요
    • 확인 OAuth 흐름 및 클릭 저장.
  4. 를 찾은 다음 를 클릭합니다. CQ Mailer SMTP OAuth2 공급자

  5. 다음과 같이 필요한 정보를 입력합니다.

    • 에 설명된 대로 구성하여 인증 URL, 토큰 URL 및 새로 고침 토큰 URL을 입력합니다. 이 절차의 종료

    • 클라이언트 ID 및 클라이언트 암호: 위에서 설명한 대로 검색한 값으로 이러한 필드를 구성합니다.

    • 구성에 다음 범위를 추가합니다.

      • openid
      • offline_access
      • https://outlook.office365.com/Mail.Send
      • https://outlook.office365.com/Mail.Read
      • https://outlook.office365.com/SMTP.Send
    • 인증 코드 리디렉션 Url: http://localhost:4503/services/mailer/oauth2/token

    • 새로 고침 토큰 URL: 위의 토큰 URL과 동일한 값을 가져야 합니다.

  6. 저장 ​을 클릭합니다.

구성이 완료되면 설정은 다음과 같이 표시됩니다.

완료된 CQ Mailer SMTP OAuth2 구성

이제 OAuth 구성 요소를 활성화합니다. 다음을 통해 이 작업을 수행할 수 있습니다.

  1. 다음 URL을 방문하여 구성 요소 콘솔로 이동합니다. http://serveraddress:serverport/system/console/components

  2. 다음 구성 요소를 찾습니다

    • com.day.cq.mailer.oauth.servlets.handler.OAuthCodeGenerateServlet
    • com.day.cq.mailer.oauth.servlets.handler.OAuthCodeAccessTokenGenerator
  3. 구성 요소 왼쪽에 있는 재생 아이콘을 누릅니다

OAuthCodeGenerateServlet 및 OAuthCodeAccessTokenGenerator가 포함된 구성 요소 목록의 코드 조각

마지막으로 다음 방법으로 구성을 확인합니다.

  1. Publish 인스턴스의 주소로 이동하고 관리자로 로그인합니다.
  2. 브라우저에서 새 탭을 열고 다음으로 이동 http://serveraddress:serverport/services/mailer/oauth2/authorize. 이렇게 하면 SMTP 공급자의 페이지로 리디렉션됩니다(이 경우 Outlook).
  3. 로그인 및 필요한 권한 부여에 대한 동의
  4. 동의를 하면 토큰이 저장소에 저장됩니다. 다음에서 액세스할 수 있습니다. accessToken 게시 인스턴스에서 이 URL에 직접 액세스: http://serveraddress:serverport/crx/de/index.jsp#/conf/global/settings/mailer/oauth
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2