Server Script 기반 메일 발송 기능 적용

page no.  134742024

1. 기능 설명
   1. 다양한 SMTP 환경을 유연하게 지원하기 위해 Server Script 기반의 메일 발송 기능을 제공합니다.
      
      1. PORTAL에서는 비밀번호 찾기와 같은 기능에서 인증 코드 발송을 위해 SMTP 정보를 사용합니다.
      2. 사이트별로 사용하는 SMTP 서비스 및 설정 방식이 상이함에 따라, 이를 유연하게 처리할 수 있도록 Server Script를 통해 SMTP 설정을 구성할 수 있습니다.
2. 사용 방법
   1. Server Script 파일 확인
      • 메일 발송 기능을 사용하기 위해서는 Server Script 파일이 서버에 존재해야 합니다.
      • 기본 Server Script 파일 정보
        • 경로: reports > SERVER_SCRIPT > PORTAL > PORTAL_SEND_MAIL.jsx
        • 역할: Server Script 기반 메일 발송 공통 유틸리티
   2. Server Script 등록
      • 관리자 포탈의 시스템 옵션에서 메일 발송에 사용할 Server Script 파일을 지정해야 합니다.
      • PORTAL_MAIL_SERVER_SCRIPT_NAME 옵션에 사용할 Script명을 등록합니다.
        • 예: @PORTAL_SEND_MAIL
3. 
   
   1. 메일 발송 기능을 사용하기 위해서는 해당 파일 또는 지정된 Server Script 파일을 등록해야 합니다.
      
      1. 기본 SERVER SCRIPT 파일 정보 
         1. 경로 : reports > SERVER_SCRIPT > PORTAL > PORTAL_SEND_MAIL.jsx
         2. 역할 : Server Script 기반 메일 발송 공통 유틸
   2. 호출 주체 
      1. 서버 스크립트 실행이 가능한 호출부 에서 공통으로 사용할 수 있습니다. 
         1. matrix-service : 비밀번호 인증 코드 발송 로직 
         2. AUD 보고서 : 클라이언트 JS에서 viewer.RunScriptEx( )로 호출부
         3. 기타 : 서버 스크립트 실행 API 가능한 모든 호출부 
   3. 요청 파라미터 
      

      1. 변수 정보 

         옵션 키	예시
         TO_ADDRESS	수신자 메일 주소
         TITLE	메일 제목
         CONTENT	메일 본문

   4. 설정 

      1. 서버 옵션

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

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

         옵션 키	설명	예시
         평문	25	null
         SSL	465	["mail.smtp.auth=true", "mail.smtp.ssl.enable=true", "mail.smtp.starttls.enable=false"]]
         TLS (STARTTLS)	587	["mail.smtp.auth=true", "mail.smtp.starttls.enable=true", "mail.smtp.starttls.required=true]

   5. (중요) 비밀번호 찾기 과정에서 PORTAL_MAIL_SERVER_SCRIPT_NAME 가 추가되어야 메일 발송 기능이 동작합니다. 
      1. @PORTAL_SEND_MAIL이 입력되어야 인증 코드 관련 메일이 발송됩니다. 
   6. (중요) @PORTAL_SEND_MAIL를 커스텀 할 경우, 원본 파일에 대한 사본 파일을 만들어서 SMTP 서버 정보를 커스텀 합니다. 
      1. 그리고 관리자 > 시스템 옵션 > PORTAL_MAIL_SERVER_SCRIPT_NAME  값을 사본 파일명으로 지정합니다. (예 - @PORTAL_SEND_MAIL_COPY)
      2. 제품이 업데이트 되는 경우, 원본 파일이 업데이트 되므로 위 사본 파일에는 영향이 없으므로 운영 시에 사본 파일을 만들어서 커스텀 후 사용하시기 바랍니다. 
      3. 커스텀 하지 않는 경우에는, 원본 파일은 관리자에 등록된 SMTP 정보를 토대로 연결되도록 되어 있습니다. 
   7. 테스트 방법 
      1. 비밀번호 찾기 
         1. 인증 코드 발송 가능 여부 확인 
      2. AUD 보고서 

         1. JScript 내 Server Script 호출로 메일 발송 가능 여부 확인 

            viewer.RunScriptEx("", " (PORTAL)PORTAL_SEND_MAIL", {
            TO_ADDRESS: "target@example.com",
            TITLE: "테스트 메일",
            CONTENT: "안녕하세요, 테스트입니다."
            }, function(result) {
            if (result.success)

            Unknown macro: { console.log("발송 성공"); }

            else

            Unknown macro: { console.error("발송 실패}

            });