zWMS II 메일서버 관리자용 문서

zWMS II 메일서버 관리자용 문서

	개발사 :	Zone Soft (지원소프트)
	OS :	Windows 2000/2003, Linux
	버전 :	Version 2.x.x

본 문서는 zWMS 관리에 필요한 설명을 담고 있습니다.

--- 개요 ---

1. 개요
2. 프로그램 구성
3. 세션사용
4. 저장 용량
5. 환경변수 설정

--- 웹메일기능 ---
6. 웹메일스킨
7. 발신/수신 확인 기능
8. 폼메일 기능
9. 알림메일 기능
10. 메일링리스트 사용하기
11. 대표메일 구성하기
12. 멀티도메인 기능
13. 메일스킨 (편지작성시 스킨 이용하기)
14. 게시판 관리
15. 사용자 관리
16. 릴레이 기능 (외부 메일발송 허용/차단 기능)
17. 그룹 설정/메일발송 기능
18. 로그 보기
19. 메일클라이언트 설정
20. 불량메일처리 정책

--- 외부설정 ---
21. 아웃룩 설정방법
22. 메일 수신을 위한 MX 설정방법
23. 메일발송 프로그램
24. 외부조작기능
25. 웹연동방법

--- 오류설명 ---
26. 메일서버 실행시 발생하는 오류 설명
27. 웹메일 오류코드표
28. 반송 오류코드표

1. 개요

이 문서는 zWMS를 운영하는 관리자에게 필요한 정보를 주기 위해서 만들어졌습니다.

zWMS 는 SMTP, POP3, WebMail 로 이루어져 있습니다.
SMTP Server 는 편지를 송수신하는 역할을 하며,
POP3 Server 는 Mail Client 에게 편지를 전달해 주는 역할을 합니다.
WebMail Server 는 웹상에서의 메일 처리를 담당하며, 메일서버의 환경설정, 시작/중지 등 모든 설정을 할 수 있습니다.

3. 세션사용

1) IP 세션

로그인을 하면 클라이언트의 IP가 서버에 저장되며, 로그아웃을 하면 IP 정보는 서버에서 사라집니다.
두 군데 이상의 컴퓨터에서 동시에 로그인을 하게 되면 뒤에 로그인한 사용자가 우선권을 가지게 되며 처음 로그인한 사용자는 자동으로 로그아웃이 됩니다.
IP가 다른 컴퓨터에서는 웹메일 URL로 직접 접근하더라도 허용되지 않습니다.
계정 정보에서 IP 세션 사용 항목을 언체크하면 IP 세션 검사를 하지 않습니다.

2) 쿠키 세션

로그인을 하면 계정 아이디가 클라이언트에 쿠키 형태로 저장되며, 로그아웃을 하더라도 쿠키 정보는 클라이언트에 남습니다.
IP가 동일하더라도 로그인을 하지 않아서 쿠키 세션이 없는 컴퓨터에서는 웹메일 URL로 직접 접근하더라도 허용되지 않습니다.
계정 정보에서 쿠키 세션 사용 항목을 언체크하면 쿠키 세션 검사를 하지 않습니다.

3) 난수 세션

로그인을 하면 난수가 생성되어 서버에 저장되며, 로그아웃을 하면 난수 정보는 서버에서 사라집니다.
난수가 일치하지 않는 웹메일 URL로 직접 접근하더라도 허용되지 않습니다.
계정 정보에서 난수 세션 사용 항목을 언체크하면 난수 세션 검사를 하지 않습니다.

클라이언트가 IP 공유 환경에 있을 수도 있으므로 모든 세션을 활성화 하는 것이 안전합니다.
IP 정보를 숨기는 클라이언트인 경우에는 IP 세션을 비활성으로 하면 됩니다.
쿠키를 허용하지 않는 클라이언트인 경우에는 쿠키 세션을 비활성으로 하면 됩니다..

4. 저장 용량

사용 가능한 최대 용량은 하드디스크에서 허용하는 용량까지입니다.
만일 디스크 용량부족이 발생하면 더이상 자료를 기록하지 못하게 되어 메일서버가 정상동작을 하지 못하게 됩니다.
디스크에 공간을 충분히 남겨두고, 불필요한 메일을 삭제해서 여유공간을 항상 확보해 두어야 합니다.

5. 환경변수 설정

환경변수는 MailServer의 기본설정을 지정하는 곳으로 관리자모드로 로그인 후 "환경변수설정" 메뉴를 선택하면 나타납니다.

항목별 설명은 환경변수 페이지 아래의 도움말을 참조하세요.

6. 웹메일스킨

웹메일 스킨을 기본적으로 제공하는 형태 중에서 선택하거나 자신만의 스킨을 만들 수 있습니다.

웹메일 스킨은 ./skin 폴더 안에 들어 있습니다.
사용할 스킨은 웹메일스킨 메뉴에서 선택할 수 있습니다.

또한 기본적으로 제공하는 스킨을 수정해서 자신만의 스킨을 만들 수도 있습니다. 이 때 만든 스킨은 ./skin/새이름 폴더를 만들어서 넣어 두면 선택할 수 있습니다.

다음은 기본 익명/사용자 스킨인 wow_coolwind 스킨의 주요 수정 파일입니다.
익명 공통 상단 화면 : commonhead_guest.html
사용자 공통 상단 화면 : commonhead.html
익명/사용자 공통 하단 화면 : commontail.html
로그인 화면 : loginuser.html
공지 화면 : notice.html
익명/사용자 로고 이미지 : zwms_logo.gif (익명/사용자 공통 상단 화면에서 보여줌)

다음은 관리자 스킨인 common 스킨의 주요 수정 파일입니다.
관리자 공통 상단 화면 : roothead.html
관리자 공통 하단 화면 : roottail.html
관리자 로고 이미지 : rootheadlogo.gif (관리자 공통 상단 화면에서 보여줌)

7. 발신/수신 확인 기능

발신확인기능 이란 zWMS WebMail에서 보낸 편지가 실제로 수신자에게 도착했는지 여부를 알려주는 기능입니다.

발신확인기능은 편지를 보낼때 '보낸 편지함에 보관하기'를 체크하면 설정이 됩니다.
'보낸 편지함에 보관하기'를 체크해 두면 편지의 복사본을 '보낸편지함' 에 보관하게 되며,
메일목록에서 각 메일의 구분 아이콘을 클릭하면 수신자별 발송 현황을 볼 수 있습니다.

