설명서Experience Cloud KCS

AEM as a Cloud Service SMTP 이메일이 작동하지 않거나 구성할 수 없음

마지막 업데이트: 2026년 7월 6일

AEM as a Cloud Service은 SMTP 서버를 포함하지 않으며 내부 또는 AMS SMTP 호스트에 연결할 수 없으므로 고객이 기본 제공 서버를 기대하거나 회사 또는 레거시 릴레이를 사용하려고 하면 이메일이 실패합니다. 모든 아웃바운드 이메일은 고급 네트워킹을 통해 라우팅되는 고객 제공 공개, 인증된 SMTP 공급자를 거쳐야 하며 샌드박스 환경에서는 고급 네트워킹을 지원하지 않으므로 SMTP가 작동하지 않습니다. 외부 SMTP 공급자를 선택하고 고급 네트워킹 포트 전달을 구성하며 메일 서비스 OSGi 구성을 추가하면 스테이지 및 프로덕션 환경에서 전자 메일 배달이 가능합니다.

설명 description

환경:

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Assets 기본 사항
  • Cloud Manager(고급 네트워킹)
  • 스테이지 및 프로덕션 환경(샌드박스 및 RDE는 고급 네트워킹을 지원하지 않음)

문제/증상:

  • 이메일은 localhost에서 작동하지만 AEM Cloud에서 실패하고, 코드를 작성자 또는 게시에 배포할 때 500개의 오류가 발생합니다.
  • 고객이 Adobe에서 SMTP 서버를 제공해야 하므로 SMTP 구성을 완료할 수 없습니다.
  • 샌드박스 환경에서는 고급 네트워킹이 지원되지 않으므로 이메일을 보낼 수 없습니다.
  • AEMaaCS에는 인증된 공개 SMTP 끝점이 필요하므로 내부 전용 SMTP 서버 사용 시도가 실패합니다.

근본 원인:

AEM as a Cloud Service은 SMTP 서버를 제공하지 않으며 내부 SMTP 호스트에 연결할 수 없습니다. 모든 아웃바운드 이메일은 고급 네트워킹을 통해 라우팅된 고객 제공 공용 외부 SMTP 공급자를 사용해야 합니다. 샌드박스 환경에서는 고급 네트워킹을 지원하지 않으므로 SMTP를 사용할 수 없습니다. AMS가 제공한 no-SLA SMTP 서버는 AEMaaCS Kubernetes 환경에서 연결할 수 없기 때문에 사용 시도가 실패합니다.

확인하는 방법

  1. 환경이 SMTP를 지원하는지 여부를 확인합니다. 환경이 샌드박스, RDE, 스테이지 또는 프로덕션인지 식별합니다. SMTP는 샌드박스 또는 RDE에서 지원되지 않으므로 스테이징 또는 프로덕션 수준 환경에서 테스트해야 합니다.
  2. 의도한 SMTP 끝점이 외부 및 공개인지 확인하십시오. AEMaaCS는 내부 또는 AMS SMTP 호스트에 연결할 수 없으므로 내부 전용 서버는 구성에 관계없이 작동하지 않습니다.

해결 방법 resolution

다음 단계에 따라 문제를 해결하십시오.

  1. 외부 SMTP 공급자를 선택하고 준비합니다. 인증된 공용 SMTP 공급자를 선택하고 해당 호스트, 포트, 사용자 이름 및 암호를 얻습니다. 이러한 자격 증명은 이메일 공급자에서 가져옵니다. Adobe은 SMTP 자격 증명을 제공하지 않습니다.

  2. Cloud Manager에서 고급 네트워킹을 구성합니다. SMTP 공급자에 따라 portOrig이(가) 30000-30999 범위로 설정되고 portDest이(가) 465 또는 587(으)로 설정된 portForwards을(를) 만듭니다. Cloud Manager 파이프라인 JSON에 portForwards 블록이 포함되어 있는지 확인합니다.

  3. 메일 서비스 OSGi 구성을 저장소에 추가합니다. 다음 값으로 ui.config/src/jcr_root/apps/<project>/osgiconfig/config/com.day.cq.mailer.DefaultMailService.cfg.json을(를) 만듭니다.

    • smtp.host = $[ 환경:AEM_PROXY_HOST;default=proxy.tunnel]
    • smtp.port = 이전 단계의 portOrig 값(예: 30465 또는 30587)
    • 포트 465를 사용할 때는 smtp.ssl = true, 포트 587을 사용할 때는 false

  4. Cloud Manager을 통해 재배포합니다. 전체 배포 파이프라인을 실행한 다음 /system/console/configMgr(읽기 전용이지만 AEMaaCS에 표시됨)을 열고 com.day.cq.mailer.DefaultMailService이(가) 구성된 값을 반영하는지 확인합니다.

  5. SMTP 연결을 확인합니다. AEM 워크플로우 이메일을 트리거하거나 사용자 정의 서블릿을 통해 이메일을 보낸 다음, SMTP 공급자 로그에서 인증된 연결을 확인합니다. 전달이 차단되면 공급자가 DKIM/DMARC으로 인해 이를 거부하는지 확인합니다. AEM이 아닌 SMTP 공급자 수준에서 처리됩니다.

유효성 검사

  1. AEM에서 보낸 전자 메일이 SMTP 공급자의 대시보드 로그에 표시되는지 확인합니다.
  2. OSGi 콘솔에서 일 CQ 메일 서비스에 smtp.host = proxy.tunnel 및 30000-30999 범위의 smtp.port이(가) 표시되는지 확인합니다.
  3. AEM error.log에 SMTP 연결 오류가 표시되지 않는지 확인하십시오.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles