功能弃用通知：Webhook 签名算法 v1（HMAC-SHA1，X-Signature）

弃用功能基本信息

• 功能名称：Webhook 签名算法 v1（HMAC-SHA1，请求头：X-Signature）
• 起始弃用版本：2025.2（自该版本起标记为弃用）
• 最终移除版本：2026.1
• 替代方案：Webhook 验签 v2（HMAC-SHA256 + 时间戳与随机数）
  • 新增请求头：X-Signature-256、X-Timestamp、X-Nonce
  • 支持资源：在线校验工具、SDK（Node/Java/Go）、沙箱环境事件回放、控制台双签名灰度与回滚开关
• 适用范围：所有接收平台 Webhook 回调并基于 v1 进行验签的集成

弃用原因说明

• 安全与合规：
  • SHA-1 已被广泛认定为弱哈希算法，存在碰撞与降级风险，无法满足当前安全与合规要求。
• 重放风险：
  • v1 仅单一签名头部，缺少时间戳与随机数，易受重放攻击。
• 实现一致性问题：
  • 旧版在多语言实现上存在差异，导致验签偶发失败，增加排障与运维成本。

影响分析

• 对接收方系统（您的服务）：
  • 需要升级验签逻辑以支持 v2（HMAC-SHA256 + 时间戳/随机数）。
  • 网络设备与中间件需透传新增请求头 X-Signature-256、X-Timestamp、X-Nonce（如 API 网关/WAF/反向代理/负载均衡）。
  • 需要具备时钟同步与重放防护（基于时间戳与 nonce）的能力。
  • 日志、监控与告警规则需更新以适配 v2 字段。
  • 未在 2026.1 前完成迁移，届时将无法通过验签，可能导致回调处理失败。
• 对使用官方 SDK 的集成：
  • 需升级至提供 v2 的 SDK（Node/Java/Go）。
• 在弃用过渡期内：
  • 控制台支持双签名灰度与回滚开关，可同时附带 v1 与 v2 以便平滑迁移；最终仅保留 v2。

迁移指南

• 前置准备
  • 阅读并遵循《Webhook v2 签名规范》（签名串规范、校验流程、字段语义与合法性检查以该文档为准）。
  • 确认并安全管理 Webhook 密钥（secret）。
  • 配置网关/WAF/代理放行与透传 X-Signature-256、X-Timestamp、X-Nonce。
  • 确保服务时钟与可信时间源同步（例如启用可靠的 NTP 同步）。
  • 预置重放防护与幂等：
    • 按文档要求校验时间戳有效性。
    • 缓存并校验 nonce，拒绝在有效期内重复使用的 nonce。
• 实施步骤
  • 在接收端实现 v2 验签：
    • 按文档规范构造签名串，使用 HMAC-SHA256 生成/校验签名，对比 X-Signature-256。
    • 同时校验 X-Timestamp 与 X-Nonce 的有效性与唯一性。
    • 采用常量时间比较防止计时侧信道。
  • 启用双签名灰度：
    • 在控制台开启双签名，接收端同时记录 v1 与 v2 的校验结果，比较一致性并定位差异。
  • 逐步切换策略：
    • 先在非核心环境或小流量下以 v2 为准（v1 兼容）。
    • 观察一段稳定期后，在全量环境切换为“仅 v2 验签”。
  • 清理与固化：
    • 完成迁移后，更新内部对接文档、运行手册与监控看板，移除对 v1 的依赖。
• 测试与验证
  • 使用在线校验工具核对签名实现正确性。
  • 在沙箱环境回放典型与边界场景事件，确认业务处理与签名校验一致。
  • 覆盖重点与边界：
    • 大体积/特殊字符负载、压缩或分块传输、网络重试与重复投递、时钟偏移、代理改写或剥离头部。
• 回滚与应急
  • 如遇故障，可通过控制台回滚开关临时恢复以 v1 为准，快速止血。
  • 在 2026.1 前保留 v1 实现以便必要时回退；完成问题定位后尽快恢复 v2 为准。

时间节点

• 弃用开始：版本 2025.2（自该版本起 v1 标记为弃用）
• 过渡期：自 2025.2 起至 2026.1（提供双签名灰度与迁移支持）
• 最终移除：版本 2026.1（不再提供 v1；Webhook 仅包含 v2 相关请求头）

联系方式

• 如需技术支持与迁移咨询，请通过既有支持渠道联系您对接的客户成功/技术支持团队。
• 提交问题时建议附上：请求时间、回调目标地址、相关请求头与响应码、验签日志节选（去除敏感信息），以便快速定位。

弃用通知｜内嵌地图 SDK v2（旧矢量引擎）

弃用功能基本信息

• 功能名称：内嵌地图 SDK v2（旧矢量引擎）
• 版本信息：自 6.5.0 起标记为弃用（Deprecated）
• 弃用生效：自 6.5.0 发布起生效
• 最终移除版本：7.0.0

