Nmail PHP 3.2 -> 3.3.0 업데이트

보안 패치 및 기능 추가

 

# 주의) 유지보수 고객용 안내

유지보수 고객사에는 서버별 특이사항 등을 고려하여 안내 메일을 드렸습니다.

아래 내용은 직접 업데이트를 희망하는 경우의 가이드이며, 유지보수 고객은 반드시 메일로 안내드린 맞춤형 안내를 확인 부탁드립니다.

 

 

- 목  차 -

 

1.     주요 개선 사항

①     보안 패치 및 보안 개선

②     관리자용 - 메일서버관리 / 관리자메뉴

③     사용자용

2.     직접 업데이트 주의사항

①     유지보수계약중인 경우

②     사용중인 버젼 확인

③     수정된 소스 안내

④     업데이트전 데모 확인

⑤     Oracle 버전 및 유지보수계약중인 경우

3.     직접 업데이트 방법

①     Linux/Windows 공통사항

②     Linux 사용자

③     Windows 사용자

 

 

1. 주요 개선 사항

①  보안 패치 및 보안 개선

- 한국인터넷진흥원에서 보고된 파일 원격 다운로드 취약점 해결. (위험도 높음)

- '통합 보안 모듈'을 포함하여 XSS, SQL Injection, 다운로드 취약점 등에 대응

 

②  관리자용 - 메일서버관리 / 관리자메뉴

- [서버설정]

- ‘비밀번호 안전 레벨’ 에서 ‘매우 높음’ 추가 및 비밀번호 최소 길이 지정 가능

- ‘비밀번호 변경알림, 메일 발송수 제한 설정 변경’ 지원

- 스팸 차단 레벨 제거후, ‘스팸 차단 RBL’ 추가

(신뢰도가 높은 스팸하우스 RBL 등만 별도 등록하여, 바로 차단 가능)

- ‘보낸주소 위조메일’기능 복구
- 화면 하단 ‘Powered by Nmail’ 문구 삭제 및 변경 지원

- [회원관리] 에서 ‘부가 기능 - 회원 엑셀 내보내기’ 지원

- [메일계정 관리 로그, 웹메일 로그인 로그, 메일 로그, 메일 발송 상태에서 ‘엑셀 다운’ 지원

 

③  사용자용

- [메일] 안읽음, 전체메일 좌측 메뉴 추가
- [메일] 편지쓰기, 멀티 업로드 개선 (개별 삭제, 전환 버튼 표시 등)
- [메일] 편지쓰기, 웹에디터 개선 (이미지 붙여넣기시 업로드 등)
- [메일] 편지읽기, 첨부파일 이미지/PDF 미리보기 링크 지원
- [모바일웹(옵션)] 편지쓰기시 웹에디터, 수신확인, 대용량 첨부

 

2.   직접 업데이트 주의사항

 

①  유지보수계약중인 경우

저희와 별도 유지보수계약을 맺고 계신 업체에서는 업데이트를 메일

( nmail@passkorea.net )로 요청하시면, 처리후 결과를 회신드리고 있습니다.

-          작업가능 시간대 : 월~금 09-18시

-          업데이트후 모니터링 및 정기점검을 통해 장애여부를 점검해드립니다.

 

②  사용중인 버젼 확인

웹메일에서 서버관리자(postmaster)로 로그인하여,

[메일서버관리 - Nmail 정보]에서 Nmail PHP 3.2 인지 확인합니다.

업데이트 가능 버전) 3.2

업데이트 불가 버전) 3.0.0 / 3.0 / 3.1

만약 3.1 버전 사용시 3.1 to 3.2 업데이트를 먼저 적용해야 합니다.

주의) Nmail PHP 2 제품에서는 업데이트가 아닌 별도 유상 업그레이드 필요.

 

③  수정된 소스 안내

업데이트는 기존 소스를 덮어씌우는 형태로 진행됩니다. 

따라서 수정된 소스나 디자인이 있다면 반드시 미리 백업 받아두시기 바랍니다.

주의) 수정된 프로그램 소스나 디자인 스킨이 있고, 메일 서비스 중요도가 높은 경우

반드시 개발 서버를 구축하여 사전 테스트 진행을 권장 드립니다.

 

 

④  업데이트전 데모 확인

업데이트전 데모 사이트에서 최신 버전 화면 및 기능을 반드시 확인 부탁 드립니다.

 

 

⑤  Oracle 버전 및 유지보수계약중인 경우

Oracle 버전 등의 별도 계약을 통해 구입하거나 유지보수중인 경우 이 패치를 적용하시면 안됩니다.

유지보수계약중인 업체명과 엔메일 버젼을 메일 ( nmail@passkorea.net )로 알려주시면 별도 안내를 해드리도록 하겠습니다.

 

 

3.   직접 업데이트 방법

 

①  Linux/Windows 공통사항

1. 업데이트전 [메일서버관리]에서 Nmail 버전, PHP 버전을 기록해두시기 바랍니다.

  (업데이트 문제시 문의를 위해서는 화면 캡쳐 권장)

2. 엔메일 소스(nmail/, tools/) 디렉토리를 백업해두시기 바랍니다.

 

②  Linux 사용자

1. 패치파일을 다운로드 받아 덮어씌우고, update_db.php 를 실행합니다.         

