Mattermost SMTP 설정

오늘은 mattermost에서 SMTP를 설정하는 방법에 대하여 알아볼 것이다.

SMTP는 Simple Mail Transfer Protocol의 약자로, 인터넷에서 이메일을 보내기 위해 사용되는 표준 통신 규약이다.
메일 서버 간에 이메일을 전송하거나, 클라이언트에서 메일 서버로 이메일을 보낼 때 사용된다.

Mattermost에서는 사용자들에게 중요한 알림을 전달해야 될 때 사용된다.

• 새로운 멘션이나 다이렉트 메시지 알림
• 비밀번호 재설정 요청
• 계정 활성화 및 확인 이메일
• 기타 시스템 알림

즉, SMTP 설정은 Mattermost 사용자들이 오프라인 상태이거나 앱을 확인하지 않을 때도 중요한 정보를 놓치지 않도록 이메일 알림 기능을 활성화하는 데 필수적이다.

 

이제 설정을 진행해볼 것인데, 자신이 사용하고자 하는 이메일 서비스별로 약간 설정이 다르니 우선 전체적인 것을 보고 가장 아래에 정리해 둔 각 이메일 서비스별 선택항목을 사용하면 될 것 같다.

1. 시스템 콘솔 접속

Mattermost 시스템 관리자 계정으로 로그인한 후, 왼쪽 상단의 메뉴 버튼을 클릭하여 시스템 콘솔로 이동하고 SMTP 설정에 들어가면 아래와 같이 나오게 된다.

2. SMTP 세부항목 설정

2-1. SMTP 서버

사용하는 이메일 서비스의 SMTP 서버 주소를 입력 (Ex: smtp.gmail.com, smtp.office365.com)

2-2. SMTP 서버 포트

각 SMTP 서버에 맞는 포트 번호를 입력해준다.

Amazon SES:465, Postfix:25, Gmail:587, Hotmail:587, Office365:587 등

2-3. SMTP 사용자 이름 및 비밀번호 설정

SMTP에 사용될 계정과 비밀번호를 적어줘야 하는데, 그전에 STMP를 자신의 이메일 서비스에서 먼저 활성화시켜줘야 한다.
나는 gmail을 이용할 것이기 때문에 gmail에서 SMTP를 설정하는 방법에 대해서 작성해 보겠다.

우선 google.com에 들어간 뒤 홈화면에서 우측에 있는 메뉴버튼->계정을 눌러준다.

그리고 우측 메뉴에서 보안탭을 클릭한뒤, 2단계 인증을 설정해 준다.
2단계 인증을 설정하고 들어가 보면, 아래에 앱 비밀번호라는 항목이 보인다.

 

앱 비밀번호를 생성해 준다. 이때 나오는 비밀번호를 꼭 복사해 놓는다.

이제 다시 mattermost system console로 돌아간다.
mattermost를 selfhosting 해서 사용하는 사람이 아니라면 콘솔에서 직접 설정해 주면 된다.
Username 부분에는 자신의 구글 계정을, Password 부분에는 방금 위에서 생성한 앱비밀번호를 공백 없이 작성해 주면 된다.

나처럼 docker을 이용해서 호스팅을 하고 있으면 해당 창이 비활성화되어 있을 수도 있다.

그러면 아래에 적힌 경로에 있는 config파일을 열어서 직접 작성해 주고 컨테이너를 재실행해주자.

sudo nano {mattermost_dir}/volumes/app/mattermost/config/config.json

 

위의 파일을 열어서 EmailSettings 부분에 있는 SMTPUsername과 SMTPPassword를 수정해 주면 된다.
이후 컨테이너를 재실행해준다.

2-4. 보안 연결

보안 연결도 자신의 이메일 서비스에 맞게 설정해줘야 한다. 나는 구글이라서 STARTTLS을 선택해 줬다.

2-5. 테스트

위의 설정들을 모두 저장하고 연결 테스트버튼을 클릭하여 입력한 정보가 올바른지, SMTP 서버와 정상적으로 통신이 되는지 확인한다.
정상적으로 되면 성공이라는 메시지와 함께 자신이 설정한 이메일로 테스트 이메일이 날아올 것이다.

3. 이메일 서비스별 SMTP 설정

이메일 서비스	SMTP 사용자 이름	SMTP 비밀번호	SMTP 서버	SMTP 포트	연결 보안
Amazon SES	[YOUR_SMTP_USERNAME]	password	email-smtp.us-east-1.amazonaws.com	465	TLS
Postfix	-	-	localhost	25	없음
Gmail	your_email@gmail.com	password	smtp.gmail.com	587	STARTTLS
Hotmail/Outlook	your_email@hotmail.com	password	smtp-mail.outlook.com	587	STARTTLS
Office 365	your_email@your_domain.com	password	smtp.office365.com	587	STARTTLS

4. Docs

부족한 항목이 있으면 질문 혹은 Docs를 참고하면 될 것 같다.

SMTP email setup - Mattermost documentation

 

Environment configuration settings - Mattermost documentation