3.BID文档

BID文档就是用于描述身份详细信息的文档，一个BID标识符关联到一个BID文档。BID标识符具体解析为BID文档，BID文档内包括BID标识符和公钥详细信息(持有者、加密算法、密钥状态等)，以及BID持有者的其他非隐私属性描述等。

3.1 规范

BID的协议元数据为BID文档。BID文档遵循DID Document规范，并在之基础上做了一定的扩展。BID文档字段说明如下：

  • @context：必填字段。一组解释JSON-LD文档的规则,遵循DID规范，用于实现不同DID Document的互操作，必须包含 https://www.w3.org/ns/did/v1。

  • version：必填字段。文档的版本号，用于文档的版本升级。

  • id：必填字段。文档的BID。

  • publicKey：选填字段。一组公钥，包含id，type，controller,publicKeyHex四个字段，凭证类的BID文档不包含该字段。

    • id:公钥的ID。

    • type：字符串，代表公钥的加密算法类型，具体支持的类型见附录公钥类型章节。

    • controller：一个BID,表明此公钥的归属。

    • publicKeyHex：公钥的十六进制编码。

  • authentication：必填字段。一组公钥的BID，表名此BID的归属，拥有此公钥对应私钥的一方可以控制和管理此BID文档。

  • alsoKnownAs。选填字段。一组和本BID关联的其他ID, 包括type和id两个字段。

    • type:关联标识的类型,取值详见附录关联标识类型。

    • id:关联的标识。

  • extension：BID扩展字段。包含如下字段：

    • recovery：选填字段。一组公钥id, 在authentication 私钥泄漏或者丢失的情况下用来恢复对文档的控制权。

    • ttl: 必填字段。Time-To-Live，即如果解析使用缓存的话缓存生效的时间，单位秒。

    • delegateSign: 选填字段。第三方对publicKey的签名，可信解析使用。包括：signer和signatureValue。

      • signer ：签名者，这里是一个公钥的id。

      • signatureValue: 使用相应私钥对publicKey字段的签名。

    • type: 必填字段。BID文档的属性类型，取值见附录属性类型。

  • attributes: 必填字段。一组属性，属性为如下结构：

    字段名

    描述

    key

    属性的关键字

    desc

    选填。属性描述

    encrypt

    选填。是否加密，0非加密，1加密

    format

    选填。image、text、video、mixture等数据类型

    value

    选填。属性自定义value

  • acsns:选填字段。一组子链AC号，只有BID文档类型不是凭证类型且文档是主链上的BID文档才可能有该字段，存放当前BID拥有的所有AC号。

  • verifiableCredentials:选填字段。凭证列表，包含id和type两个字段。

    • id:可验证声明的BID。

    • type：凭证类型。详见附录凭证类型。

  • service：选填字段。一组服务地址，包括id，type，serviceEndpoint三个必填字段。

    • id: 服务地址的ID。

    • type：字符串，代表服务的类型。取值见附录服务类型。

    • serviceEndpoint：一个URI地址。

      当type为子链解析服务时， service为以下结构：

      字段名

      描述

      id

      服务地址的ID

      type

      DIDSubResolver

      version

      服务支持的BID解析协议版本

      protocol

      解析协议支持的传输协议类型, 具体取值见附录解析服务协议类型

      serverType

      服务地址类型，0为域名形式，1为IP地址形式

      serviceEndpoint

      解析地址的IP或域名

      port

      serverType为1时有该字段，解析服务的端口号

  • created：必填字段。创建时间。

  • updated：必填字段。上次的更新时间。

  • proof：选填字段。文档所有者对文档内容的签名，包括：creator和signatureValue。

    • creator：proof的创建者，这里是一个公钥的id。

    • signatureValue：使用相应私钥对除proof字段的整个BID文档签名。

3.2 元数据示例

{
	"@context": ["https://www.w3.org/ns/did/v1"],
	"version": "1.0.0",
	"id": "did:bid:efnVUgqQFfYeu97ABf6sGm3WFtVXHZB2",
	"publicKey": [{
		"id": "did:bid:efnVUgqQFfYeu97ABf6sGm3WFtVXHZB2#key-1",
		"type": "Ed25519",
		"controller": "did:bid:efnVUgqQFfYeu97ABf6sGm3WFtVXHZB2",
		"publicKeyHex": "b9906e1b50e81501369cc777979f8bcf27bd1917d794fa6d5e320b1ccc4f48bb"
	}, {
		"id": "did:bid:efnVUgqQFfYeu97ABf6sGm3WFtVXHZB2#key-2",
		"type": "Ed25519",
		"controller": "did:bid:efnVUgqQFfYeu97ABf6sGm3WFtVXHZB2",
		"publicKeyHex": "31c7fc771eba5b511b7231e9b291835dd4ebde51cc0e757a84464e7582aba652"
	}],
	"authentication": ["did:bid:efnVUgqQFfYeu97ABf6sGm3WFtVXHZB2#key-1"],
	"extension": {
		"recovery": ["did:bid:efnVUgqQFfYeu97ABf6sGm3WFtVXHZB2#key-2"],
		"ttl": 86400,
		"delegateSign ": {
			"signer": "did:bid:efJgt44mNDewKK1VEN454R17cjso3mSG#key-1",
			"signatureValue": "eyJhbGciOiJSUzI1NiIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19"
		},
		"type": 206
	},
	"service": [{
		"id": "did:bid:ef24NBA7au48UTZrUNRHj2p3bnRzF3YCH#subResolve",
		"type": "DIDSubResolve",
		"version": "1.0.0",
		"serverType": 1,
		"protocol": 3,
		"serviceEndpoint": "192.168.1.23",
		"port": 8080
	}],
	"created": "2021-05-10T06:23:38Z",
	"updated": "2021-05-10T06:23:38Z",
	"proof": {
		"creator": "did:bid:efJgt44mNDewKK1VEN454R17cjso3mSG#key-1",
		"signatureValue": "9E07CD62FE6CE0A843497EBD045C0AE9FD6E1845414D0ED251622C66D9CC927CC21DB9C09DFF628DC042FCBB7D8B2B4901E7DA9774C20065202B76D4B1C15900"
	}
}