feat(protocol): enforce X-Fabric-Version negotiation on node registration
This commit is contained in:
@@ -66,7 +66,7 @@
|
||||
- [x] 鉴权方案定稿(node token / HMAC)
|
||||
- [x] 注册握手协议文档化
|
||||
- [x] 错误码与重试策略统一
|
||||
- [ ] 版本协商(`X-Fabric-Version`)
|
||||
- [x] 版本协商(`X-Fabric-Version`)
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -21,6 +21,7 @@
|
||||
```
|
||||
|
||||
### Required Headers
|
||||
- `X-Fabric-Version`: 协议版本,当前固定为 `1`
|
||||
- `X-Fabric-Timestamp`: ISO8601 UTC 时间(如 `2026-05-12T11:00:00.000Z`)
|
||||
- `X-Fabric-Nonce`: 随机字符串(建议 UUID)
|
||||
- `X-Fabric-Signature`: HMAC-SHA256 十六进制串
|
||||
@@ -84,7 +85,10 @@ signature = HMAC_SHA256_HEX(CENTER_SHARED_SECRET, canonicalString)
|
||||
## 7. 版本协商(预留)
|
||||
当前版本:`v1`
|
||||
|
||||
后续建议在请求头增加:
|
||||
当前实现要求请求头:
|
||||
- `X-Fabric-Version: 1`
|
||||
|
||||
以支持协议平滑升级。
|
||||
若版本不匹配,Center 返回:
|
||||
- `400`
|
||||
- `error.code = FABRIC_VERSION_NOT_SUPPORTED`
|
||||
- `supportedVersion = "1"`
|
||||
|
||||
Reference in New Issue
Block a user