SMTP 이메일 설정#

모든 플랜 에서 사용 가능

자체 호스팅 배포

프로덕션 환경에서는 이메일 기반 인증 을 사용할 때 이메일 알림과 비밀번호 재설정을 위해 SMTP 이메일이 필요합니다.

SMTP 이메일 서비스 설정#

모든 SMTP 이메일 서비스를 사용할 수 있습니다. 다음 정보의 복사본이 필요합니다: Server Name, Port, SMTP Username, SMTP Password.

팁

SMTP 서비스가 없는 경우 Amazon Simple Email Service (SES) 로 설정할 수 있습니다:

Amazon SES 콘솔 로 이동한 다음 SMTP 설정 > SMTP 자격 증명 생성 을 선택하세요.
Server Name, Port, SMTP Username, SMTP Password 값을 복사하세요. Mattermost를 구성하는 데 이러한 값이 필요합니다.
Domains 메뉴에서 새 도메인을 설정하고 확인한 다음 도메인에 대해 Generate DKIM Settings 를 활성화하세요. 이메일 도메인에 대해 Sender Policy Framework (SPF) 및/또는 Domain Keys Identified Mail (DKIM)을 설정하는 것을 권장합니다.
mattermost@domain.com 와 같은 발신자 주소를 선택하고 설정이 올바르게 작동하는지 확인하기 위해 Send a Test Email 를 선택하세요.

또는 아래에 나열된 서비스 중 하나를 사용하거나 Server Name 127.0.0.1 와 Port 25 를 설정하여 로컬 sendmail 을 설정할 수 있습니다.

Docker 를 사용하여 Mattermost를 배포하는 경우, 표준 docker 172.16.0.0/12 IP 범위는 사용되지 않습니다. 릴레이 액세스 오류를 방지하기 위해 이메일 서비스에 IP 범위 192.168.0.0/24 를 지정하세요. postfix를 사용하는 경우 /etc/postfix/main.cf 에서 mynetworks = 192.168.0.0/24 를 지정하세요. 이는 Mattermost가 배포되는 방식에 따라 달라질 수 있습니다. 방화벽이 있는 경우 Port 25 가 열려 있는지 확인하세요.

SMTP 설정 구성#

Mattermost에서 System Console > Authentication > Email 로 이동하여 Allow Sign Up With Email 을 true 로 설정하세요.
System Console에서 Notifications > Email 로 이동하여 SMTP 서비스에 맞게 Mattermost를 구성하세요. 자세한 내용은 SMTP configuration 문서를 참조하세요.

Send Email Notifications 를 true 로 설정하세요.

알림을 보내는 계정의 Notification Display Name 을 설정하세요.

알림을 보내는 데 사용할 이메일 주소로 Notification Email Address 를 설정하세요.

초기 설정에서 복사한 SMTP Username, SMTP Password, SMTP Server, SMTP Port 를 입력하세요.

Mattermost와 SMTP 서비스 간의 통신을 암호화하기 위해 Connection Security 를 TLS (Recommended) 로 설정하는 것을 권장합니다.

Save 를 선택하세요.
Connection Security 아래에서 Test Connection 을 선택하세요. Mattermost는 이메일을 보내서 SMTP 서비스에 대한 연결이 성공적인지 확인합니다. 테스트가 실패하면 Mattermost는 System Console에서 실패 이유에 대한 세부 정보를 제공합니다. 자세한 내용은 아래의 check Mattermost logs 섹션을 참조하세요.

SMTP 설정 예시#

Amazon SES

SMTP Username 을 [YOUR_SMTP_USERNAME] 로 설정하세요
SMTP Password 를 [YOUR_SMTP_PASSWORD] 로 설정하세요
SMTP Server 를 email-smtp.us-east-1.amazonaws.com 으로 설정하세요
SMTP Port 를 465 로 설정하세요
Connection Security 를 TLS 로 설정하세요

Postfix

Postfix가 Mattermost와 동일한 시스템에 설치되어 있는지 확인하세요.

SMTP Username 을 (empty) 로 설정하세요
SMTP Password 를 (empty) 로 설정하세요
SMTP Server 를 localhost 로 설정하세요
SMTP Port 를 25 로 설정하세요
Connection Security 를 (empty) 로 설정하세요

Gmail

