[i-PORTAL] 로그인 페이지에 비밀번호 찾기 기능이 추가되었습니다.

page no. 116888430

기능 설명
1. 로그인 화면에서 사용자가 비밀번호를 분실했을 때, 안전하게 새로운 비밀번호를 설정할 수 있는 기능을 제공합니다.
사용 방법
1. 비밀번호 찾기 활성화 방법
  1. iMgt 포탈 설정
    1. 시스템 운영 관리 > PORTAL 설정 > 더 보기 > OP_FINDPASSWORD 코드 값 설정
      1. OP_FINDPASSWORD 코드 및 값 확인
      2. 기본적으로 값은 'Y' 로 설정되어 있습니다.
        - (참고) 해당 값이 'Y'로 설정되어 있더라도, SMTP 설정도 같이 되어야 '비밀번호 찾기'가 활성화 됩니다.
    2. 시스템 관리 > 시스템 옵션 > 시스템 사용 옵션에서 MAIL 관련 설정 적용
      1. 시스템 사용 옵션에서 SMTP 설정이 필요하며, [신규] 버튼을 클릭하여 SMTP 정보를 각 항목 별로 작성합니다.
        - (참고) 본 문서에 기재된 값은 이해를 돕기 위한 예시입니다. 실제 서비스 환경에서는 고객사의 SMTP 설정 정보에 맞게 입력해야 합니다.
      2. SMTP 정보를 입력한 후 [저장] 버튼을 클릭하여 설정을 저장합니다.
    3. 위 PORTAL 설정 및 시스템 옵션이 설정이 완료되면 다음과 같이 로그인 화면에서 '비밀번호 찾기'가 나타나게 됩니다.
2. 비밀번호 찾기 과정
  1. 비밀번호 찾기 과정은 4단계로 구성되어 있습니다. 각 화면 단계에서 다음과 같이 절차를 수행하시면 됩니다.
    STEP 1) 비밀번호 찾기
    1. 1. 제품 내 등록된 사용자명을 입력합니다.
      2. 사용자명이 존재하면 다음 '인증 코드 발급' 화면으로 이동합니다.
      3. 사용자명이 존재하지 않으면 '등록된 메일이 없어 인증이 불가합니다. 관리자에게 연락해주시기 바랍니다' 메세지가 표시되며, 확인 버튼을 클릭하면 '비밀번호 찾기' 팝업이 종료됩니다.
    STEP 2) 인증 코드 발급
    1. 1. 인증 코드 발급 화면에서는 앞서 입력한 사용자명의 이메일 주소 등록되어 있는 경우에 나타나는 화면입니다. 해당 사용자명으로 등록된 이메일 주소를 확인할 수 있습니다.
      2. 인증 코드 발송 버튼을 클릭하면, '인증 코드 입력' 부분이 활성화 되어 값을 입력할 수 있게 되며 표시된 이메일 주소로 인증 코드를 발송하게 됩니다.
        그리고 인증 코드 발송 버튼이 사라지면서, '남은 시간'이 표시되면서 인증 코드의 유효 시간을 표시하게 됩니다.
      3. 메일로 전달 받은 인증 코드 값을 입력하면, 인증 코드 검증을 수행하게 됩니다.
        1) 인증 코드가 일치 하지 않는 경우 '메일에 기재된 인증 코드를 입력해주세요.' 메세지가 출력됩니다.
        2) 인증 코드가 일치 하는 경우 '비밀번호 변경' 화면으로 이동합니다.
        3) 인증 코드가 만료된 상황에서 인증 코드를 입력하는 경우 "발급된 인증 코드가 만료되었습니다. '인증 코드 재전송' 기능을 이용하여 새로 발급된 인증 코드를 입력해주세요." 메세지가 출력됩니다.
    STEP 3) 비밀번호 변경
    1. 1. 해당 계정의 새 비밀번호를 설정합니다.
      2. 새 비밀번호 입력과 확인란에 새롭게 사용할 비밀번호를 입력하고 확인을 누르면 해당 비밀번호로 새롭게 적용되며, 다음 '비밀번호 변경 완료' 화면으로 이동합니다.
    STEP 4) 비밀번호 변경 완료
    1. 1. 비밀번호가 정상적으로 변경 완료되었을 경우, '비밀번호 변경 완료' 화면이 나타나게 됩니다.
      2. '확인' 버튼을 누르면 비밀번호 찾기 과정이 종료되며, 로그인 창에 새롭게 변경한 비밀번호를 입력하여 로그인을 수행하면 됩니다.