수신확인기능 이란 zWMS WebMail에서 보낸 편지를 수신자가 읽었을 경우 그 시각을 알려주는 기능입니다.

수신확인신호를 받으려면 data/zwms.cfg에서 CHECKDOMAIN 항목에 메일서버로 접속될 수 있는 IP나 도메인을 설정해야 합니다.

수신확인기능은 편지를 보낼때 '보낸 편지함에 보관하기'를 체크하면 설정이 됩니다.
'보낸 편지함에 보관하기'를 체크해 두면 편지의 복사본을 '보낸편지함' 에 보관하게 되며,
수신자가 편지를 읽으면 보관된 편지의 아이콘이 붉은색으로 변하게 됩니다.
메일목록에서 각 메일의 구분 아이콘을 클릭하면 수신자별 수신확인 현황을 볼 수 있습니다.

일반적인 메일 클라이언트로 메일을 확인하면 정상동작을 하나, 메일을 다운받은 후에 통신이 안되는 상태에서 메일을 읽는다든지,
하이텔이나 천리안 등에서 Telnet 방식으로 메일을 읽으면 수신여부를 알 수 없습니다.

8. 폼메일 기능

폼메일은 웹메일 회원이 아닌 사용자가 로그인 없이 간단히 메일을 지정된 사람 (관리자) 에게 보낼 수 있는 기능입니다.
폼메일을 보내는 방법은 zhtmls/guest_mailwrite.html 또는 zhtmls/formmail.html을 참고 하시면 됩니다.

기본적으로 recvmail (받는사람), sendname (보내는사람 이름), sendmail (보내는사람 Email), subject (편지제목), body (편지본문) 의 5가지 항목이 필요하며,
추가로 필요한 항목은 "_" 로 시작하면 됩니다.

recvmail 항목은 편지를 받을 사람의 Email 주소를 적는 곳으로 반드시 정확한 메일 주소가 있어야 합니다.
나머지 항목들도 필요한 항목이지만 반드시 있어야 하는 것은 아닙니다.

추가 항목을 사용하고자 한다면 "_" 로 시작하는 항목이름을 적어주면 됩니다. 예를 들어 추가항목으로 나이를 입력 받고자 한다면 다음을 추가하면 됩니다.

9. 알림메일 기능

편지가 새로 도착하면 알림메일주소로 편지가 도착했음을 알리는 편지를 발송합니다. (제목만 포함해서 발송합니다.)
알림메일은 '환경설정 - 기본정보수정' 에서 설정할 수 있습니다.

10. 메일링리스트 사용하기

메일링리스트란, 특정 아이디로 메일이 오면, 그 곳에 등록된 모든 사용자에게 메일을 전달해 주는 기능입니다.
Email을 이용한 토의그룹, 게시판, 동호회, 고객관리 등을 구성하고자 할때 사용하면 됩니다.

사용방법은 data 디렉토리에 메일링리스트 중계용으로 사용할 Email 로 파일을 만듭니다. 파일이름 규약은 <email>.list 입니다.
만일 사용하고자 하는 Email 주소가 ad@domain.co.kr 이라면

ad@domain.co.kr.list

라는 파일을 만들면 됩니다.
여기서 위의 Email 에서 예를 든 ad 라는 아이디는 실제로 존재하면 안됩니다.

그리고 위에서 만든 파일 안에는 먼저 발송자의 Email 을 적고 그 다음부터 실제로 편지를 수신할 사람의 Email 을 적으면 됩니다.
예를 들어

webmaster@domain.co.kr
fulcrum29@hanmail.net
turbojin@hitel.net

등으로 한줄에 Email 하나씩 적어주면 됩니다.

위와 같이 하면 ad@domain.co.kr 로 발송하는 모든 편지는 fulcrum29@hanmail.net , turbojin@hitel.net 에게로 배달되게 됩니다.

* 주의할점
메일링리스트는 웹메일 또는 로칼 (메일서버가 설치된 컴퓨터) 에서만 발송할 수 있습니다.
받을 사람 목록에 반드시 발신자의 Email 도 포함되어 있어야 합니다. 아무나 메일링리스트 주소로 편지를 보낼 수 없도록 하기 위한 최소한의 제한사항입니다.

11. 대표메일 구성하기

대표메일이란, 특정 아이디로 메일이 오면, 그 곳에 등록된 모든 사용자에게 메일을 전달해 주는 기능입니다. 부서나 팀 구성원들에게 모두 메일이 전달될 수 있도록 하는데 사용하며, 하나의 계정을 여러개의 대표메일에 중복 포함시키는 것도 가능합니다. 메일링리스트와 다른 점은 메일링리스트는 외부로의 발송을 위해 사용하지만 대표메일은 메일수신을 위해 사용한다는 것입니다.

사용방법은 data 디렉토리에 대표메일 중계용으로 사용할 Email 로 파일을 만듭니다. 파일이름 규약은 <email>.rep 입니다.
만일 사용하고자 하는 Email 주소가 group@domain.co.kr 이라면

group@domain.co.kr.rep

라는 파일을 만들면 됩니다.
여기서 위의 Email 에서 예를 든 group 이라는 아이디는 실제로 존재하면 안됩니다.

그리고 위에서 만든 파일 안에는 실제로 편지를 수신할 사람의 Email 을 적으면 됩니다.
예를들어

woo@domain.co.kr
jinu@domain.co.kr

등으로 한줄에 Email 하나씩 적어주면 됩니다.

위와 같이 하면 group@domain.co.kr 로 발송하는 모든 편지는 woo@domain.co.kr , jinu@domain.co.kr 에게로 배달되게 됩니다.

* 주의할점
대표메일에는 메일링리스트에서와 같은 안전장치가 없으므로 외부 대량 발송용으로 사용하면 안됩니다.

12. 멀티도메인 기능

기본도메인 이외의 다른 도메인도 관리자 환경설정에서 추가하면 사용할 수 있습니다.

사용할 도메인을 '관리자 - 환경변수설정 - 다중 도메인 설정' 에 추가합니다.

멀티도메인사용시 중복 ID 설정하는 방법

13. 메일스킨 (편지작성시 스킨 이용하기)

편지작성시 미리 만들어둔 HTML 문서를 작성한 글의 앞과 뒤에 추가할 수 있습니다.
이 기능을 이용하면 편지지, 카드메일 등 다양한 응용이 가능합니다.

