페이지 이력

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. 요청 파라미터 
      

      변수 정보 

      옵션 키예시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["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](중요) 비밀번호 찾기 과정에서
      • • 공통 유틸리티
   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
      가 추가되어야 메일 발송 기능이 동작합니다. 
      1. @PORTAL_SEND_MAIL이 입력되어야 인증 코드 관련 메일이 발송됩니다. 
      (중요) @PORTAL_SEND_MAIL를 커스텀 할 경우, 원본 파일에 대한 사본 파일을 만들어서 SMTP 서버 정보를 커스텀 합니다. 그리고 관리자 > 시스템 옵션 > PORTAL
      • • 에 파일명 (확장자 제외)으로 값을 등록합니다. 
      • 등록 후 메일 발송 기능을 이용하는 서비스들의 메일 발신이 정상적으로 되는지 확인합니다. 
   6. Server Script 커스텀 관련 주의사항
      • SMTP 환경에 따라 추가적인 커스텀 설정이 필요한 경우, 원본 파일을 직접 수정하지 않고 사본 파일을 생성하여 수정 후 사용해야 합니다.
      • 커스텀 Server Script를 사용하는 경우, 관리자 포탈의 시스템 옵션 PORTAL_MAIL_SERVER_SCRIPT_
      NAME  값을 사본 파일명으로 지정합니다. (예 - @PORTAL_SEND_MAIL_COPY)
   7. 제품이 업데이트 되는 경우, 원본 파일이 업데이트 되므로 위 사본 파일에는 영향이 없으므로 운영 시에 사본 파일을 만들어서 커스텀 후 사용하시기 바랍니다. 
   8. 커스텀 하지 않는 경우에는, 원본 파일은 관리자에 등록된 SMTP 정보를 토대로 연결되도록 되어 있습니다. 
   테스트 방법 
   9. 비밀번호 찾기 
      1. 인증 코드 발송 가능 여부 확인 
   AUD 보고서 

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

   위키 문법
   viewer.RunScriptEx("", "@PORTAL@PORTAL_SEND_MAIL", { TO_ADDRESS: "target@example.com", TITLE: "테스트 메일", CONTENT: "안녕하세요, 테스트입니다." }, function(result) { if (result.success) { console.log("발송 성공"); } else { console.error("발송 실패:", result.error); } });

1. 1. • NAME에 해당 Script명을 지정해야 합니다.
      • (주의) 원본 파일을 수정하여 사용할 경우, 제품 업데이트 시 수정한 내용이 덮어쓰여질 수 있으므로 반드시 사본 파일을 사용해야 합니다.
      • 커스텀 Server Script를 사용하지 않는 경우, 기본 제공 Server Script의 메일 발송 로직이 적용됩니다.