이메일 구성 (SMTP)

슈퍼 관리자는 하나 이상의 SMTP 발신자를 유지하고, 하나를 플랫폼 기본값으로 표시하며, 선택적으로 팀별로 이 기본값을 재정의할 수 있습니다. 플랫폼 이메일(온프레미스 비밀번호 재설정 포함)은 해당되는 경우 팀 컨텍스트에 대한 확인된 구성을 사용합니다.

이는 에이전트/워크플로우의 SMTP 툴킷(자격 증명은 툴킷에 있음)과는 별개입니다. 이메일 구성은 초대, 알림, 비밀번호 재설정과 같은 시스템 메시지를 위한 플랫폼 메일 경로입니다.

전제 조건

슈퍼 관리자입니다(이메일 구성은 슈퍼 관리자 전용; RBAC 참고).
메일 제공자가 EKB 호스트에서의 SMTP를 허용합니다(필요 시 방화벽 / IP 허용 목록).
제공자의 호스트, 포트, TLS(STARTTLS) 또는 SSL(암시적 TLS) 중 어느 것을 기대하는지 알고 있습니다.
온프레미스 비밀번호 재설정과 시스템 메일을 위해, 최소 하나의 정상 구성이 기본값으로 표시되어야 합니다.

찾는 곳

Super Admin → Email Configuration을 엽니다. 두 개의 하위 탭:

탭	목적
SMTP Settings	SMTP 구성 생성, 편집, 테스트, 비활성화, 기본값 설정
Templates	플랫폼 이메일 템플릿의 HTML/제목 편집

SMTP Settings 레이아웃은 왼쪽의 구성 목록과 오른쪽의 세부 양식으로 구성됩니다. 해당되는 경우 Default 및 Active 배지가 표시됩니다. 빈 양식을 시작하려면 New SMTP를 사용하세요.

필드 레퍼런스

저장에 필수: Name, Host, Sender email.

필드	필수	설명
Name	예	목록 및 팀 SMTP 선택기에 표시되는 레이블(예: `Transactional Email` 또는 `EU relay`).
Host	예	SMTP 서버 호스트네임(예: `smtp.example.com`).
Port	아니오 (기본값 `587`)	일반적인 값: TLS는 `587`, SSL은 `465`, 때로는 릴레이에 `25` 또는 `2525`.
Username	아니오	인증 SMTP의 로그인 사용자. 인증되지 않는 릴레이에는 비워두세요.
Password	아니오	SMTP 비밀번호 또는 앱 비밀번호. 저장된 비밀번호를 유지하려면 편집 시 비워두세요.
Clear saved password	—	새 비밀번호를 입력하지 않은 기존 구성에 표시됩니다. 다음 저장 시 저장된 시크릿을 지웁니다. 취소하려면 Undo clear를 사용하세요.
Sender email	예	플랫폼 메일에 사용되는 보낸 사람 주소.
Sender name	아니오 (기본값 `System`)	보낸 사람 주소 옆에 표시되는 이름.
TLS	—	연결 후 STARTTLS. 포트 `587`에서 일반적. 제공자가 특정 조합을 요구하지 않는 한 TLS와 SSL을 함께 활성화하지 마세요.
SSL	—	첫 연결부터의 암시적 SSL/TLS. 포트 `465`에서 일반적.

플랫폼 이메일 암호화가 구성되면 비밀번호는 암호화되어 저장됩니다.

일반적인 제공자 패턴

제공자 패턴	호스트 (예)	포트	보안
Gmail / Google Workspace (앱 비밀번호)	`smtp.gmail.com`	`587`	TLS 켬
Microsoft 365 / Outlook	`smtp.office365.com` 또는 `smtp-mail.outlook.com`	`587`	TLS 켬
기업 릴레이 (내부)	릴레이 호스트네임	`25` / `587`	흔히 TLS; 인증은 선택적일 수 있음

호스트, 포트, 인증에 대해서는 항상 제공자의 최신 문서를 따르세요.

구성 추가 또는 편집

Super Admin → Email Configuration → SMTP Settings로 이동합니다.
New SMTP를 클릭하거나 목록에서 기존 구성을 선택합니다.
필드 레퍼런스의 필드를 입력합니다.
Save를 클릭합니다. 성공 시 구성이 저장되었음을 확인합니다.
새 구성을 기본값으로 표시하거나 팀에 할당하기 전에 Send test email을 권장합니다.

테스트 이메일 보내기

저장된 구성을 선택합니다(저장되지 않은 새 양식은 안 됨).
테스트 이메일 동작을 열고 확인할 수 있는 수신자 주소를 입력합니다.
메시지가 예상된 Sender email / Sender name에서 도착하는지 확인합니다.

