Eclipse EDC Connector 中 DID 文档上下文规范的修正

Eclipse EDC Connector 中 DID 文档上下文规范的修正

Connector EDC core services including data plane and control plane 项目地址: https://gitcode.com/gh_mirrors/con/Connector

在分布式身份标识领域，DID（Decentralized Identifier）作为核心基础设施，其文档格式的规范性直接影响着系统的互操作性。近期在 Eclipse EDC Connector 项目中发现了一个关于 DID 文档上下文（context）规范的实现问题，值得开发者关注。

问题背景

DID 文档作为描述去中心化身份的核心数据结构，其上下文定义决定了文档中各字段的语义。根据 W3C 的 DID 核心规范，标准的 DID 文档应当使用 https://www.w3.org/ns/did/v1 作为主要上下文。然而在 Eclipse EDC Connector 0.10.0-SNAPSHOT 版本中，实现代码错误地使用了 https://w3id.org/did-resolution/v1 这一上下文。

技术分析

这两个上下文实际上服务于不同的规范场景：

1. DID 核心规范上下文：用于定义 DID 文档本身的结构和语义，包括验证方法（verificationMethod）、服务端点（service）等核心元素。

2. DID 解析规范上下文：用于 DID 解析过程中返回的元数据，包含解析结果、文档元数据等信息，不应直接用作 DID 文档的上下文。

在 Identity Hub 的实现中，当通过 did:web 方法解析 DID 文档时，返回的文档错误地采用了解析规范上下文，这会导致：

• 客户端可能无法正确解析 DID 文档结构
• 与其他 DID 实现系统的互操作性问题
• 不符合 W3C 标准规范要求

解决方案

该问题已在最新代码中得到修正，主要变更包括：

1. 将 DidDocument 类中的默认上下文更新为标准 DID 上下文
2. 确保所有 DID 文档生成逻辑遵循核心规范

对于使用 EDC Connector 的开发者，建议：

• 升级到包含修复的版本
• 检查现有系统是否依赖了错误的上下文定义
• 在自定义 DID 实现时严格区分文档上下文和解析上下文

总结

DID 技术的标准化进程仍在发展中，实现时需特别注意不同规范间的界限。这个案例提醒我们，在实现身份相关协议时，必须严格遵循标准定义，特别是在上下文这种基础性元素上，微小的差异可能导致整个系统的互操作性问题。EDC Connector 项目对此问题的快速响应也体现了开源社区对标准合规性的重视。

Connector EDC core services including data plane and control plane 项目地址: https://gitcode.com/gh_mirrors/con/Connector