随着Catena-X网络的扩展,大量数据资产将通过EDC连接技术提供。在网络中有效地识别正确的EDC端点可能很困难。
为了符合GAIA-X标准,每个EDC端点必须提供ServiceOffering类型的自我描述(SD)。基于这些SD,必须提供数据和服务发现服务,以便轻松查找合适的EDC实例,从而高效地查询数据产品。
- 参与者不希望他们的个人信息被公开。因此,这些只能间接搜索,这需要知道或确定应从谁那里获得数据。
- 因为没有人想检查每个EDC实例(网络负载、延迟随着参与者数量的增加而变得越来越大,程序因此无法扩展)。因此,请求的EDC实例的数量必须由合适的过滤器限制。
目前,EDC Discovery API仅限于根据提供数据和服务的BPN编号筛选合适的EDC实例。本文档描述了运营公司将创建的相关API端点,以便能够根据支持的标准(目前在BPN编号上)发现EDC。
EDC Discovery API用于搜索和查找服务和数据产品
1 注册EDC到联邦目录中
两个连接器都必须在提供可验证凭据(VC)的身份提供者中注册,以通过托管身份钱包(MIW)等证明其身份。
任何数据提供者都可以注册资产并将其公开给元数据代理(Federated Catalog),供其他消费连接器查找。
对于注册,提供EDC实例的法人类型(LegalPerson)和服务产品类型(ServiceOffering)的自我描述必须在联合目录中注册。
通过EDC发现服务,可以通过BPN号查询EDC实例,BPN号是SD工件的一部分。
最后,消费者可以从供应商那里获得合同报价并开始合同谈判。
联合目录将是SD的存储,和EDC发现服务的存储,查询API以检索感兴趣的EDC实例的URL。
核心服务不再提供中心数字孪生注册表(DTR),而是隐藏在数据提供EDC后面的分散实例(DDTR)。因此,任何消费者都必须识别提供EDC的用户,才能访问该EDC后面的DDTR。
业务伙伴编号(BPN)
BPN是Catena-X中合作伙伴的唯一标识符。
自我描述(SD)
Gaia-X要求所有提供商使用称为自我描述的标准化机器可读元数据来描述自己及其服务产品。例如,此类自我描述将包括公司地址、特定服务描述或证书和标签等信息。
2 EDC Discovery API
EDC发现服务必须由核心服务提供商作为中央可用端点提供。
在网络中注册的每个EDC都必须在EDC发现服务中注册。
Endpoint: POST: /api/administration/connectors/discovery
请求正文
请求体可以保持为空(以检索已注册连接器的完整列表),也可以填充一个或多个BPN以检索给定BPN的已注册EDC端点列表。
*\[*
*"BPNL\...\...",*
*"BPNL\...."*
*\]*
响应结构
\[
{
"bpn : "BPNL\...\..."
"connectorEndpoint":
\[
"http://some.example.url",
"http://some.other-example.url"
\]
},
{
"bpn : "BPNL\...\..."
"connectorEndpoint": "http://some.example.url"
}
\]
对于每个bpn,都提供了一个自己的响应对象。如果一个bpn有多个EDC实例,则返回一个数组(第一个结果集),否则返回一个值(第二个结果集
CX-0001 EDC Discovery API v1.0.2 | Catena-X - LibraryABSTRACThttps://catenax-ev.github.io/docs/next/standards/CX-0001-EDCDiscoveryAPI