SMTP 연동
기존 SMTP 클라이언트에서 암호화 연결로 단일 수신자 이메일을 발송하세요.
1. 연결 설정
공개 호스트, 포트, 인증서 호스트명은 배포 담당자에게 확인하세요. 소스 기본값은 587 STARTTLS와 465 암시적 TLS이며 공개 설정으로 검증되지 않았습니다. PLAIN / LOGIN의 비밀번호는 API Key입니다. 사용자명은 현재 인증 판단에 사용되지 않는 클라이언트 라벨입니다.
| 필드 / 설정 | 타입 / 상태 | 설명 |
|---|---|---|
| host / port | configuration | 공개 설정 확인 필요, 소스 기본값만으로 불충분 |
| TLS | STARTTLS / implicit | 암호화·인증서 검증 후 AUTH |
| username | string | 클라이언트 라벨, 현재 인증 판단에 미사용 |
| password | API Key | 전체 API Key, 계정 비밀번호 아님 |
2. 암호화 후 인증
STARTTLS는 연결, EHLO, TLS 전환, 다시 EHLO 및 AUTH 순서입니다. 암시적 TLS는 연결 시작부터 암호화합니다. 인증서 검증을 끄지 마세요. 평문 연결에서는 AUTH가 허용되지 않습니다.
SMTP_HOST=${SMTPDOG_SMTP_HOST}
SMTP_PORT=${SMTPDOG_SMTP_PORT}
SMTP_USERNAME=${SMTPDOG_SMTP_USERNAME}
SMTP_PASSWORD=${SMTPDOG_API_KEY}
SMTP_TLS_MODE=${SMTPDOG_SMTP_TLS_MODE}3. 본문 및 수신자 제한
메시지당 RCPT TO는 1개만 허용되며 두 번째는 거부됩니다. 게이트웨이는 Subject와 text/html을 추출해 메시지를 재생성합니다. 첨부파일과 추가 헤더를 온전히 보존하지 않으며 CC/BCC를 지원하지 않습니다. 허용된 확장자가 첨부파일 전달을 의미하지 않습니다. 또한 From 헤더의 표시 이름(주소가 MAIL FROM과 일치할 때만 사용), Reply-To, List-Unsubscribe, List-Unsubscribe-Post, Auto-Submitted를 읽습니다.
4. 연결 문제 해결
인증 오류는 TLS와 API Key, 권한 오류는 인증된 도메인과 키 범위, 한도 오류는 총량·일·시간 한도를 확인하세요. 451은 임시 오류, 452는 한도 또는 복수 수신자, 550은 콘텐츠나 권한 오류일 수 있습니다. SMTP 접수는 최종 전달이 아니며 HTTP message_id를 반환하지 않습니다.