메일발송 zHTML 인 mailwrite.html 에는 다음과 같은 문구가 있습니다.

만일 위의 문구가 없다면 작성한 글의 앞뒤에 자동으로 "<html><body>", "</body></html>" 가 추가됩니다.
MailTemplate 라는 변수가 있다면 그곳에서 정의한 파일 (여기서는 template_1.html) 을 작성한 글의 앞뒤에 추가하게 됩니다.

template_1.html 의 내용이 다음과 같다면

$msg;

주의: 그림등을 링크할 때는 위의 예에서처럼 반드시 전체 URL (http:// 로 시작하는) 을 모두 적어야 합니다.

14. 게시판 관리

게시판은 관리자 모드에서 생성/수정/삭제 할 수 있습니다.

게시판에는 이름, 타이틀, Line/Page, 권한 의 4가지 속성이 있습니다.

Name (이름)
게시판의 실제이름 입니다. 게시판에 접근하기 위해서는 ?board=XXX 라는 항목이 반드시 있어야 하는데, 이때 XXX 에 해당하는것이 이름입니다.
Title (타이틀)
화면에 표시될 게시판의 이름으로 zHTML 에서만 사용되며 실질적으로 아무 역할도 하지 않습니다.
ArticleNum (글갯수)
게시판에 등록되어 있는 모든 글의 갯수입니다.
Line/Page
한 화면에 표시될 라인수를 설정하는 것으로 값은 1 부터 60 까지가 가능합니다.
Admin (관리자)
관리자는 해당 게시판에 대한 모든 권한을 가집니다. (메일서버관리자는 전체 게시판에 대한 모든 권한을 가집니다.)

Permision (권한)
게시판의 사용권한을 설정하는 것으로 의미는 다음과 같습니다.

None (없음)	게시판에 접근할 수 없습니다.
List (목록)	목록만 볼 수 있습니다.
Read (읽기)	게시물의 내용을 읽을 수 있습니다.
Write (쓰기)	게시물을 작성할 수 있습니다.
Attach (첨부)	게시물을 작성할 때 첨부파일을 추가할 수 있습니다.

Sendmail (메일발송)
메일발송에는 없음/글쓴이/관리자/모두(글쓴이+관리자) 가 있으며 새로운 글 등록시 관리자나 글쓴이 (기존글에 대한 답변일 경우) 에게 메일발송을 할 지 여부를 결정합니다. (관리자가 설정되어 있지 않은 경우에는 메일서버관리자에게 메일이 발송됩니다.)

게시판은 zHTML 을 이용해 다양하게 변형해서 사용할 수 있습니다.
./zhtmls/ 디렉리의 guest 로 시작하는 zhtml 에서 기본, 방명록, 쪽지, 공지사항 등 4가지 형태의 게시판 형태를 제공하고 있습니다.

게시판 사용방법
게시판을 사용하기 위한 URL은 미리 Sample 로 들어있는 b1 게시판을 참고하시면 됩니다.
아래의 URL 중에서 굵은글씨로 되어있는 b1 을 원하는 (새로 생성한) 게시판의 Name 으로 바꾸면 됩니다.

사용자게시판 (로그인 후 사용하는) 은, 사용자로그인 후 "게시판" - "자유게시판" 부분을 보시면 됩니다.
URL 은 다음과 같습니다.
손님 (Guest) 용 게시판은 초기로그인화면에서 가장 하단의 "게시판" 링크를 클릭하면 4가지 형태가 나와 있습니다.
각각의 URL 은 다음과 같습니다.

15. 사용자 관리

사용자 디스크 사용용량
사용자가 사용하는 용량은 DB를 사용하는 양으로 표시됩니다. 하나의 단위가 4KByte이며 4, 8, 12, ... 의 순으로 증가됩니다.
사용자 상태
사용자 상태는 '정상/신규/중지/취소' 가 있으며, '정상' 일때만 Login 이 가능합니다.
신규등록시 사용자의 초기 상태를 관리자 환경설정 메뉴에서 설정할 수 있으며, 사용자 목록보기 에서 사용자별로 상태를 변경시킬 수 있습니다.
* 사용자가 "계정삭제" 를 하면 해당내용이 관리자에게 Email 로 발송되고 사용자 계정은 "취소" 상태가 됩니다.

16. 릴레이 기능 (외부 메일발송 허용/차단 기능)

릴레이 기능은 "관리자메뉴 -> 환경설정" 에서 설정할 수 있으며 외부에서 메일이 도착했을 때 다시 중계해 주는 기능으로 OutLook 등의 메일 클라이언트를 사용할 때 필요한 기능입니다.
릴레이를 허용하고자 한다면 '선택적 릴레이 허용' 에 릴레이를 허용하고자 하는 IP 를 적어주면 됩니다.
설정해둔 IP 대역에서 오는 메일만 릴레이를 허용합니다. 192.168 은 IP 가 192.168.0.0 에서 192.168.255.255 까지의 컴퓨터에서 오는 메일만 릴레이를 허용하겠다는 의미입니다.

환경변수 '릴레이 IP 인증' 또는 계정 'SMTP 인증허용' 을 허가로 설정하거나 체크해 두면 선택적 릴레이와 관계없이 사용자 IP 인증을 거쳐 릴레이를 허용해 줍니다.
환경변수 '릴레이 계정 인증' 을 체크해 두면 발송자 아이디/패스워드가 인증되어야 릴레이를 허용해 줍니다.

17. 그룹 설정/메일발송 기능

사용자가 입력해서 사용하는 주소록/주소록그룹 이외에 전체회원을 그룹으로 분류하여 관리할 수 있는 기능이 제공됩니다.

"관리자모드 - 그룹관리" 에서 중첩된 트리구조로 그룹을 생성/수정/삭제 할 수 있습니다.

"관리자모드 - 사용자목록 - 아이디조회" 후 뜨는 "사용자 정보보기" 화면 하단의 "SetGroup" 항목에서 각 개인이 속할 그룹을 지정할 수 있습니다.
RootGID 는 이 계정 사용자에게 보여줄 최상위 그룹입니다. 이 사용자는 RootGID 아래에 있는 그룹만 볼 수 있습니다.
MyGID 는 이 계정 사용자가 속하는 그룹입니다. - 이 값이 "root" (GID:0) 이면 그룹기능을 사용하지 못합니다.

이 계정의 Root 그룹을 지정할 때는 RootGID 링크를 클릭하고, 자신이 속할 그룹을 지정할 때는 MyGID 링크를 클릭하십시오.
설정 후 Save 버튼을 누르면 변경된 내용이 반영되며 사용자로그인 후 그룹편지쓰기에서 RootGID 이하 그룹을 볼 수 있습니다. (MyGID 가 "root" 이면 그룹기능을 사용하지 못합니다.)

18. 로그 보기

메일서버에 의해 이루어진 모든 작업을 기록으로 남기고 보여 주는 기능입니다.

"관리자모드 - 시스템정보" 페이지 로그보기 부분에서 그 날의 최근 로그를 볼 수 있습니다.

"WebMail" 버튼을 누르면 웹메일과 POP3 관련 기록을 볼 수 있습니다.
"MailServer" 버튼을 누르면 수신 및 발송 관련 기록을 볼 수 있습니다.
"BlockMail" 버튼을 누르면 관리자 설정에 의해 수신을 거부한 기록을 볼 수 있습니다.
"SystemError" 버튼을 누르면 시스템 오류 발생 및 복구 관련 기록을 볼 수 있습니다.
"ServerStatus" 버튼을 누르면 발송 대기 현황을 볼 수 있습니다.

로그는 오늘의 최근 기록만 보여 줍니다. 잘려서 보이지 않는 기록은 logs 폴더에 들어 있는 파일에서 직접 봐야 합니다.

19. 메일클라이언트 설정

환경변수 메일클라이언트 관련 설정에 대해 시나리오 별로 설명합니다.
각 옵션에 대한 내용은 페이지 내의 도움말을 참고하세요.

1) 모든 계정이 개인 계정인 경우
환경변수 "읽은 편지로 변경" 을 체크하고 "POP3 공유" 를 해제로 설정하세요.