필수 옵션

해당 기능을 사용하기 위해서는 '비밀번호 찾기' 옵션 활성화와 SMTP 설정이 되어야 하며, 추가로 사용자의 메일 정보가 등록되어 있어야 합니다.
(조건을 만족하는 경우에만 '비밀번호 찾기' 기능이 활성화되며 이용 가능합니다.)

'비밀번호 찾기' 옵션은 최신 패치 후 관리자 포탈에서 시스템 운영관리 > Repository 테이블 점검에 옵션 값 점검을 실행하여 자동으로 추가할 수 있습니다.

SMTP 설정은 아래 표를 참고하여 사용중인 SMTP 정보를 관리자 포탈에서 [시스템 옵션 > 시스템 사용 옵션]에 알맞게 입력해야 합니다.

항목
MAIL_SENDER_ADDRESS	(메일 발송인 이메일 주소)
MAIL_SENDER_USER	(메일 발송인 이름)
MAIL_SMTP_SERVER	(SMTP 서버 주소)
MAIL_SMTP_PORT	(SMTP 서버 포트)
MAIL_SMTP_USE_SSL	(SMTP SSL 사용 여부)
MAIL_SMTP_USER	(SMTP 계정 아이디)
MAIL_SMTP_PWD	(SMTP 계정 비밀번호)
PORTAL_MAIL_SERVER_SCRIPT_NAME	(Default : PORTAL_SEND_MAIL) 경로: reports > SERVER_SCRIPT > PORTAL > PORTAL_SEND_MAIL.jsx 역할: Server Script 기반 메일 발송 공통 유틸리티 사이트별 커스텀 필요시 사용

사용자 메일 관련 설정은 관리자 포탈에서 [계정 관리] > [사용자 관리] > 사용자 목록에서 메일 주소가 등록되어 있어야 합니다.
- 사용자 계정에 등록된 이메일 정보

제약 사항

이미 서비스 중인 사이트에 해당 기능을 최초로 적용할 경우, '비밀번호 찾기 활성화 방법'의 절차를 완료하면 서버 재기동 없이 포탈에서 '비밀번호 찾기' 기능이 자동으로 활성화됩니다.
SMTP 환경에 따라 인증 코드 발송에 대한 메일 수신 시간이 상이할 수 있습니다.

PORTAL_MAIL_SERVER_SCRIPT_NAME 커스텀 방법

사용 방법

Server Script 파일 확인
- 메일 발송 기능을 사용하기 위해서는 Server Script 파일이 서버에 존재해야 합니다.
- 기본 Server Script 파일 정보
  - 경로: reports > SERVER_SCRIPT > PORTAL > PORTAL_SEND_MAIL.jsx
  - 역할: Server Script 기반 메일 발송 공통 유틸리티
Server Script 등록
- 관리자 포탈의 시스템 옵션에서 메일 발송에 사용할 Server Script 파일을 지정해야 합니다.
- PORTAL_MAIL_SERVER_SCRIPT_NAME 옵션에 사용할 Script명을 등록합니다. (지정하지 않을 경우, 해당 코드 값은 기본적으로 PORTAL_SEND_MAIL을 참조하게 됩니다.)
  - 입력 예)
    
    --
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 에 파일명 (확장자 제외)으로 값을 등록합니다.
- 등록 후 메일 발송 기능을 이용하는 서비스들의 메일 발신이 정상적으로 되는지 확인합니다.
Server Script 커스텀 관련 주의사항
- SMTP 환경에 따라 추가적인 커스텀 설정이 필요한 경우, 원본 파일을 직접 수정하지 않고 사본 파일을 생성하여 수정 후 사용해야 합니다.
- 커스텀 Server Script를 사용하는 경우, 관리자 포탈의 시스템 옵션 PORTAL_MAIL_SERVER_SCRIPT_NAME에 해당 Script명을 지정해야 합니다.
- (주의) 원본 파일을 수정하여 사용할 경우, 제품 업데이트 시 수정한 내용이 덮어쓰여질 수 있으므로 반드시 사본 파일을 사용해야 합니다.
- 커스텀 Server Script를 사용하지 않는 경우, 기본 제공 Server Script의 메일 발송 로직이 적용됩니다.

