[Infra Ops] SMTP 메일과 SMS 게이트웨이 운영 실무

[앱]  send(수신자, 본문)
   │
   ① 발송 요청 준비        (수신자·본문 + 발신 신원: 발신번호/From, 인증 토큰·SASL 계정)
   │
   ② 게이트웨이 연결·인증   (SMTP 587 STARTTLS / HTTPS API + Bearer 키)
   │
   ③ 메시지 전송(접수)     (릴레이·게이트웨이가 자기 큐에 접수 → 250 queued / resultCode:1)
   │    → 여기서의 "성공"은 접수됐다는 뜻이지 도착했다는 뜻이 아님
   │
   ④ 수신 서버·통신사 큐    (수신 MX / 이동통신사로 비동기 전달, 임시 실패는 재시도)
   │
   ⑤ 전달 또는 바운스      (수신함 저장 / 스팸 격리 / 반송·발송 실패)
   │
   ⑥ 상태 콜백·로그        (delivery report·webhook / maillog·resultCode)
   ▼
[운영]  전달률은 ⑥으로 측정 — ③의 접수 응답이 아니라

[앱 서버] → MUA(SMTP 587) → [릴레이 MTA] → [수신 MTA] → MDA → [수신자 메일함]
              발송 요청         SMTP 25/587    DNS MX 조회     저장

# /etc/postfix/main.cf 핵심 설정 예시

# 릴레이할 SMTP 서버 (포트 587: STARTTLS)
relayhost = [smtp.example.com]:587

# SASL 인증 활성화 (릴레이 서버가 인증을 요구할 때)
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous

# TLS 사용 (STARTTLS)
smtp_tls_security_level = encrypt
smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt

# 발신 도메인
myorigin = example.com

# /etc/postfix/sasl_passwd (인증 정보 파일)
[smtp.example.com]:587  mailuser@example.com:secretpassword

# 파일 등록 후 해시 생성 및 권한 설정
sudo postmap /etc/postfix/sasl_passwd
sudo chmod 600 /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db

# Postfix 재로드
sudo systemctl reload postfix

# 큐에 쌓인 메일 목록
mailq
# 또는
postqueue -p

# 큐 강제 발송 시도
postqueue -f

# 특정 메일 큐 항목 상세 확인 (Queue ID로)
postcat -q <QUEUE_ID>

# 큐 전체 삭제 (주의: 미발송 메일 전부 삭제)
postsuper -d ALL

# DNS TXT 레코드 예시 (example.com 도메인)
example.com.  IN  TXT  "v=spf1 ip4:203.0.113.10 include:_spf.sendgrid.net ~all"

# 읽는 법:
# v=spf1          → SPF 버전 1
# ip4:203.0.113.10 → 이 IP에서 보내는 메일은 허용
# include:...      → SendGrid 서버도 허용
# ~all             → 목록 외 서버는 SoftFail (수신은 하되 의심 마킹)
# -all             → 목록 외 서버는 HardFail (거부)

# DNS TXT 레코드 (selector._domainkey.example.com)
default._domainkey.example.com.  IN  TXT
  "v=DKIM1; k=rsa; p=MIGfMA0GCSq..."

# 동작 원리:
# 발신 서버 → 메일 헤더+바디를 개인키로 서명 → 서명값을 헤더에 첨부
# 수신 서버 → DNS에서 공개키 조회 → 서명 검증 → 위변조 여부 확인

# DNS TXT 레코드 (_dmarc.example.com)
_dmarc.example.com.  IN  TXT
  "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com; pct=100"

# p=none      → 모니터링만 (처음 도입 시 권장)
# p=quarantine → 실패 메일을 스팸함으로
# p=reject    → 실패 메일을 거부
# rua=        → 일일 집계 보고서 수신 주소

# SPF 레코드 조회
dig TXT example.com | grep spf

# DKIM 레코드 조회 (selector 이름은 메일 서버 설정 확인)
dig TXT default._domainkey.example.com

# DMARC 레코드 조회
dig TXT _dmarc.example.com

# curl로 SMS 발송 테스트 (가상의 게이트웨이 예시)
curl -X POST https://api.sms-gateway.com/v1/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "from": "01012345678",
    "to": "01098765432",
    "text": "[인증번호] 귀하의 인증번호는 123456입니다.",
    "type": "SMS"
  }'

# 응답 예시 (성공):
# {
#   "resultCode": "1",
#   "message": "성공",
#   "messageId": "MSG20260530001234"
# }

# 응답 예시 (실패):
# {
#   "resultCode": "-1001",
#   "message": "미등록 발신번호"
# }

# 게이트웨이 로그에서 실패 분류
# -1001: 미등록 발신번호 → 번호 등록 확인
# -1002: 잔액 부족 → 충전
# -9999: 통신사 오류 → 재시도
# 수신 거부: 080 수신거부 서비스 가입자 → 목록에서 제거