跳到主要内容

轮换 ACME EAB 凭据

轮换证书的 ACME EAB 凭据。

轮换后旧凭据立即失效，已使用旧凭据注册的 ACME 客户端需用新凭据重新注册。 响应返回新的 eab_kid 和 eab_mac_key，请立即保存。

旧凭据立即失效

轮换成功后，旧 eab_kid 和 eab_hmac_key 立即失效，所有使用旧凭据注册的 ACME 客户端将无法继续申请或续期证书。请确保在轮换后及时更新所有客户端配置。

接口地址

POST /api/v1/certificate/acme/eab-rotate

Host: 
...

完整地址

/api/v1/certificate/acme/eab-rotate

请求​

Content-Type: application/json
Content-Length: 24

{
  "service_id": "J94V73" // 证书编号，必填，下单时候返回的 `service_id`
}

响应​

HTTP/1.1 200 OK

Content-Type: application/json

{
  "success": true,
  "data": {
    "order_id": "TA-xxxxx",       // CA 侧订单号
    "directory": "https://acme.ca.example/directory", // ACME 目录地址
    "eab_kid": "eab-key-new-xxxxx", // 新的 EAB Key Identifier
    "eab_mac_key": "new-hmac-key-xxxxx", // 新的 HMAC Key（仅本次返回）
    "existing": false,            // 轮换后固定为 false
    "white_ips": []               // 当前 IP 白名单（轮换后重置为空）
  }
}
HMAC Key 仅本次返回

eab_mac_key 仅在轮换时返回一次，后续无法再次获取。 请立即保存到安全的位置，丢失后只能再次轮换获取新的凭据。

错误码​

HTTP 状态码message含义与处理建议
400该证书不支持 ACME EAB证书供应商无法轮换 EAB 凭据
400当前证书尚未创建 ACME EAB，无法轮换尚未创建 EAB 凭据，请先调用创建 EAB 凭据
404The certificate is not found证书不存在，或不属于当前 API 密钥对应的工作空间
422The service ID is required未提供证书编号 service_id

后续步骤​

轮换成功后，使用新的 eab_kid 和 eab_mac_key 在 ACME 客户端中重新注册账户：

# acme.sh 示例
acme.sh --register-account -m my@example.com \
  --server https://acme.ca.example/directory \
  --eab-kid "eab-key-new-xxxxx" \
  --eab-hmac-key "new-hmac-key-xxxxx"