참고 사항

SMTP 보안 방식 설정
- SMTP 보안 방식은 Server Script의 SMTP_PARAMS 파라미터를 통해 설정합니다.
- SMTP 서버 환경에서 TLS/SSL 방식에 따라 필요한 설정 값을 알맞게 구성해야 합니다.
- 설정 값은 아래와 같이 문자열 배열 형태로 입력합니다.
  - 예시) ["mail.smtp.auth=xxxx", "mail.smtp.ssl.enable=xxxxx"]

로그 및 실행 결과 확인 방법 (본 매뉴얼에 안내된 로그 메시지 및 동작 방식은 기본 제공 Server Script를 기준으로 작성되었습니다.)

AUD Designer 실행 결과 확인

AUD Designer의 Script Editor에서 요청 실행 결과를 확인할 수 있습니다.

확인 항목	표시 메세지
SMTP 정보가 없는 경우	"success": false, "error": "No SMTP settings. (SMTP_SERVER needs to be checked)"
발신자 계정 정보가 없는 경우	"success": false, "error": "No sender account. (MAIL_SENDER_USER / MAIL_SENDER_ADDRESS needs to be checked)"
수신자 메일 정보가 없는 경우	"success": false, "error": "No 'to' address. (TO_ADDRESS needs to be checked)"
메일이 정상 발송된 경우	"success": true, "result": true

--

AUD 로그 정보 확인

AUD 로그에서 메일 발송 관련 Server Script 실행 상태를 확인할 수 있습니다.

구분	표시 로그
요청 수신 시	### [PORTAL_SEND_MAIL] Mail Server Script START ~
처리 성공 시	### [PORTAL_SEND_MAIL] Mail Server Script SUCCESS ~
처리 실패 시	### [PORTAL_SEND_MAIL] Mail Server Script FAIL ~
오류 발생 시	### [PORTAL_SEND_MAIL] Mail Server Script ERROR ~

--

주의사항

커스텀 적용이 필요한 경우에는 원본 파일을 직접 수정하지 않고, 파일을 복사하여 별도의 파일을 생성한 후 SMTP 설정을 추가로 반영해야 합니다.
- 이후 해당 파일을 관리자 포탈의 시스템 옵션에 지정하여 사용하시기 바랍니다.
- 원본 파일을 직접 수정할 경우, 제품 업데이트 시 커스텀 내용이 최신 버전으로 덮어쓰여 복구가 불가능하므로 반드시 사본 파일을 사용해야 합니다.
시스템 옵션에 MAIL 관련 Server Script 파일이 별도로 지정되지 않은 경우, 기본 Server Script(PORTAL_SEND_MAIL)가 사용됩니다.
- 이 경우, 시스템 옵션에 설정된 SMTP 정보를 기준으로 메일이 발송됩니다.

주의 사항

변경 사항

Release 버전	변경 전	변경 후
7.0.500.20260108-11	비밀번호 초기화 기능 없음	비밀번호 초기화 기능 추가
7.0.500.20260430-21	API 기반 메일 발송 방식 적용 사이트별 SMTP 커스텀 설정 일부 제한 JAR 파일 수정 필요 TOMCAT 재기동 필요	SERVER SCRIPT 기반 메일 발송 방식 적용 사이트 별 SMTP 커스텀 설정 가능 JAR 파일 수정 없이 설정 가능 TOMCAT 재기동 불필요

연관된 페이지 : [i-PORTAL] 비밀번호 초기화 기능에 보안이 강화되었습니다.
연관된 페이지 : Server Script 기반 메일 발송 기능 적용
연관된 페이지 : 비밀번호 찾기 화면 스타일(CSS) 적용 안내

기능 정보	API Open	UI Open	Read Only	Not Use	Hidden	Not Recommend	해당 없음
시작 버전 정보	Release No. : 7.0.500.20260226-11, Admin : 7.0.500.20260226, i-PORTAL Client : 7.0.500.20260211, i-PORTAL Server : 7.0.500.20260114

공간 바로가기

페이지 트리