페이지 이력

page no. 

1. 기능 설명
   1. 다양한 SMTP 서버의 정보를 수용하기 환경을 유연하게 지원하기 위해 Server Script로 Script 기반의 메일 발송 기능을 추가하였습니다제공합니다.
      
      • PORTAL에서는 비밀번호 찾기와 같은 기능에서
      발급된
      • 인증
      코드를 전송하기
      • 코드 발송을 위해 SMTP 정보를
      이용합니다
      • 사용합니다.
       
      SMTP 정보는 각 사이트마다 이용하는 SMTP 서비스가 다르고 이에 따른 설정 정보가 다양한 관계로, 이를 수용할 수 있도록 Server Script로 메일 발송 기능을 지원하여 환경에 맞는 SMTP  설정을 지원합니다. 
      • 사이트별로 사용하는 SMTP 서비스 및 설정 방식이 상이함에 따라, 이를 유연하게 처리할 수 있도록 Server Script를 통해 SMTP 설정을 구성할 수 있습니다.
2. 사용 방법
   1. Server Script 파일 정보 reports > SERVER_SCRIPT 경로에서 PORTAL 폴더 하위에 PORTAL_SEND_MAIL.jsx 파일이 존재하는지 확인합니다. 확인
      • 메일 발송 기능을 사용하기 위해서는 Server Script 파일이 서버에 존재해야 합니다.
      • 기본 Server Script 파일 정보
        • 경로: reports > SERVER_SCRIPT > PORTAL > PORTAL_SEND_MAIL.
      jsx
      • • jsx 
        • 역할:
      서버 스크립트
      • • Server Script 기반 메일 발송
      범용 유틸 
   2. 호출 주체 
      1. 서버 스크립트 실행이 가능한 호출부 에서 공통으로 사용할 수 있습니다. 
         1. matrix-service : 비밀번호 인증 코드 발송 로직 
         2. AUD 보고서 : 클라이언트 JS에서 viewer.RunScriptEx( )로 호출부
         3. 기타 : 서버 스크립트 실행 API 가능한 모든 호출부 
   3. 요청 파라미터 
      변수 정보 
      1. TO_ADDRESS / 수신자 메일 주소 
      2. TITLE / 메일 제목 
      3. CONTENT / 메일 본문 
      옵션 키예시TO_ADDRESS 
      수신자 메일 주소 
TITLE 
      메일 제목CONTENT 
      메일 본문
설정 

      서버 옵션

      옵션 키설명예시MAIL_SMTP_SERVERSMTP 서버 주소smtp.gmail.comMAIL_SMTP_PORTSMTP 포트465 / 587MAIL_SMTP_USERSMTP 계정account@gmail.comMAIL_SMTP_PWDSMTP 계정 비밀번호(앱 비밀번호 등)MAIL_SENDER_USER발신인 이름시스템관리자MAIL_SENDER_ADDRESS발신인 주소sender@example.com

      서버 스크립트 내 SMTP 보안 방식을 파라미터로 설정 

      옵션 키설명예시평문25nullSSL465
      • • 공통 유틸리티
   4. Server Script 등록
      • 관리자 포탈의 시스템 옵션에서 메일 발송에 사용할 Server Script 파일을 지정해야 합니다.
      • PORTAL_MAIL_SERVER_SCRIPT_NAME 옵션에 사용할 Script명을 등록합니다. (지정하지 않을 경우, 해당 코드 값은 기본적으로 PORTAL_SEND_MAIL을 참조하게 됩니다.)
        • 입력 예) 
          Image Added
          --
   5. Server Script  커스텀 절차 
      • 해당 파일이 존재하는 경로로 이동하여 PORTAL_SEND_MAIL.jsx 파일을 사본으로 생성합니다.
      • 생성한 파일에서 SMTP 설정 등 필요한 항목을 수정한 후 저장합니다.
        
        • req.getParam("TO_ADDRESS"), req.getParam("TITLE"), req.getParam("CONTENT") 값은 비밀번호 찾기 기능에서 사용되므로 변경할 수 없습니다.
        • 메일 전송 설정 시 사용하는 useSSL, baseEncoding 등의 파라미터는 변경할 수 없습니다.
      • 저장한 파일명을 기준으로 시스템 옵션에 등록합니다.
        •  [2.b 입력 예] 그림과 같이 PORTAL_MAIL_SERVER_SCRIPT_NAME 에 파일명 (확장자 제외)으로 값을 등록합니다. 
      • 등록 후 메일 발송 기능을 이용하는 서비스들의 메일 발신이 정상적으로 되는지 확인합니다. 
   6. Server Script 커스텀 관련 주의사항
      • SMTP 환경에 따라 추가적인 커스텀 설정이 필요한 경우, 원본 파일을 직접 수정하지 않고 사본 파일을 생성하여 수정 후 사용해야 합니다.
      • 커스텀 Server Script를 사용하는 경우, 관리자 포탈의 시스템 옵션 PORTAL_MAIL_SERVER_SCRIPT_NAME에 해당 Script명을 지정해야 합니다.
      • (주의) 원본 파일을 수정하여 사용할 경우, 제품 업데이트 시 수정한 내용이 덮어쓰여질 수 있으므로 반드시 사본 파일을 사용해야 합니다.
      • 커스텀 Server Script를 사용하지 않는 경우, 기본 제공 Server Script의 메일 발송 로직이 적용됩니다.