Files

kappa 49fe96775a Add 5 more runbooks

- aws-ses-setup.md: AWS SES email configuration
- anvil-ses-final-setup.md: Anvil SES final setup
- n8n-setup-guide.md: n8n workflow automation
- gitea-setup.md: Gitea server installation
- cloudflare-vault-integration.md: Cloudflare + Vault integration

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-16 00:39:06 +09:00

6.6 KiB

Raw Blame History

AWS SES 메일 발송 설정 가이드

작성일: 2026-01-12 리전: ap-northeast-2 (서울)

개요

AWS SES(Simple Email Service)를 사용하여 서버에서 메일을 발송하기 위한 설정 가이드입니다.

계정 상태

항목	값
리전	ap-northeast-2 (서울)
모드	프로덕션 (샌드박스 해제됨)
24시간 발송 한도	50,000통
초당 발송률	14통/초

인증된 도메인

도메인	도메인 인증	DKIM
`anvil.it.com`	✅ Success	✅ Success
`ironclad.it.com`	✅ Success	✅ Success

사용 가능한 발신자 주소

*@anvil.it.com      (예: noreply@anvil.it.com, support@anvil.it.com)
*@ironclad.it.com   (예: noreply@ironclad.it.com, admin@ironclad.it.com)

DNS 설정 (Cloudflare)

anvil.it.com

TXT 레코드 (도메인 소유권 확인)

Type	Name	Content
TXT	`_amazonses.anvil.it.com`	`0cuw9v32N+aeFiNlTh2Poxglgzf3BlmFRjVOjeLEdy4=`

CNAME 레코드 (DKIM)

Type	Name	Target
CNAME	`dgcehnldehfmfgpvrrbc6drwasiibhnp._domainkey`	`dgcehnldehfmfgpvrrbc6drwasiibhnp.dkim.amazonses.com`
CNAME	`spopdscdt2sxngqzl5ir66k3ed6og7ut._domainkey`	`spopdscdt2sxngqzl5ir66k3ed6og7ut.dkim.amazonses.com`
CNAME	`55l5wnmktvacgyfpt6sovcgb2rqexrpy._domainkey`	`55l5wnmktvacgyfpt6sovcgb2rqexrpy.dkim.amazonses.com`

ironclad.it.com

TXT 레코드 (도메인 소유권 확인)

Type	Name	Content
TXT	`_amazonses.ironclad.it.com`	`C+RMHyLd/U2H5WSCu8L2avRn8NmuwEll0xxYjTyvoEY=`

CNAME 레코드 (DKIM)

Type	Name	Target
CNAME	`5sycmzu364y2rgefnqaloptgodymasct._domainkey`	`5sycmzu364y2rgefnqaloptgodymasct.dkim.amazonses.com`
CNAME	`qm7d7qgkdikpcbrbgo7bmgqfmuulrbah._domainkey`	`qm7d7qgkdikpcbrbgo7bmgqfmuulrbah.dkim.amazonses.com`
CNAME	`tu6oey5tktoqub753cxpayhhwrlzcskk._domainkey`	`tu6oey5tktoqub753cxpayhhwrlzcskk.dkim.amazonses.com`

IAM 권한 설정

최소 권한 정책 (권장)

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "SESSendEmail",
            "Effect": "Allow",
            "Action": [
                "ses:SendEmail",
                "ses:SendRawEmail"
            ],
            "Resource": "*"
        }
    ]
}

특정 발신자 제한 정책

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "SESSendFromVerified",
            "Effect": "Allow",
            "Action": [
                "ses:SendEmail",
                "ses:SendRawEmail"
            ],
            "Resource": [
                "arn:aws:ses:ap-northeast-2:*:identity/anvil.it.com",
                "arn:aws:ses:ap-northeast-2:*:identity/ironclad.it.com"
            ]
        }
    ]
}

사용 방법

AWS CLI

aws ses send-email \
  --from "noreply@anvil.it.com" \
  --to "recipient@example.com" \
  --subject "메일 제목" \
  --text "메일 본문" \
  --region ap-northeast-2

Python (boto3)

import boto3
from botocore.exceptions import ClientError

def send_email(to_email: str, subject: str, body: str, sender: str = "noreply@anvil.it.com"):
    client = boto3.client('ses', region_name='ap-northeast-2')

    try:
        response = client.send_email(
            Source=sender,
            Destination={'ToAddresses': [to_email]},
            Message={
                'Subject': {'Data': subject, 'Charset': 'UTF-8'},
                'Body': {
                    'Text': {'Data': body, 'Charset': 'UTF-8'},
                    # HTML 본문 사용 시:
                    # 'Html': {'Data': '<h1>Hello</h1>', 'Charset': 'UTF-8'}
                }
            }
        )
        print(f"발송 완료: {response['MessageId']}")
        return response
    except ClientError as e:
        print(f"발송 실패: {e.response['Error']['Message']}")
        raise

# 사용 예시
send_email(
    to_email='recipient@example.com',
    subject='테스트 메일',
    body='안녕하세요!'
)

Python (HTML 메일)

def send_html_email(to_email: str, subject: str, html_body: str, text_body: str = None):
    client = boto3.client('ses', region_name='ap-northeast-2')

    body = {'Html': {'Data': html_body, 'Charset': 'UTF-8'}}
    if text_body:
        body['Text'] = {'Data': text_body, 'Charset': 'UTF-8'}

    response = client.send_email(
        Source='noreply@anvil.it.com',
        Destination={'ToAddresses': [to_email]},
        Message={
            'Subject': {'Data': subject, 'Charset': 'UTF-8'},
            'Body': body
        }
    )
    return response

# 사용 예시
html = """
<html>
<body>
    <h1>안녕하세요!</h1>
    <p>AWS SES로 발송된 <strong>HTML 메일</strong>입니다.</p>
</body>
</html>
"""
send_html_email('recipient@example.com', '테스트', html)

환경변수 설정 (컨테이너용)

export AWS_ACCESS_KEY_ID="your_access_key"
export AWS_SECRET_ACCESS_KEY="your_secret_key"
export AWS_DEFAULT_REGION="ap-northeast-2"

환경변수 설정 시 코드에서 자격증명 생략 가능:

client = boto3.client('ses')  # 환경변수에서 자동 로드

상태 확인 명령어

# 발송 활성화 상태
aws ses get-account-sending-enabled

# 발송 한도 확인
aws ses get-send-quota

# 등록된 Identity 목록
aws ses list-identities

# 도메인 인증 상태
aws ses get-identity-verification-attributes --identities anvil.it.com ironclad.it.com

# DKIM 상태
aws ses get-identity-dkim-attributes --identities anvil.it.com ironclad.it.com

새 도메인 추가 방법

1. SES 도메인 등록

aws ses verify-domain-identity --domain newdomain.com
aws ses verify-domain-dkim --domain newdomain.com

2. Cloudflare DNS 레코드 추가

출력된 토큰으로 TXT, CNAME 레코드 추가 (Cloudflare API 또는 대시보드)

3. 인증 확인

aws ses get-identity-verification-attributes --identities newdomain.com
aws ses get-identity-dkim-attributes --identities newdomain.com

참고 사항

프로덕션 모드: 수신자 제한 없음
DKIM: 메일 신뢰도 향상 (스팸 방지)
발송 한도: 필요시 AWS에 증가 요청 가능
비용: $0.10 / 1,000통

6.6 KiB Raw Blame History