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 范围
• 为合规、法律保留或电子取证归档邮件
• 根据收件人、发件人或内容将邮件路由到不同目的地
• 将邮件转发到本地或第三方 SMTP 服务
• 构建用于邮件筛选的允许/阻止列表
• 强制要求入站连接使用 TLS

此技能不涵盖的内容

• 发送出站邮件 — 使用 Amazon SES V2 API（sesv2 客户端）发送邮件。
• SES 核心功能 — 身份验证、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	轮询 get_ingress_point，直到 Status == ACTIVE
在 DmarcExpression 中使用 Evaluate 字段	DmarcExpression 不包含 Evaluate——只需使用 Operator 和 Values
在 TargetArchive 中使用归档 ARN	使用归档 ID（a-xxxx），而不是 ARN——API 强制执行 66 个字符的限制
CFN !GetAtt Archive.ArchiveId 返回 ARN	提取 ID：!Select [1, !Split ["/", !GetAtt Archive.ArchiveArn]]
回滚后归档名称冲突	追加 ${AWS::AccountId}——名称在 PENDING_DELETION 期间仍会保留
无法更改 FIPS TLS 策略	创建后 FIPS 不可变——如需更改，请删除并重新创建
TLS 策略默认值因区域而异	美国/加拿大为 FIPS，其他地区为 REQUIRED——请显式设置

有关详细说明、完整的条件/操作语法以及完整的常见错误列表，请参阅Agent 说明。

资源链接

• Agent 指南 — 完整的工作流模式、条件/操作参考和 Agent 指南
• 入门指南
• 流量策略指南
• 规则集指南
• 归档指南
• 中继指南
• 地址列表指南
• 清理指南
• 故障排除指南
• 引导式设置决策树
• 事件驱动型 AI 流水线
• SES v2 + Mail Manager API 索引
• 示例
• Mail Manager 开发者指南
• API 参考

摘要

此技能提供 AI Agent 正确使用 Amazon SES Mail Manager 所需的上下文，包括正确的 API 客户端、条件/操作语法、资源依赖顺序和常见问题。完整参考请从 Agent 指南开始；如需交互式演练，请使用引导式设置。