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

page no.  134250499

1. 기능 설명
   1. 다양한 SMTP 서버의 정보를 수용하기 위해 Server Script로 메일 발송 기능을 추가하였습니다.
      1. PORTAL에서는 비밀번호 찾기와 같은 기능에서 발급된 인증 코드를 전송하기 위해 SMTP 정보를 이용합니다. 
      2. SMTP 정보는 각 사이트마다 이용하는 SMTP 서비스가 다르고 이에 따른 설정 정보가 다양한 관계로, 이를 수용할 수 있도록 Server Script로 메일 발송 기능을 지원하여 환경에 맞는 SMTP  설정을 지원합니다. 
2. 사용 방법
   1. 파일 정보 
      1. reports > SERVER_SCRIPT 경로에서 PORTAL 폴더 하위에 PORTAL_SEND_MAIL.jsx 파일이 존재하는지 확인합니다. 
         1. 경로 : reports > SERVER_SCRIPT > PORTAL > PORTAL_SEND_MAIL.jsx
         2. 역할 : 서버 스크립트 기반 메일 발송 범용 유틸 
   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("발송 실패}

            });

   12.