# AS2 对接实施手册

> 适用于亚马逊 Vendor、沃尔玛、家得宝等强制 AS2 的买方。
> AS2 与 HTTPS 是两层：HTTPS 保护传输链路，AS2 的 S/MIME 保护报文本身（签名 + 加密 + 防抵赖）。

## 1. 核心概念

| 概念 | 说明 |
|---|---|
| AS2 Identifier | 双方约定的标识，放在 `AS2-From` / `AS2-To` 头 |
| 我方私钥 | 用于签名出站报文、解密入站报文 |
| 对方公钥 | 用于加密出站报文、验签入站报文 |
| MDN | 报文处置通知，买方确认收到的凭证 |
| 同步 MDN | 在 HTTP 响应体内直接返回，最常见 |
| 异步 MDN | 买方另发一条 POST 回来，适合大报文 |
| Signed MDN | MDN 本身带签名，多数零售买方要求 |

## 2. 报文关键头字段

```
POST /as2 HTTP/1.1
Host: edi.example.com
AS2-From: VEEKE_PROD
AS2-To: BUYER_AS2_ID
AS2-Version: 1.2
Message-ID: <20261116-143000-001@veeke>
Subject: EDI Message
Content-Type: application/pkcs7-mime; smime-type=enveloped-data; name=smime.p7m
Disposition-Notification-To: VEEKE_PROD
Disposition-Notification-Options: signed-receipt-protocol=optional, pkcs7-signature; signed-receipt-micalg=sha-256
```

要点：
- `AS2-To` / `AS2-From` 区分大小写，必须与买方配置完全一致。
- `Message-ID` 全局唯一，重发时是否复用由买方要求决定（多数要求复用）。
- `Disposition-Notification-Options` 决定 MDN 是否签名与摘要算法。

## 3. 对接步骤

1. 双方交换 AS2 ID、接收 URL、公钥证书
2. 确认签名算法（SHA-256 或 SHA-1）、加密算法（3DES / AES-128 / AES-256）
3. 确认 MDN 类型（同步 / 异步、是否签名）
4. 发送一条最小测试报文，确认验签、解密、MDN 正常
5. 按报文类型逐条联调业务单据
6. 买方验收通过后切换生产

## 4. 证书生成（OpenSSL）

```bash
# 生成私钥与自签证书（有效期 2 年）
openssl req -newkey rsa:2048 -nodes \
  -keyout veeke-as2.key -x509 -days 730 -out veeke-as2.cer \
  -subj "/CN=VEEKE EDI/OU=IT/O=VEEKE Micro Network/L=Ningbo/C=CN"

# 导出 PEM 格式公钥证书（发给买方）
openssl x509 -in veeke-as2.cer -outform PEM -out veeke-as2-public.pem

# 校验证书主体与有效期
openssl x509 -in veeke-as2.cer -noout -subject -dates
```

注意：
- 私钥绝不能提交到 Git、打进镜像或写进配置文件。
- 买方若要求完整证书链，需一并提供中间证书。
- 部分买方不接受自签证书，需使用商用 CA 签发。

## 5. 常见问题

| 现象 | 常见原因 |
|---|---|
| 401 / 403 | AS2 ID 不匹配、IP 不在白名单、URL 路径错误 |
| 验签失败 | 签名算法不一致、证书不匹配、报文被中间件改写 |
| 解密失败 | 用了错误的公钥加密、算法不支持 |
| 一直无 MDN | 出口 IP 被拦、`Disposition-Notification-To` 缺失、MDN 签名算法不兼容 |
| 收到 MDN 但判定失败 | 报文业务校验不通过（看 997 的 AK4） |
| 重发被判重复 | Message-ID 复用策略与买方要求不一致 |

## 6. 证书轮换

1. 提前 30 天生成新证书并发送给买方
2. 买方并行配置新旧证书
3. 我方切换默认签名证书
4. 观察 1–2 周，确认无验签失败
5. 旧证书到期后下线

## 7. 上线检查

- [ ] AS2 ID、URL、证书三项双方互相确认
- [ ] 签名 / 加密 / MDN 算法一致
- [ ] 双向测试报文各至少 1 条成功
- [ ] 出口 IP 已在买方白名单
- [ ] 证书到期提醒已配置
- [ ] 报文与 MDN 已归档