# 파일 다운로드 cd /home/nmail2 wget http://www.passkorea.net/nmailphp/nmail-php-patch-3.2-to-3.3.0.tgz   # 다운로드한 파일 확인 ls -l nmail-php-patch-3.2-to-3.3.0.tgz # 실행 결과) -rw-r--r-- 1 root root 8429826  9월 12 15:25 nmail-php-patch-3.2-to-3.3.0.tgz   # 압축 풀어 덮어쓰기 tar zxvfp nmail-php-patch-3.2-to-3.3.0.tgz   # PHP 5.3 ~ PHP 5.5 버전일 경우 실행 #  업데이트에 포함된 mail_lib.php 등의 ionCube 인코딩 파일는 PHP 5.6 ~ 7.0 버전용입니다. #  따라서 PHP 5.5 이하 버전일 경우에만 아래 명령으로 파일을 덮어써주면 됩니다. (PHP 5.6 이상은 불필요) cd /home/nmail2/nmail/include/ /bin/cp -av mail_lib.53.php mail_lib.php /bin/cp -av security_lib.53.php security_lib.php /bin/cp -av admin_lib.53.php admin_lib.php /bin/cp -av mail_send_lib.53.php mail_send_lib.php /bin/cp -av mail_spam_lib.53.php mail_spam_lib.php /bin/cp -av webhard_lib.53.php webhard_lib.php   # 업데이트 프로그램 실행 (중요!) cd tools/ php update_db.php       # 실행시 m_last_pwdchgdate 컬럼이 이미 추가되어 에러 발생시, php update_db.php 를 한번 더 실행해주시면 됩니다.   #   에러) ALTER TABLE nmail_member ADD m_last_pwdchgdate DATETIME NULL   #         [nativecode=1060 ** Duplicate column name 'm_last_pwdchgdate']

 

 

2. 메일엔진(XMail)은 다음 문서를 확인하여, 업데이트하시면 됩니다. 

 

cat /home/nmail2/tools/mailserver/xmail-1.27_20231213_update.txt

 

* 서버에서 txt 파일 한글이 깨져 보일 경우, PC로 내려받아 Notepad++ 등의 문서 편집기로 열어보시면 됩니다.

* CentOS 7 이상 xmail 서비스 정지후 자동 시작되는 경우 systemctl 사용 방법 - https://www.passkorea.net/nmail-php-faq/49808

 

3. 웹메일의 [메일서버관리 - Nmail 정보]에서 업그레이드된 버젼을 확인하면 모든 작업이완료됩니다.

 

 

③  Windows 사용자

1. [Windows 탐색기]를 실행해서 엔메일이 설치된 폴더( C:\NmailPHP )로 이동합니다.

             주의) 설치 폴더는 서버마다 D:, E: 등 드라이브가 다를 수 있음.

 

2. 아래 파일을 다운로드 한 후 '알집'등의 압축프로그램을 통해 '현재 폴더에 압축풀기'를 합니다.  기존 소스들을 덮어씌우는 작업이므로, 덮어 씌울지 묻는 창에서 '예'를 누릅니다.

 

https://www.passkorea.net/nmailphp/nmail-php-patch-3.2-to-3.3.0.zip

 

# 참고) 서버에서 https 인증서 오류시 http 다운로드 주소

http://www.passkorea.net/nmailphp/nmail-php-patch-3.2-to-3.3.0.zip

 

3. [시작 - 실행]에서 “cmd” 명령을 입력후, 엔메일 디렉토리 아래의 tools 폴더로 이동하여 업데이트 프로그램을 실행합니다. (중요!)

cd C:\NmailPHP   # PHP 5.3 ~ PHP 5.5 버전일 경우 실행 #  업데이트에 포함된 mail_lib.php 등의 ionCube 인코딩 파일는 PHP 5.6 ~ 7.0 버전용입니다. #  따라서 PHP 5.5 이하 버전일 경우에만 아래 명령으로 파일을 덮어써주면 됩니다. (PHP 5.6 이상은 불필요) cd nmail\include copy /y mail_lib.53.php mail_lib.php copy /y security_lib.53.php security_lib.php copy /y admin_lib.53.php admin_lib.php copy /y mail_send_lib.53.php mail_send_lib.php copy /y mail_spam_lib.53.php mail_spam_lib.php copy /y webhard_lib.53.php webhard_lib.php   # 업데이트 프로그램 실행전 cmd 콘솔 한글 깨짐 확인 cd tools chcp 65001 php mbr_add.php   ## 참고) 한글이 깨질 경우, cmd 속성에서 한글 폰트 변경 등이 필요 할 수 있습니다.   # 업데이트 프로그램 실행 (중요!) php update_db.php

 

4. 메일엔진(XMail)은 다음 문서를 확인하여, 업데이트하시면 됩니다.

 

tools\mailserver\xmail-1.27_20231213_update_windows.txt

 

5. 웹메일의 [메일서버관리 - Nmail 정보]에서 업그레이드된 버젼을 확인하면 모든 작업이 완료됩니다.

 

---

 

업데이트후 장애 대응 자료

 

업데이트후 ionCube Encoder PHP 버전 에러 - https://www.passkorea.net/nmail-php-faq/49773?board_category_id=16

 

업데이트후 화면 깨짐이나 기능 오류 대응 - https://www.passkorea.net/nmail-php-faq/49774?board_category_id=16