Redmine에서 Incoming Email Settings

1. Redmine에서 Incoming Email Settings란?

Redmine의 Incoming Email Settings(수신 메일 설정) 기능은
이메일을 통해 이슈(issue)를 자동으로 생성하거나 댓글을 등록할 수 있게 해주는 기능입니다.
이를 통해 사용자는 Redmine 웹 인터페이스에 직접 접속하지 않고도,
지정된 이메일 주소로 메일을 보내는 것만으로 이슈를 등록하거나 기존 이슈에 응답할 수 있습니다.

자세한 내용은 Redmine Wiki를 참고 바랍니다.
https://www.redmine.org/projects/redmine/wiki/RedmineReceivingEmails

---

2. 주요 사용 예시

• 고객이 support@example.com 으로 메일을 보내면, 자동으로 이슈가 생성됨
• 개발자가 이슈 알림 메일에 답장하면, 해당 답장이 자동으로 해당 이슈의 댓글로 등록됨
• IT팀이 메일을 통해 내부 요청을 Redmine에서 자동 처리하도록 연결

---

3. 기능 구성 요소

Incoming Email 기능을 사용하기 위해서는 몇 가지 조건이 필요합니다:

1. 메일 수신 서버(IMAP 또는 POP3)
   • Gmail, Exchange, 자체 메일 서버 등
   • Redmine이 해당 메일 서버에 접속하여 메일을 읽어올 수 있어야 합니다.
2. 메일 핸들러 설정(receive_imap 또는 receive_pop3)
   • Redmine은 extra/mail_handler 디렉터리 아래에 메일 수신을 위한 스크립트를 제공합니다.
3. crontab 또는 시스템 서비스로 주기적 실행 설정
   • 메일을 수시로 확인하고 이슈로 등록하려면, 일정 주기로 해당 스크립트를 실행시켜야 합니다.

---

4. 장점

• 이메일만으로도 이슈 등록이 가능해 편리함
• 외부 사용자(고객, 일반 사용자)와의 연동 가능
• 실시간 대응을 위한 유용한 도구

---

5. Redmine Incoming Email 설정 방법 (Gmail 예시)

5-1. Gmail 계정 준비 및 앱 비밀번호 생성

Redmine에서 Gmail을 통해 메일을 수신하려면, Gmail 계정에서 앱 비밀번호를 생성해야 합니다.
(2단계 인증이 활성화되어 있어야 사용 가능)

1. https://myaccount.google.com/ 에 접속
2. 좌측 메뉴 → 보안 → 2단계 인증 설정
3. 아래로 스크롤하여 앱 비밀번호(App passwords) 클릭
4. 앱 이름을 입력하고 생성 → 16자리 비밀번호 복사

⚠️ 이 비밀번호는 분실 시 재확인이 불가능하므로 따로 안전하게 저장해 주세요.

 

---

5.2 Redmine 서버에서 메일 수신 스크립트 실행 준비

Redmine에는 기본적으로 extra/mail_handler/ 디렉터리 안에 메일 수신용 스크립트가 존재합니다.

예:

/path/to/redmine/extra/mail_handler/receive_imap.rb