2) 일부 계정이 공용 계정인 경우
환경변수 "읽은 편지로 변경" 을 언체크하고 "POP3 공유" 를 계정으로 설정하세요.
개인계정 환경설정에서 "POP3 공유" 를 언체크하세요.
공유계정 환경설정에서 "POP3 공유" 를 체크하세요.

20. 불량메일처리 정책

불량메일처리 관련 설정에 대해 방식 별로 설명합니다.
각 옵션에 대한 내용은 페이지 내의 도움말을 참고하세요.

1) 환경변수 폭탄메일거부
동일 IP에서 5초 이내에 두 통 이상의 메일이 연속해서 오면 거부합니다.
발송처가 정상적인 메일서버라면 재발송을 시도하므로 메일이 정상적으로 수신될 것입니다.

2) 환경변수 불법메일거부
발송지 IP가 발송자 도메인의 MX 또는 A IP와 다르면 거부합니다.
통과로 설정하면 받은편지함으로 들어가고 계정으로 설정하면 스팸편지함으로 들어갑니다.

3) 환경변수 스팸메일거부
data/spam.dat 에 등록된 문자열을 제목 및 발송자와 비교하여 일치하는 부분이 있으면 거부합니다.
통과로 설정하면 받은편지함으로 들어갑니다.
계정으로 설정하면 계정 정크메일거부 설정에 따라 거부되거나 스팸편지함으로 들어갑니다.

4) 환경변수 바이러스메일거부
data/virus.dat 에 등록된 문자열을 첨부파일 확장자와 비교하여 일치하면 거부합니다.
통과로 설정하면 받은편지함으로 들어갑니다.
계정으로 설정하면 계정 정크메일거부 설정에 따라 거부되거나 스팸편지함으로 들어갑니다.

5) 환경변수 자동생성메일취소
수신에 대한 반송메일, 알림메일 발송을 취소합니다.
불량메일을 차단하는 것은 아니지만 폭탄성 불량메일에 의한 반송 및 알림 부하가 클 때 일시적으로 사용할 수 있습니다.

6) 환경변수 선택적 IP 차단
등록된 IP 대역을 발송지 IP와 비교하여 일치하는 부분이 있으면 거부합니다.

7) 계정 편지분류
등록된 문자열을 제목 및 발송자와 비교하여 일치하는 부분이 있으면 거부하거나 지정된 편지함에 넣습니다.

8) 계정 수신거부
등록된 메일주소를 발송자와 비교하여 일치하면 거부합니다.

9) 계정 IP 허용/거부
계정 IP 허용/거부 설정에 따라 수신 또는 거부합니다.
거부 IP로 등록되어 있는 IP로부터 온 메일은 거부합니다.
불법메일로 분류된 메일 중 허용 IP로 등록되어 있는 IP로부터 온 메일은 받은편지함으로 들어갑니다.

21. 아웃룩 설정방법

일반 사용자가 웹메일 기능을 사용하지 않고 편지를 메일서버를 통해 보내거나 가져오고자 할 때 메일 클라이언트를 사용할 수 있습니다.
여기에서는 일반적으로 가장 많이 사용하는 아웃룩에서의 설정 방법을 설명합니다.

먼저 메일서버 설정이 끝나고, 사용할 계정을 신규등록한 상태이어야 합니다.
아래에서는 도메인은 domain.co.kr, 계정은 webmaster, 비밀번호는 1234 라고 가정하고 설명합니다.
메뉴의 "도구 - 계정 - 추가 - 메일" 을 차례로 선택하면 "인터넷 연결 마법사" 창이 뜹니다.
표시이름에 [이름] 을 입력하고 "다음" 클릭.
전자메일주소에 사용할 메일주소를 입력함. 아이디가 webmaster 이고 도메인이 domain.co.kr 이라면 [webmaster@domain.co.kr] 을 입력하고 "다음" 클릭.
받는메일서버에 [도메인] (예를들면 domain.co.kr), 보내는메일서버에 [도메인] (받는 도메인과 같은 값) 을 입력하고 "다음" 클릭.
(만일 메일 송/수신이 잘 안될 경우에는 메일서버의 IP (127.0.0.1 등) 를 적으면 됩니다.)
계정이름에 [아이디] (예를들면 webmaster), 암호에 [비밀번호] (등록한 비밀번호. 예를들면 1234) 를 입력하고 "다음" 클릭.
"마침" 클릭
아웃룩 계정 속성에서 다음과 같이 설정하세요.
받는 메일 서버 "보안 암호 인증을 사용하여 로그온" 해제
보내는 메일 서버 "인증 필요" 체크
설정 버튼 누른 다음 "받는 메일 서버와 동일한 설정 사용" 체크

