설명서Experience Cloud KCS

AEM as a Cloud Service: 사용자 지정 OSGi 서비스를 사용할 때 SendGrid API 이메일 게재 문제

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

이 문서에서는 Adobe Experience Manager as a Cloud Service의 사용자 지정 OSGi 서비스에서 SendGrid API를 통해 이메일을 보내는 것과 관련된 문제를 해결하는 단계를 제공합니다.

설명 description

환경

Adobe Experience Manager(AEM) as a Cloud Service(모든 버전)
문제/증상

SendGrid REST API(https://api.sendgrid.com/v3/mail/send)와 통합된 사용자 지정 OSGi 서비스를 사용하여 전자 메일을 보내려고 하면 메시지가 배달되지 않습니다. 이 문제는 Cloud Manager을 통해 코드를 배포하고 SendGrid 이메일 서비스를 호출하는 워크플로우 프로세스를 실행한 후 발생합니다.

  • @ObjectClassDefinition을(를) 사용하여 만든 사용자 지정 OSGi 구성 인터페이스입니다.
  • /apps/csuf-cloud/osgiconfig/config에 구성 파일이 추가되었습니다(예: com.csuf.cloud.core.config.SendGridConfiguration.cfg.json).
  • Cloud Manager 암호(SENDGRID_API_KEY)를 사용하여 구성된 API 키입니다.
  • from_email이(가) 올바른 보낸 사람 주소로 설정되었습니다.
  • 사용자 지정 워크플로우 프로세스는 SendGrid 이메일 서비스를 트리거합니다.
  • 명시적인 오류 메시지가 제공되지 않지만 이메일은 예상대로 전달되지 않습니다.

해결 방법 resolution

  1. SendGrid API 키 사용 확인

    • OSGi 구성의 API 키 값이 SendGrid API 키가 포함된 Cloud Manager 암호로 설정되었는지 확인합니다.

    • SendGrid API로 인증하는 경우 SendGrid에서 만든 실제 API 키 값에 관계없이 항상 리터럴 문자열 apikey을(를) 사용자 이름으로 사용합니다.

    • 예제 구성:

      code language-none 
      "smtp.user": "apikey",
"api_key": "<Cloud Manager secret reference>"

  2. OSGi 구성 배포 확인

    • OSGi 구성 파일이 /apps/<project>/osgiconfig/config에 올바르게 배포되고 AEM에서 선택되었는지 확인합니다.
    • 구성 값(API 키, 보낸 사람 이메일)이 올바르고 비어 있지 않은지 확인합니다.

  3. Cloud Manager 암호 참조 유효성 검사

    • Cloud Manager 암호(SENDGRID_API_KEY)가 구성에서 제대로 참조되고 런타임에 사용할 수 있는지 확인하십시오.

  4. 전자 메일 배달 테스트

    • AEM 작성자 환경에서 워크플로우 프로세스를 트리거하고 성공적인 이메일 게재를 모니터링합니다.
    • AEM 및 SendGrid 로그에서 오류 또는 거부된 요청을 확인합니다.

원인

SendGrid API를 사용하려면 실제 API 키 값에 관계없이 인증을 위해 사용자 이름을 apikey(으)로 설정해야 합니다. 사용자 이름 또는 API 키를 잘못 구성하면 성공적인 이메일 전달을 방지할 수 있습니다.

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