SMTP Username 을 your_email@gmail.com 로 설정하세요
SMTP Password 를 your_password 로 설정하세요
SMTP Server 를 smtp.gmail.com 으로 설정하세요
SMTP Port 를 587 로 설정하세요
Connection Security 를 STARTTLS 로 설정하세요

경고

SMTP 이메일이 Google 서버를 통해 릴레이되도록 하려면 Google에서 추가 구성이 필요합니다. 필요한 단계는 SMTP relay: Route outgoing non-Gmail messages through Google 를 참조하세요.

Hotmail

SMTP Username 을 your_email@hotmail.com 로 설정하세요
SMTP Password 를 your_password 로 설정하세요
SMTP Server 를 smtp-mail.outlook.com 으로 설정하세요
SMTP Port 를 587 로 설정하세요
Connection Security 를 STARTTLS 로 설정하세요

Office365/Outlook

SMTP Username 을 your_email@hotmail.com 로 설정하세요
SMTP Password 를 your_password 로 설정하세요
SMTP Server Name 을 smtp.office365.com 으로 설정하세요
SMTP Port 를 587 로 설정하세요
Connection Security 를 STARTTLS 로 설정하세요

SMTP 문제 해결#

TLS/STARTTLS 요구사항#

SMTP Username 과 SMTP Password 를 입력한 경우 Connection Security 를 TLS 또는 STARTTLS 로 설정해야 합니다

로그를 사용한 문제 해결#

SMTP 설치에 문제가 있는 경우 Mattermost 팀 사이트에서 System Console > Logs 로 이동하여 설정과 관련된 오류 메시지를 확인하세요. 오류 코드를 검색하여 문제를 좁힐 수 있습니다. 때로는 ISP에서 SMTP에 대한 세부적인 설정이 필요하며 오류 코드가 적절한 조정 방법을 암시할 수 있습니다.

예를 들어, System Console > Logs 에서 다음과 같은 오류가 표시되면 554 5.7.1 error 와 Client host rejected: Access denied 를 검색하세요.

Connection unsuccessful: Failed to add to email address - 554 5.7.1 <unknown[IP-ADDRESS]>: Client host rejected: Access denied

알림 설정 확인#

자체 호스팅 Mattermost 배포의 System Console에서 SMTP 연결 테스트가 Connection unsuccessful: Failed to set the to address: 550 5.7.27 <test@example.com> 메시지와 함께 실패하는 경우 System Console > Site Configuration > Notifications 로 이동하여 Notification Display Name, Notification From Address, Support Email Address, Notification Reply-To Address 를 포함한 알림 설정이 올바르게 구성되었는지 확인하세요. 클라우드 관리자는 Notification From Address 또는 Notification Reply-To Address 를 관리할 수 없습니다.

SMTP 서버 연결 가능 여부 확인#

서버가 연결 가능한지 확인하기 위해 이메일 서비스에 Telnet을 시도하세요. 자세한 내용은 https://learn.microsoft.com/en-us/exchange/mail-flow/test-smtp-with-telnet?view=exchserver-2019 를 방문하세요. Exchange Server 2019보다 이전 버전을 사용 중인 경우 왼쪽 탐색 메뉴에서 해당 버전을 선택하세요.
mattermost/bin/mattermost 가 있는 동일한 머신이나 가상 인스턴스에서 다음 명령어를 실행해야 합니다.
telnet mail.example.com 25 로 이메일 서버에 Telnet을 시도하세요. 명령어가 작동하면 다음과 같은 내용이 표시됩니다:
```
Trying 24.121.12.143...
Connected to mail.example.com.
220 mail.example.com NO UCE ESMTP
```
그런 다음 HELO <your mail server domain> 와 같은 내용을 입력하세요. 명령어가 작동하면 다음과 같은 내용이 표시됩니다:
```
250-mail.example.com NO UCE
250-STARTTLS
250-PIPELINING
250 8BITMIME
```

참고

Telnet은 공식 Mattermost Docker 이미지에 포함되어 있지 않으므로, 해당 이미지에서는 ping 을 사용하거나 Dockerfile을 수정하여 직접 Telnet을 설치해야 합니다.
추가 도움이 필요하면 문제 해결 포럼 에서 이전에 보고된 오류를 검토하거나 문제 해결을 위해 Mattermost 사용자 커뮤니티에 참여하세요.