22. 메일 수신을 위한 MX 설정방법

메일수신을 위해서는 반드시 DNS 에 MX 설정이 정확하게 되어 있어야 합니다.

DNS 관리자 에게 특정도메인 (예를들면 home.ddns.co.kr) 으로 오는 메일을 특정컴퓨터 (메일서버를 설치한 컴퓨터. 예를들면 domain.co.kr 또는 IP:211.169.248.107 등) 에서 받을 수 있도록 MX 설정을 해 달라고 하면 됩니다.

23. 메일발송 프로그램

웹메일의 메일발송 기능을 이용할 수 없는 일반 CGI를 위한 프로그램입니다.
윈도우즈에서는 sendmail.exe 와 mail.exe 의 보안 속성에 everyone 사용자가 추가되어 있는지 확인하세요.
리눅스에서는 chmod +s sendmail 명령으로 sendmail 이 root 권한 파일에 접근할 수 있도록 해 두어야 합니다.

Mail
이 프로그램은 Unix 에 있는 "mail" 의 기능중 편지보내기 부분을 구현한 것입니다.

프로그램명은 mail.exe (Linux 에서는 mail) 이며 MailServer 와 같은 디렉토리에 있습니다.
리눅스에서는 linux 폴더에 있는 mail 을 /bin 에 넣어 두면 기존 CGI에서는 mail 의 경로를 수정할 필요가 없습니다.
단, 이 때는 zWMS 메일서버가 반드시 /usr/local/zwms 에 설치되어 있어야 합니다.
mail 을 사용하기 위해서는 반드시 MailServer 가 동작하고 있어야 합니다.

사용방법
"-s" 다음에는 제목을 적습니다. 만일 제목에 공백이 있다면 인용부호로 둘러 싸야 합니다.
"-c" 다음에는 참조자를 적습니다.
"-b" 다음에는 숨은참조를 적습니다.
수신자는 인수없이 그냥 적으면 됩니다.
마지막으로 < 본문파일이름 을 적습니다.
위의 경우에는 제목은 "제목을 적어요" 이며, 받는사람이 turbojin@hitel.net 이고, 참조는 fulcrum29@hanmail.net, webmaster@ddns.co.kr 의 두명이며, 숨은참조는 없습니다.
보내는사람은 자동으로 메일서버관리자로 잡힙니다.
보낼 내용은 mailbody.txt 에 저장하며 그 내용은 순수하게 본문만 있으면 됩니다.

SendMail
이 프로그램은 Unix 에 있는 "sendmail" 의 기능중 편지보내기 부분을 구현한 것입니다.

프로그램명은 sendmail.exe (Linux 에서는 sendmail) 이며 MailServer 와 같은 디렉토리에 있습니다.
리눅스에서는 linux 폴더에 있는 sendmail 을 /usr/sbin 에 넣어 두면 기존 CGI에서는 sendmail 의 경로를 수정할 필요가 없습니다.
단, 이 때는 zWMS 메일서버가 반드시 /usr/local/zwms 에 설치되어 있어야 합니다.
sendmail 을 사용하기 위해서는 반드시 MailServer 가 동작하고 있어야 합니다.

사용방법
"-f" 다음에는 보내는 사람을 적습니다.
수신자는 인수없이 그냥 적으면 됩니다.
마지막으로 < 본문파일이름 을 적습니다.
위의 경우에 보내는 사람은 webmaster@domain.co.kr 이며, 받는사람은 turbojin@hitel.net 입니다.
보낼 내용은 mailbody.txt 에 저장하며 그 내용은 헤더, 본문, 끝이 완벽하게 들어가 있어야 합니다.

mailbody.txt 의 예

From: <webmaster@domain.co.kr>
To: <turbojin@hitel.net>
Subject: 제목을 적어요
Content-Type: text/plain (HTML 메일이라면 text/html 로 설정)

본문 내용

.
CGI에서 외부 프로그램 실행 방법
- PHP 코드 예문
  
  system("c:\zwms\sendmail -f webmaster@domain.co.kr turbojin@hitel.net < mailbody.txt");
- ASP 코드 예문
  
  Set WshShell = CreateObject("WScript.Shell")
  wshshell.run "c:\zwms\sendmail -f webmaster@domain.co.kr turbojin@hitel.net < mailbody.txt", 0, true
- Perl 코드 예문
  
  exec("c:\zwms\sendmail.exe", "-f webmaster@domain.co.kr turbojin@hitel.net < mailbody.txt");

24. 외부조작기능

웹메일을 홈페이지의 다른 여러 기능과 통합시킬 수 있습니다.
일반적으로는 웹메일과 게시판등 서로 다른 프로그램을 같이 사용하고자 한다면 각각의 프로그램마다 별도의 로그인이 필요하나 zWMS 에서는 간단한 조작만으로 통합시킬 수 있습니다.
윈도우즈에서는 command.exe 의 보안 속성에 everyone 사용자가 추가되어 있는지 확인하세요.
리눅스에서는 chmod +s command 명령으로 command 가 root 권한 파일에 접근할 수 있도록 해 두어야 합니다.

command를 이용한 로그인 샘플 소스

웹페이지에서 command를 이용한 로그인을 시험해 볼 수 있는 샘플 소스입니다.
윈도우즈 또는 리눅스 (IIS 또는 아파치) 에서 동작하는 ASP와 PHP로 작성되어 있습니다.
zwms_login_command_wc.zip (wow_coolwind 스킨용)
zwms_login_command.zip (기존 스킨용)

