aws-mail-manager

Amazon SES Mail Manager

Amazon SES Mail Manager は、受信メール向けのメール処理サービスです。SMTP 受信ポイント経由でメールを受信し、トラフィックポリシーとルールセットを適用してから、メッセージをアーカイブ、リレー、S3、SNS、WorkMail にルーティングするか、破棄します。

主な機能

• 受信ポイント — メールを受信する SMTP エンドポイント（OPEN、AUTH、MTLS）です。MX レコードの参照先として設定します。TLS ポリシーは REQUIRED、OPTIONAL、FIPS から設定できます。
• トラフィックポリシー — 送信者の IP、受信者、TLS バージョンに基づいて、接続レベルでフィルタリングします。メッセージ本文を受信する前に評価されます。
• ルールセット — 条件（SPF/DKIM の判定結果、ヘッダー、サイズ、IP）とアクション（アーカイブ、バウンス、リレー、S3、SNS、Lambda、破棄）を使用して、メッセージレベルで処理します。
• SMTP リレー — オプションの認証を使用して、外部 SMTP サーバーにメールを転送します。
• アーカイブ — 非同期の検索とエクスポートが可能な、永続的なメールストレージです。保持期間は 3 か月から無期限まで設定できます。
• アドレスリスト — ルール条件で使用する、管理対象の許可リスト／ブロックリストです。CSV/JSON の一括インポートに対応しています。
• アドオン — ルールセットに追加できる、サードパーティの統合機能（スパムフィルタリング、脅威分析）です。

このスキルを使用する場面

• 受信メール処理パイプラインを設定するとき
• Mail Manager の設定に関する判断を、開発者に手順を追って説明するとき
• メールがシステムに届く前にスパムをフィルタリングしたり、送信者／IP 範囲をブロックしたりするとき
• コンプライアンス、法的保全、eDiscovery のためにメールをアーカイブするとき
• 受信者、送信者、コンテンツに基づいてメールを異なる宛先にルーティングするとき
• オンプレミスまたはサードパーティの SMTP サーバーにメールを転送するとき
• メールフィルタリング用の許可リスト／ブロックリストを作成するとき
• 受信接続に TLS 要件を適用するとき

このスキルでは扱わない内容

• メールの送信 — メールの送信には Amazon SES V2 API（sesv2 クライアント）を使用してください。
• SES のコア機能 — ID 検証、DKIM/SPF/DMARC の設定、設定セット、抑制リストについては、aws-ses スキルを参照してください。
• WorkMail のセットアップ — Mail Manager は WorkMail メールボックスに配信できますが、WorkMail のプロビジョニングは別のサービスです。

よくある間違い（クイックリファレンス）

間違い	修正方法
ses または sesv2 クライアントを使用する	boto3.client('mailmanager') を使用します
先に受信ポイントを作成する	先にトラフィックポリシーとルールセットを作成します
トラフィックポリシーで RecipientCondition を使用する	Attribute: RECIPIENT を指定した StringExpression を使用します
TlsExpression で Values を使用する	TLS 式では単数形の Value を使用します
トラフィックポリシーに DefaultAction がない	常に DefaultAction: ALLOW または DENY を設定します
トラフィックポリシーで SOURCE_IP を使用する	トラフィックポリシーでは SENDER_IP、ルールセットでは SOURCE_IP を使用します
先に取得せずにルールセットを更新する	update_rule_set はすべてのルールを置き換えるため、先に取得します
受信ポイントが ACTIVE になる前に DNS を設定する	Status == ACTIVE になるまで get_ingress_point をポーリングします
DmarcExpression に Evaluate フィールドを指定する	DmarcExpression に Evaluate はありません。Operator と Values のみを指定します
TargetArchive にアーカイブ ARN を指定する	ARN ではなくアーカイブ ID（a-xxxx）を使用します。API により 66 文字の上限が適用されます
CFN の !GetAtt Archive.ArchiveId が ARN を返す	ID を抽出します：!Select [1, !Split ["/", !GetAtt Archive.ArchiveArn]]
ロールバック後にアーカイブ名が重複する	${AWS::AccountId} を追加します。名前は PENDING_DELETION の間も保持されます
FIPS TLS ポリシーを変更できない	FIPS は作成後に変更できません。変更するには削除して再作成します
TLS ポリシーのデフォルトがリージョンによって異なる	米国／カナダでは FIPS、それ以外では REQUIRED です。明示的に設定してください

詳しい説明、条件／アクションの完全な構文、よくある間違いの全リストについては、エージェント向けの手順を参照してください。

リソースリンク

• エージェントへの指示 — ワークフローのパターン、条件／アクションのリファレンス、エージェントへの指示の完全版
• 入門ガイド
• トラフィックポリシーガイド
• ルールセットガイド
• アーカイブガイド
• リレーガイド
• アドレスリストガイド
• クリーンアップガイド
• トラブルシューティングガイド
• セットアップガイドの決定木
• イベント駆動型 AI パイプライン
• SES v2 + Mail Manager API インデックス
• サンプル
• Mail Manager 開発者ガイド
• API リファレンス

概要

このスキルは、AI エージェントが Amazon SES Mail Manager を適切に扱うために必要なコンテキストを提供します。適切な API クライアント、条件／アクションの構文、リソースの依存関係の順序、よくある落とし穴などが含まれます。完全なリファレンスについてはエージェントへの指示から始めるか、対話形式の手順についてはセットアップガイドを利用してください。