弃用原因说明

• 上游矢量渲染引擎已停止维护：在最新移动操作系统上已出现渲染异常与崩溃风险，影响稳定性与可用性。
• 合规能力不足：v2 不支持可配置的隐私弹窗与精确/模糊定位切换，无法满足最新监管与应用商店上架要求。
• 资源格式陈旧：v2 地图瓦片与离线包格式过时，导致加载性能受限与流量成本偏高，不利于持续优化。

影响分析

• 稳定性风险：继续使用 v2 的应用在新系统版本上可能出现地图渲染异常、闪退或不可预期的显示问题。
• 合规风险：无法满足隐私合规（可配置隐私弹窗）与定位合规（精确/模糊定位切换）要求，存在审核或上架阻碍。
• 性能与成本：旧瓦片与离线包格式带来加载时延与较高流量开销。
• 兼容性变更：
  • v2 的离线包与样式格式与 v3 不兼容，需完成转换。
  • v2 API 在 7.0.0 将被移除，届时相关接口调用将编译失败或运行异常。
• 迁移与发布：提供 v2/v3 并行渲染能力，便于灰度发布与逐步切换；控制台支持生成新密钥并配置域名白名单，降低切换风险。

迁移指南

请迁移至“地图组件 v3（WebGL 渲染）”。推荐按照以下步骤执行：

1. 迁移前准备

• 清点 v2 依赖与使用面：包含地图初始化、图层/样式、标注与覆盖物、交互事件、定位与权限、离线包使用场景。
• 锁定待迁移分支与目标版本范围，评估与其他大变更的合并节奏，降低交叉风险。

2. 升级与依赖调整

• 将项目依赖更新为地图组件 v3。
• 在控制台生成 v3 新密钥并配置域名白名单；在应用配置中接入新密钥（可与旧密钥并存以便灰度）。

3. API 与事件迁移

• 使用提供的“API 映射”和“常见事件对照表”替换 v2 API 调用和事件绑定。
• 运行项目内置迁移脚本，完成基础调用替换与代码标注；对无法自动替换的接口人工确认与适配。

4. 样式与资源转换

• 使用样式转换器将 v2 样式/主题转换为 v3 兼容格式。
• 将离线资源升级为“离线包 v3”，并替换打包与加载流程；原有 v2 离线包不可直接复用。

5. 合规能力接入

• 启用并配置 v3 的可配置隐私弹窗组件（文本、触发时机、二次确认策略等按需设置）。
• 按最新规定接入精确/模糊定位切换能力，并在相关业务流程中正确传递与存储定位精度状态。

6. 能力优化与体验完善

• 按需加载：启用按需加载以减少首屏时延与资源消耗。
• 主题与易用性：开启暗色模式支持并按设计规范调整颜色与对比度；开启无障碍支持（焦点顺序、朗读标签、缩放手势等）。

7. 并行验证与灰度

• 启用 v2/v3 并行渲染能力，在测试环境及小流量用户群体进行对比验证（渲染一致性、交互事件、性能与流量消耗）。
• 建立监控指标：启动崩溃率、渲染耗时、网络流量、离线命中率、用户回退率；按指标逐步扩大 v3 覆盖面。

8. 回滚与收敛

• 灰度期间保留 v2 渲染路径作为应急回退选项；当关键缺陷出现时可临时切回 v2。
• 在完成场景覆盖与指标达标后，关闭 v2 路径并合并为 v3 单一路径。注意：7.0.0 起将无法再回退至 v2。

9. 交付与检查清单

• 代码与配置：依赖变更说明、API 替换清单、样式转换报告、离线包 v3 打包与加载配置。
• 合规材料：隐私弹窗配置与截图、定位精度切换流程说明。
• 发布验证：主要业务路径回归、性能与流量对比、关键机型与最新系统版本专项测试、崩溃与异常日志复核。

时间节点

• 自 6.5.0 起：内嵌地图 SDK v2 标记为弃用；提供迁移脚本、样式转换器与 API/事件对照表；控制台支持生成 v3 新密钥并配置域名白名单；支持 v2/v3 并行渲染用于灰度发布。
• 7.0.0：内嵌地图 SDK v2 完全移除。届时 v2 API、旧样式与离线包格式将不可用，必须完成迁移至 v3。

提示：请在 7.0.0 发布前完成全部迁移与验证，以避免构建失败或运行时异常。

联系方式

• 技术支持：请通过控制台“支持中心/工单”提交问题，或联系贵方对接的技术支持渠道。
• 技术咨询：如需 API 映射表、事件对照表、迁移脚本与样式转换器的获取与使用指导，请在工单中注明“地图组件 v3 迁移”。
• 紧急问题：请通过既有企业支持渠道（如客户成功/账户经理/服务群）进行升级沟通。

如对本次弃用有疑问或需要迁移协助，请及时与我们联系。我们将持续在版本发布说明中同步进展与已知问题。