테스트가 실패하면 UI는 SMTP 시도의 오류 세부 정보를 표시합니다(인증 실패, 연결 거부, TLS 불일치 등). 호스트/포트/보안/자격 증명을 수정하고 다시 테스트하세요.

플랫폼 기본값

정확히 하나의 활성 구성이 플랫폼 기본값이 될 수 있습니다.

기본값으로 원하는 구성을 선택합니다.
Make default를 선택하고 확인합니다.

SMTP 재정의가 없는 팀은 이 기본값을 사용합니다. 기본값을 변경하면 Platform default로 설정된 모든 팀의 메일이 업데이트됩니다.

팀별 SMTP 할당

Super Admin → Teams를 엽니다 → 팀을 선택 → Settings → Edit Settings.
SMTP Configuration에서 선택:
- Platform default (현재 <이름>) — 현재 기본값을 상속하고 향후 기본값 변경을 따름, 또는
- 특정 이름의 구성 — 플랫폼 기본값이 변경되어도 해당 발신자로 팀을 고정.
팀 설정을 저장합니다.

확인 순서

팀에 고정된 smtp_config_id가 있고 해당 구성이 여전히 활성 → 해당 구성을 사용.
그렇지 않으면 → 플랫폼 기본값을 사용.
고정된 구성이 없거나 비활성화됨 → 플랫폼 기본값으로 폴백.

재정의가 설정되면 팀 목록 뷰는 SMTP 레이블 옆에 실제 발신자 이메일을 표시할 수 있습니다.

구성 비활성화

비활성화는 구성을 소프트 비활성화합니다(활성 목록에서 제거되며, 이력의 강력한 삭제는 아닙니다).

여전히 사용 중인 발신자를 비활성화하기 전에 팀과 플랫폼 기본값을 전환하는 것이 좋습니다.
플랫폼 이메일에 의존하는 경우 최소 하나의 정상 기본값을 유지하세요.

이메일 템플릿

Templates 탭에서 플랫폼 이메일 템플릿(제목 및 본문)을 편집할 수 있습니다. 지원되는 경우 템플릿별 미리보기 및 기본값 복원 동작이 제공됩니다. 템플릿은 해당 팀(또는 플랫폼 기본값)에 대해 확인된 SMTP 경로로 렌더링됩니다.

비밀번호 재설정 (온프레미스)

비밀번호 재설정 이메일은 구성된 SMTP 경로로 발송되며, 재설정 링크는 백엔드를 통해 라우팅되어 온프레미스 배포에서도 올바르게 작동합니다. SMTP가 없거나 잘못 구성되면 재설정 메일이 실패합니다(호출자는 서비스 불가용 유형의 오류를 볼 수 있음). 온프레미스에서 셀프서비스 재설정에 의존하기 전에 SMTP를 구성하고 테스트하세요.

일반적인 구성

구성	접근 방식
단일 기업 릴레이	하나의 구성, Default로 표시; 모든 팀은 플랫폼 기본값 유지
공유 대 테넌트 발신자	대부분의 팀은 기본값; 고접촉 테넌트는 자체 SMTP로 재정의
제공자 마이그레이션	새 구성 추가 → 테스트 → Default 전환 → 여전히 이전 호스트를 가리키는 팀별 재정의 제거 → 이전 구성 비활성화

문제 해결

증상	확인할 사항
테스트 이메일 실패	EKB 백엔드에서 호스트/포트 접근 가능 여부; TLS 대 SSL; 사용자명/비밀번호; 제공자 앱 비밀번호 / IP 허용 목록
팀이 여전히 잘못된 주소로 발송	팀의 SMTP Configuration 재정의 대 플랫폼 기본값; 의도한 구성이 Active 및 Default인지
비밀번호 재설정 메일이 도착하지 않음 (온프레미스)	플랫폼 기본값 SMTP가 존재하고 테스트를 통과하는지; 스팸 폴더; 제공자에서의 발신자 도메인 SPF/DKIM
비밀번호를 지울 수 없음	Clear saved password를 사용한 다음 Save
SMTP 툴킷은 되지만 플랫폼 메일은 안 됨	예상된 동작입니다. 툴킷 자격 증명은 이메일 구성과 별개입니다

전제 조건​

찾는 곳​

필드 레퍼런스​

일반적인 제공자 패턴​

구성 추가 또는 편집​

테스트 이메일 보내기​

플랫폼 기본값​

팀별 SMTP 할당​

확인 순서​

구성 비활성화​

이메일 템플릿​

비밀번호 재설정 (온프레미스)​

일반적인 구성​

문제 해결​

관련 문서​