SMTP 이메일 설정

모든 플랜 에서 사용 가능

프로덕션 환경에서 실행하려면 Mattermost는 이메일 기반 인증을 사용하는 시스템의 이메일 알림 및 비밀번호 재설정을 위해 SMTP 이메일이 활성화되어야 합니다.

이메일을 활성화하는 방법

이메일을 활성화하려면 다음과 같이 SMTP 이메일 서비스를 구성하십시오.

SMTP 이메일 전송 서비스 설정 (아직 자격 증명이 있는 SMTP 서비스가 없는 경우)
- SMTP 이메일 서비스는 다음 정보가 필요합니다: 서버 이름 , 포트 , SMTP 사용자 이름 , 그리고 SMTP 비밀번호 .
- SMTP 서비스가 없는 경우 다음과 같이 설정할 수 있습니다:
  - Amazon Simple Email Service (SES) :
    
    Amazon SES 콘솔 로 이동하고
    SMTP 설정 > 내 SMTP 자격 증명 생성 을 선택합니다.
    
    단계 2를 위해 서버 이름 , 포트 , SMTP 사용자 이름 , 그리고
    SMTP 비밀번호 를 복사합니다.
    
    도메인 메뉴로 이동하여 새 도메인을 설정하고 확인한 후,
    
    해당 도메인에 대해 DKIM 설정 생성 을 활성화합니다.
    
    1. 이메일 도메인에 대해 Sender Policy Framework (SPF) 및/또는 도메인 키 식별 메일 (DKIM) 를 설정하는 것이 좋습니다.
    
    mattermost@example.com 과 같은 발신자 주소를 선택하고
    
    설정이 올바르게 작동하는지 확인하기 위해 테스트 이메일 전송 을 선택합니다.
  - 로컬에서 sendmail 을 사용하려면 서버 이름 을 127.0.0.1 로 설정하고 포트 를 25 로 설정합니다.
  - 또는 샘플 SMTP 설정 에서 나열된 서비스 중 하나를 사용할 수 있습니다.
SMTP 설정 구성

제품 메뉴 > 시스템 콘솔 로 이동합니다.

대안으로 팀이 아직 없다면 serverURL 로 이동하여 시스템 콘솔로 이동 을 선택합니다.

인증 > 이메일 탭으로 이동하여 다음을 구성합니다:

이메일로 회원가입 허용: true

알림 > 이메일 탭으로 이동하여 다음을 구성합니다:

이메일 알림 전송: true

알림 표시 이름: 이메일 알림을 보내는 계정의 표시 이름

알림 이메일 주소: 이메일 알림을 보내는 이메일 계정에 표시되는 이메일 주소

SMTP 사용자 이름 : 단계 1의 SMTP 사용자 이름

SMTP 비밀번호 : 단계 1의 SMTP 비밀번호

SMTP 서버 : 단계 1의 SMTP 서버

SMTP 포트 : 단계 1의 SMTP 포트

연결 보안 : TLS (권장)

그런 다음 저장 을 선택합니다.

그런 다음 연결 테스트 를 선택합니다.

테스트가 실패한 경우 OTHER > 로그 에서 [ERROR] /api/v4/email/test ... 와 유사한 오류를 확인하십시오.

(옵션) 보안 > 회원가입 탭으로 이동하여 다음을 구성합니다:

이메일 초대 활성화: true

샘플 SMTP 설정

Amazon SES

SMTP 사용자 이름 을 [YOUR_SMTP_USERNAME] 로 설정
SMTP 비밀번호 를 [YOUR_SMTP_PASSWORD] 로 설정
SMTP 서버 를 email-smtp.us-east-1.amazonaws.com 으로 설정
SMTP 포트 를 465 로 설정
연결 보안 을 TLS 로 설정

Postfix

Mattermost가 설치된 기기에 포스트픽스가 설치되어 있는지 확인합니다
SMTP 사용자 이름 을 (비어 있음) 으로 설정
SMTP 비밀번호 를 (비어 있음) 으로 설정
SMTP 서버 를 localhost 로 설정
SMTP 포트 를 25 로 설정
연결 보안 을 (비어 있음) 으로 설정

Gmail

SMTP 사용자 이름 을 your_email@gmail.com 으로 설정
SMTP 비밀번호 를 your_password 로 설정
SMTP 서버 를 smtp.gmail.com 으로 설정
SMTP 포트 를 587 로 설정
연결 보안 을 STARTTLS 로 설정

Warning

SMTP 이메일을 구글을 통해 릴레이하려면 추가 구성이 필요합니다. 필요한 단계에 대한 자세한 내용은 SMTP relay: Route outgoing non-Gmail messages through Google 를 참조하십시오.

Hotmail

SMTP 사용자 이름 을 your_email@hotmail.com 으로 설정
SMTP 비밀번호 를 your_password 로 설정
SMTP 서버 를 smtp-mail.outlook.com 으로 설정
SMTP 포트 를 587 로 설정
연결 보안 을 STARTTLS 로 설정

Office365/Outlook

SMTP 사용자 이름 을 your_email@hotmail.com 으로 설정
SMTP 비밀번호 을 your_password 으로 설정
SMTP 서버 이름 을 smtp.office365.com 으로 설정
SMTP 포트 를 587 로 설정
연결 보안 을 STARTTLS 로 설정

SMTP 문제 해결

TLS/STARTTLS 요구 사항

SMTP 사용자 이름 및 SMTP 비밀번호 을 입력하면 연결 보안 을 TLS 또는 STARTTLS 로 설정해야 합니다.

로그를 사용한 문제 해결

SMTP 설치에 문제가 있는 경우, Mattermost 팀 사이트에서 시스템 콘솔 > 로그 로 이동하여 설정 관련 오류 메시지를 찾을 수 있습니다. 오류 코드로 문제를 좁히기 위해 오류 코드에 대한 검색을 수행할 수 있습니다. 때로는 ISP가 SMTP에 세심한 설정을 요구하며 오류 코드는 적절한 조정 방법을 힌트로 제공할 수 있습니다.

예를 들어, 시스템 콘솔 > 로그 에 다음과 같은 오류 코드가 있는 경우:

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

``554 5.7.1 에러``   및   ``Client host rejected: Access denied``  를 검색하십시오.

SMTP 서버에 접근 가능한지 확인하기

이메일 서비스에 Telnet을 시도하여 서버에 접근 가능한지 확인합니다. 자세한 내용은 https://docs.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… mail.example.com에 연결되었습니다. 220 mail.example.com NO UCE ESMTP

그런 다음 HELO <귀하의 메일 서버 도메인> 과 같이 입력하세요. 명령이 작동하면 다음과 같은 내용이 표시됩니다.

250-mail.example.com NO UCE 250-STARTTLS 250-PIPELINING 250 8BITMIME

Note

공식 도커 이미지에서는 기본적으로 telnet을 설치하지 않기 때문에 해당 이미지에서는 ping 을 사용하거나 직접 또는 Dockerfile을 수정하여 telnet을 설치해야 합니다.
더 많은 지원이 필요한 경우, 이전에 보고된 오류를 위해 문제 해결 포럼 을 검토하거나 문제 해결 도움말을 위해 Mattermost 사용자 커뮤니티에 가입하세요. 이 페이지를 개선하거나 수정 사항을 제출하려면 페이지 오른쪽 상단의 편집 을 선택하세요.

Mattermost 원문 보기