> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 設定 Amazon SES 郵件

使用 AWS SDK 或 IAM SMTP 憑證為網頁、移動端和桌面端配置 Amazon SES，驗證發件人，並避免不必要的 Mail Manager 端點費用。

## 1. 在所選 AWS 區域驗證發件人

在 US East (N. Virginia)，即 us-east-1，開啟 Amazon SES。選擇 Configuration → Identities → Create identity，選域名或郵箱並完成 DNS 或郵件驗證。下方設定使用同一區域和已驗證的發件人。

新 SES 賬戶預設處於沙盒：也要驗證收件人，或使用 SES 郵箱模擬器。向普通客戶傳送前，在 Account dashboard 申請生產訪問許可權。[開啟 Amazon SES](https://us-east-1.console.aws.amazon.com/ses/home?region=us-east-1)


## 2. SMTP 選擇 IAM SMTP credentials

在 SES 開啟 SMTP settings → Create SMTP credentials。選擇 IAM SMTP credentials，不選標為 Recommended 的 Mail Manager。IAM 卡片說明為 Manual credential management. No traffic policies or rule sets. 點選 Create IAM credentials，為傳送使用者命名，並在關閉頁面前下載 SMTP 憑證。

[建立 IAM 憑證](https://us-east-1.console.aws.amazon.com/iam/home?SESRegion=us-east-1#/users/smtp/create) · [管理現有使用者](https://us-east-1.console.aws.amazon.com/iam/home#/users)

這些連結使用支援傳統 IAM SMTP 的 us-east-1。使用其他受支援區域時，要建立該區域的憑證並使用對應 SMTP 端點。下載的 SMTP 密碼與 AWS 秘密訪問金鑰不同，只用於第 5 步。[AWS SMTP 憑證說明](https://docs.aws.amazon.com/ses/latest/dg/smtp-credentials.html)


## 3. 避免不必要的 Mail Manager 費用

IAM SMTP 和 SES SDK 直接通過 SES 傳送，無需 Mail Manager 流量策略或規則集。避免建立可選的開放或 mTLS 入站端點：AWS 按需定價列出的費用為每個端點每月 50 美元。目前需要身份驗證的端點免費，因此 Recommended 選項並不一定增加 50 美元。正常傳送費用和所選定價方案仍然適用。[檢視 AWS 當前定價](https://aws.amazon.com/ses/pricing/)


## 4. 使用 AWS SDK 傳送

此模式通過 HTTPS 使用 SES API。在 IAM 為後端角色或專用傳送使用者授予已驗證 SES 身份的 ses:SendEmail 許可權。使用者開啟 Security credentials → Create access key，儲存訪問金鑰 ID 和原始秘密訪問金鑰。SMTP 密碼不能用於簽署 SDK 請求。

開發時將示例放入 apps/web/.env.local，生產時放入後端託管平臺的金鑰設定，並替換髮件人和佔位值。使用 IAM 角色或配置好的本地 AWS 配置檔案時，將兩個金鑰欄位和 AWS_SESSION_TOKEN 留空，SDK 會使用預設憑證鏈。顯式填寫金鑰時必須同時提供兩個值。

顯式使用臨時憑證時，還需設定匹配的 AWS_SESSION_TOKEN，並在過期後更新全部三個值。角色憑證由 SDK 自動重新整理。[AWS SDK 預設憑證鏈](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html)

```
EMAIL_PROVIDER=ses
EMAIL_FROM=Your App <hello@yourdomain.com>
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=<IAM-access-key-id>
AWS_SECRET_ACCESS_KEY=<original-IAM-secret-access-key>
# Temporary explicit credentials only:
AWS_SESSION_TOKEN=
```


## 5. 或使用傳統 IAM SMTP

此替代配置使用第 2 步下載的 SMTP 使用者名稱和 SMTP 密碼。埠 587 使用 STARTTLS，SMTP_SECURE=false 選擇該連線模式。端點、憑證和已驗證發件人必須屬於同一區域。

這些是購買者模板的配置，三個平臺共用。每次選擇一種郵件模式：EMAIL_PROVIDER=smtp 使用 SMTP 憑證，EMAIL_PROVIDER=ses 使用 SDK API 憑證。

```
EMAIL_PROVIDER=smtp
EMAIL_FROM=Your App <hello@yourdomain.com>
SMTP_HOST=email-smtp.us-east-1.amazonaws.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=<downloaded-SMTP-username>
SMTP_PASSWORD=<downloaded-SMTP-password>
```


## 6. 一次配置，適用於網頁、移動端和桌面端

修改配置後重啟後端。完成資料庫遷移後，在 /auth 向允許的收件人請求一封登入驗證碼，檢查收件箱和垃圾郵件。移動端呼叫同一後端，桌面端載入網頁應用。兩個客戶端都不需要 AWS 金鑰或 SMTP 密碼。

憑證僅儲存在後端，不能放入 NEXT_PUBLIC_、EXPO_PUBLIC_ 或桌面安裝包。傳送失敗時，檢查發件人驗證、沙盒收件人限制、區域、IAM 許可權和憑證型別。queued 僅表示 SES 已接收郵件，不保證已送達收件箱。[郵件配置概覽](https://supastack.dev/zh-tw/docs/web/setup-email.md)


如果你想繼續完成設定，可以閱讀《[收集其餘提供商金鑰](https://supastack.dev/zh-tw/docs/web/provider-keys.md)》。


## 下一篇

[收集其餘提供商金鑰](https://supastack.dev/zh-tw/docs/web/provider-keys.md)