웹메일을 이용하지 않고 외부 CGI나 프로그램에서 임의로 조작하고자 한다면 다음과 같이 코딩하면 됩니다.
command 에 주는 각 파라메터에 공백이 들어가 있으면 파라메터 구분에 혼동이 생기므로 해당 파라메터를 따옴표 (") 로 둘러 싸세요.

사용자신규등록

command /job:adduser ID PW Name Addr Tel1 Tel2 Num Email

주어진 내용대로 새로운 사용자를 등록합니다.
ID : 아이디
PW : 비밀번호
Name : 이름
Addr : 주소
Tel1 : 전화번호1
Tel2 : 전화번호2
Num : 주민등록번호
Email : 메일주소 (실아이디와 메일주소 아이디가 다른 경우에만 붙이세요.)
로그인

command /job:login ID IP

해당 아이디를 로그인시킵니다. 실제로 웹메일에서 로그인한 것과 같은 효과를 나타냅니다.
ID : 아이디
IP : 접속한 IP (환경변수 "REMOTE_HOST" 에서 얻을 수 있습니다.)
로그아웃

command /job:logout ID

해당 아이디를 로그아웃시킵니다.
ID : 아이디
비밀번호변경

command /job:changepw ID PW

해당 아이디의 비밀번호를 변경합니다.
ID : 아이디
PW : 비밀번호
메일갯수변경

command /job:changemq ID MailQty

해당 아이디의 메일 갯수를 변경합니다.
ID : 아이디
MailQty : 메일 갯수
메일용량변경

command /job:changemc ID MailCap

해당 아이디의 메일 용량을 변경합니다.
ID : 아이디
MailCap : 메일 용량
사용자삭제

command /job:deluser ID

해당 아이디 계정의 상태를 취소로 변경합니다. 계정의 자료가 없어지지는 않지만 계정을 사용할 수는 없게 됩니다.
ID : 아이디
개인주소록 다운로드

command /job:listaddr ID

해당 아이디 계정의 개인주소록을 data/addr/아이디.addrlist 파일로 꺼집어냅니다.
ID : 아이디
개인주소록 업로드

command /job:pushaddr ID

해당 아이디 계정의 개인주소록에 data/addr/아이디.addrlist 파일의 내용을 추가합니다.
ID : 아이디

25. 웹연동방법

웹메일을 홈페이지와 연동시킬 수 있습니다.
일반적으로는 웹메일과 게시판등 서로 다른 프로그램을 같이 사용하고자 한다면 각각의 프로그램마다 별도의 로그인이 필요하나, zWMS 에서는 간단한 이너프레임과 링크만으로 연동시킬 수 있습니다.

웹연동 로그인 샘플 소스

웹페이지에서 웹연동 로그인을 시험해 볼 수 있는 샘플 소스입니다.
윈도우즈 또는 리눅스 (IIS 또는 아파치) 에서 동작하는 ASP와 PHP로 작성되어 있습니다.

zwms_login_web.zip 샘플 소스

소스에서 난수 관련 부분은 인증 세션 유지용인데, 로그인시 메일서버에게 rand 파라메터로 넘겨 주고, 웹메일 URL에서 zwms 뒤에 그 난수를 붙여서 사용합니다.
따라서 그 난수를 DB에 저장시켜 두어야 이후 로그아웃 등의 연동 작업을 할 때 URL을 제대로 구성할 수 있습니다.
난수 세션을 이용하려면 환경변수에서 난수세션사용을 적용으로 설정하세요.
난수를 이용하지 않고 URL을 구성할 수도 있는데, 이 때는 환경변수에서 난수세션사용을 해제나 일부로 설정하세요.
로그인 외 다른 기능의 연동도 가능한데, 각 기능의 URL 포맷은 아래 제로보드 연동 PHP 샘플 파일에 나와 있는 URL을 참고하세요.

제로보드 연동 PHP 파일

제로보드 회원정보와의 연동을 구현한 제로보드 PHP 파일입니다.
가입, 로그인, 정보수정, 로그아웃, 탈퇴 기능에 대해 백그라운드에서 연동되도록 구성되어 있습니다.
각 PHP 파일에서 zWMS 로 검색하면 파일 끝 부분에서 찾을 수 있는 한 줄의 <iframe> 코드가 연동 코드입니다.

zwms_for_zb.zip 샘플 소스

웹메일 화면으로 들어가는 링크는 사이트 구성에 따라 달라질 것이므로 여기서 구현하지는 않았습니다.
아래 PHP 코드를 웹사이트 내 적당한 곳에 배치하면 됩니다. (http://127.0.0.1:9005 부분은 실제 접속 가능한 주소로 수정할 것)
echo("<a href='http://127.0.0.1:9005/zwms?ID=$member[user_id]&next=zhtmls/index.html'>웹메일</a>");

이 샘플 소스에서는 난수 세션은 넣지 않았는데, 넣을 경우에는 위 웹연동 샘플을 참고하세요.

26. 메일서버 실행시 발생하는 오류메세지 설명

MailServer 실행시 발생하는 오류에 관하여
오류메세지는 ./logs/[날자]error.log 파일에 기록됩니다.

*** Start fail(LCAPO): InitWinSock error.
*** Start fail(LCAPO): DB Port(n) open error
*** Start fail(LCAPO): HTTP Port(n) open error
*** Start fail (DNS can not found)
*** Start fail (SMTP port open error)
*** Start fail (POP3 port open error)
*** Start fail (DNS client port open error)
관리자로그인 화면에서 발생하는 오류에 관하여
Please change admin login ID and PASSWORD.
Please change system DOMAIN.
Please change admin NAME.
Please change admin mail ID.
SMTP port(25) open error. Can not receive any mail.
POP3 port(110) open error. Can not use an external mail client. (like Outlook)
Disk write permission error at './data/
Disk write permission error at './temp/
Disk write permission error at './logs/
Disk write permission error at './backup/
Disk write permission error at './session/
The MX record of Domain NNN is Invalid. Can not receive some mail.
Domain NNN MX IP is 0.0.0.0
Config complete.
zwms.cfg
서버포트나 서버 IP 등 설정을 바꾸고자 한다면 ./data/zwms.cfg 파일을 참고하시기 바랍니다.

27. 웹메일 오류코드표

다음의 오류코드표는 WebMail 사용시 Web에서 볼 수 있는 오류코드들입니다.

일반오류 : 사용자의 조작 실수로 생긴다.
논리오류 : 사용자 자료에 오류가 생겼거나, HTML이 잘못되었을 경우 발생한다.
시스템오류 : 주로 DB에 이상이 생겼을 경우 발생한다.

발생위치 : Main

논리오류(0001): ID 정보가 없습니다. 다시 로그인 하십시오.
> 로그인없이 WebMail에 바로 접근했다.

시스템오류(0002): 사용자 정보를 사용할 수 없습니다.
> 해당 아이디를 사용중이거나 아이디가 등록되어 있지 않다.

일반오류(0003): IP오류 로그인 정보가 없습니다.
> 세션오류. 로그인 없이 바로 접근했거나, 다른 컴퓨터에서 같은 아이디로 로그인했다.

일반오류(0004): 알수없는 Job입니다.
> HTML 오류. 'job=' 을 지정했으나 정의되어있지 않은 명령이다. 사용가능한 명령은 HTML 작성법을 참고하십시오.

시스템오류(0005): 세션자료를 저장할 수 없습니다.
> DB 오류. DB에 새로운 자료를 삽입할 수 없다. 컴퓨터의 디스크에 공간이 없거나 오류가 있을 때 발생합니다.

시스템오류(0006): 클라이언트로부터 받은 자료를 처리할 수 없습니다.
> 편지쓰기에서 자료의 양이 너무 많거나, Client 가 표준을 준수하지 않은 경우에 발생한다.

일반오류(0008): '정상' 사용자가 아닙니다. 관리자에게 문의하시기 바랍니다.
> 사용자 상태가 정상이 아니다. 관리자가 처리해주면 된다.

발생위치 : 신규등록

일반오류(1001): 이미 등록되어있는 ID입니다.
> 이미 등록되어 있는 아이디로 신규등록을 하려고 했다.

일반오류(1002): 비밀번호와 비밀번호확인이 일치하지 않습니다.
> 비밀번호1과 2가 일치하지 않는다.

시스템오류(1003): 접속자가 너무 많습니다. 다시 시도해 주십시오.
> DB에서 자료를 읽어올 수 없다. 잠시 후에 다시 해보아도 안된다면 DB를 다시 구동시켜야 한다.

발생위치 : 로그인

일반오류(1011): 비밀번호가 일치하지 않습니다.
> 로그인시 비밀번호가 틀렸다.

발생위치 : 계정정보수정

일반오류(1021): 비밀번호와 비밀번호확인이 일치하지 않습니다.
> 비밀번호 두개가 일치하지 않는다.

발생위치 : 편지이동

논리오류(1101): 이동할 편지함이 없습니다.
> 편지이동을 선택했으나 이동할 편지함이 없다.

발생위치 : 편지답장

논리오류(1111): 답장할 편지가 없습니다.
> 답장을 요구했으나 답장할 편지가 없다.

발생위치 : 편지쓰기

일반오류(1121): 수신자는 100명 이하이어야 합니다.
> 수신자를 100명 이상 선택했다. - 100명까지만 가능하다.

일반오류(1122): 수신자는 100명 이하이어야 합니다.
> 수신+참조자를 100명 이상 선택했다. - 100명까지만 가능하다.

일반오류(1123): 유효한 수신자가 없습니다.
> 수신+참조자가 한명도 없다. - 최소 1명이 있어야 한다.

시스템오류(1124): 새로운 편지를 만들 수 없습니다.
> DB오류 - 시스템오류(0005) 참고

일반오류(1125): 보내는 편지의 크기가 너무 큽니다.
> 보낼 수 있는 최대편지크기는 자신의 남은 계정크기와 같다. 자신의 계정크기는 '계정정보보기' 에서 확인할 수 있습니다.

발생위치 : 폴더추가

일반오류(1201): 생성할 편지함 이름이 주어지지 않았습니다.
> 편지함 생성시 이름을 주어야 한다.

논리오류(1202): 더이상 편지함을 만들 수 없습니다.
> 최대 등록 가능한 편지함 수를 초과했다. 최대편지함수는 '계정정보보기' 에서 확인할 수 있습니다.

발생위치 : 폴더삭제

논리오류(1211): 삭제할 편지함이 주어지지 않았습니다.
> 삭제하고자하는 편지함을 지정해야 한다.

논리오류(1212): 기본편지함은 삭제할수 없습니다.
> 삭제할 수 없는 편지함을 삭제하려고 했다. '받은편지함', '보낸편지함', '지운편지함' 은 삭제할 수 없습니다.

발생위치 : 주소수정

일반오류(1301): 더이상 주소를 추가할 수 없습니다.
> 주소록에 등록할 수 있는 주소의 갯수는 '계정정보보기' 에서 확인할 수 있습니다.

논리오류(1302): 그룹값이 허용치를 벗어났습니다.
> 주소를 수정하려고 했으나 수정하려는 Index가 허용범위를 벗어났다.

논리오류(1303): 그룹값이 허용치를 벗어났습니다.
> 주소를 이동하려 했으나 그룹이 허용범위를 벗어났다.

발생위치 : 주소그룹이동

논리오류(1311): 이동할 그룹이 없습니다.
> 이동을 지시했으나 어디로 이동하라는 것인지 알 수 없다.

발생위치 : 그룹추가

일반오류(1401): 생성할 그룹 이름이 주어지지 않았습니다.
> 그룹 생성시 이름을 지정해야 한다.

논리오류(1402): 더이상 그룹을 만들 수 없습니다.
> 최대 등록 가능한 그룹 갯수를 초과했다. 등록 가능한 그룹수는 '계정정보보기' 에서 확인할 수 있습니다.

발생위치 : 그룹삭제

논리오류(1411): 삭제할 그룹이 주어지지 않았습니다.
> 그룹을 삭제하려고 했으나 삭제할 그룹 Index가 주어지지 않았다.

발생위치 : 편지분류추가

일반오류(1501): 생성할 필터조건이 주어지지 않았습니다.
> 필터생성시 조건을 입력해야 한다.

논리오류(1502): 더이상 필터를 등록할 수 없습니다.
> 최대 필터 갯수는 '계정정보보기' 에서 확인할 수 있다.

발생위치 : 편지분류삭제

논리오류(1511): 삭제할 필터가 주어지지 않았습니다.
> 필터를 삭제하려고 했으나 Index가 주어지지 않았다.

발생위치 : 외부POP3등록

논리오류(1601): 더이상 외부POP3서버를 추가할 수 없습니다.
> 최대 등록 가능한 POP3 갯수를 초과했다. 등록 가능한 POP3 수는 '계정정보보기' 에서 확인할 수 있습니다.

논리오류(1602): Index값이 허용치를 벗어났습니다.
> 항목을 수정하려고 했으나 해당 항목이 없다.

논리오류(1603): 편지함Index값이 허용치를 벗어났습니다.
> 받을 디렉토리를 설정하려 했으나 해당 디렉토리가 없다.

발생위치 : 외부POP3삭제

논리오류(1611): 삭제할 항목이 주어지지 않았습니다.
> 삭제하려고 했으나 Index가 주어지지 않았다.

논리오류(1612): index값이 허용치를 벗어났습니다.
> 삭제하려고 했으나 Index가 허용치를 벗어났다.

발생위치 : 수신거부추가

일반오류(1701): 정확한 Email주소를 입력해야 합니다.
> 수신거부할 Email이 정확하지 않다.

일반오류(1702): 이미 등록되어 있는 Email 입니다.
> 수신거부 하고자 하는 Email 이 이미 등록되어 있다.

논리오류(1703): 더이상 수신거부 Email주소를 등록할 수 없습니다.
> 최대 등록 가능한 수신 거부 갯수를 초과했다. 등록가능한 갯수는 '계정정보보기' 에서 확인할 수 있습니다.

발생위치 : 수신거부삭제

논리오류(1704): 삭제할 Email이 주어지지 않았습니다.
> 수신거부 Email을 삭제하려고 했으나 Index가 주어지지 않았다.

발생위치 : 안읽은 편지로 만들기

논리오류(1801): 안읽은편지로 만들 편지가 없습니다.
> 안읽은편지로 만들려고 했으나 Index가 주어지지 않았다.

발생위치 : 관리자로그인

일반오류(3001): 해당 아이디는 등록되어있지 않습니다.
> 관리자 아이디를 틀리게 입력했다.

일반오류(3002): 비밀번호가 일치하지 않습니다.
> 관리자 비밀번호를 틀리게 입력했다.

발생위치 : 아이디변경

일반오류(3003): 아이디가 없습니다.
> 변경할 아이디를 입력하지 않았다.

일반오류(3004): 비밀번호가 없거나 두개가 일치하지 않습니다.
> 변경할 비밀번호가 없거나, 두개가 다르다.

발생위치 : 사용자정보수정

논리오류(3005): 수정하는 아이디가 없습니다.
> 사용자 정보를 수정하고자 했으나 아이디가 주어지지 않았다.

논리오류(3006): 해당아이디를 찾을수 없습니다.
> 변경된 자료를 저장하려는데 기존 자료파일이 없다.

시스템오류(3007): 사용자 자료를 저장할 수 없습니다.
> 사용자 자료를 저장할 수 없다.

발생위치 : 제품등록

등록오류(3008): 시리얼번호가 정확하지 않습니다.
> 잘못된 시리얼번호를 입력했다.

발생위치 : 가상Email등록

논리오류(3009): 입력한 내용이 Email 주소가 아닙니다.
> 가상 Email 주소를 잘못 입력했다.

논리오류(3010): 입력한 내용이 Email 주소가 아닙니다.
> 실제 Email 주소를 잘못 입력했다.

발생위치 : 관리자

논리오류(3011): 로그인 정보가 없습니다. 다시 로그인 하십시오.
> 로그인없이 바로 접근했다. - 다시 로그인 하면 된다.

시스템오류(3012): 관리자 세션정보를 저장할 수 없습니다.
> 관리자 세션정보를 저장할 수 없다.

발생위치 : 화면구성

일반오류(2101): 파일을 읽을 수 없습니다.
> html에서 'next=' 로 파일을 지정했으나 열 수 없다.

* DB Server가 작동하지 않고 있으면 "Can not access DB" 라고 나옵니다.

28. 반송 오류코드표

다음의 오류코드표는 SMTP Server 가 편지를 발송할 수 없을때 반송되는 편지에 포함되어있는 코드들에 관한 설명입니다.

Code = 1

TimeOut
전송 대기시간 초과
> 편지보내기를 계속 시도했으나 지정된 시간 (편지재전송한계시간) 안에 보내지 못했음.

Code = 2

DNS Query error (SMTP server not found)
DNS 질의오류 (메일서버를 찾을수 없음)
> DNS 질의를 했으나 적합한 응답을 받지 못했음. (SMTP 서버를 찾지 못했음)

Code = 3

Do not find user
수신자를 찾을 수 없음
> 편지를 보내려 했으나 상대방 SMTP Server에서 해당 사용자의 편지 수신을 거부했음. (사용자가 없음)

Code = 4

This user has too many mails
너무 많은 편지를 가지고 있음
> 내부사용자에게 편지를 주려고 했으나, 보관편지갯수 초과로 발신이 취소되었음.

Code = 5

This mail is too big
편지함 용량 초과
> 내부사용자에게 편지를 주려고 했으나, 계정 할당량 초과로 발신이 취소되었음.

Code = 6

The user is invalid
사용자를 찾을 수 없음
> 상태설정이 "정상" 이 아닌 사용자에게 메일이 와서 거부함.

Code = 7

File access error
파일에 접근할 수 없음.
> 시스템 오류로 DB 에 접근할 수 없다.

Code = 421

Service error.
서비스 활용 불가능
> domain 서비스가 수행되지 않음: 전송 채널을 폐쇄하고 있음.

Code = 450

Too busy.
명령어 실패 (우편함이 잠겨 있음)
> 편지를 보내려 했으나 상대방 SMTP 서버에서 접속을 거부했음.

Code = 451

Server error.
서버오류
> 요청된 행위가 강제 종료 되었음: 처리에서 오류 발생

Code = 452

System disk full.
시스템 저장공간이 부족함
> 요청된 행위가 이루어지지 않았음: 저장 장치가 충분하지 못함.

Code = 500

Invalid Command error.
알수없는 명령 (문법 오류)
> 구문 오류, 명령이 인식되지 않았음. (명령 행이 너무 긴 경우 등의 오류가 포함됨)

Code = 501

Command error.
명령인자 문법 오류
> 매개변수나 인수 (argument) 에서의 구문 오류

Code = 502

Do not service this command.
구현되지 않은 명령어
> 명령이 구현되지 않았음.

Code = 503

Command sequence error.
잘못된 명령어 순서
> 명령들의 순서가 잘못되었음.

Code = 504

Invalid option.
구현되지 않은 인수
> 명령 매개변수가 구현되지 않았음.

Code = 552

DiskFull
클라이언트가 할당 저장용량을 초과했음
> 편지를 보내려 했으나 상대방 SMTP 서버에서 해당 사용자의 편지 수신을 거부했음. (계정 할당량 초과)

Code = 550, 551, 553

Invalid user.
우편함 이름이 유효하지 않음
> 편지를 보내려 했으나 상대방 SMTP 서버에서 해당 사용자의 편지 수신을 거부했음.

Code = 554

Job fail.
작업실패
> SMTP Server 간 요청/질의/응답 과정에 알 수 없는 오류가 발생하였음.

■■■