更新时间：2022-12-06 GMT+08:00
企业身份注册(带有service)
功能介绍
分布式身份注册方法。在使用该方法前需要先使用openssl工具生成每个用户的私钥和被fabric组织根证书签名的证书(或通过BCS区块链管理界面下载用户证书)。注册时需声明可提供的服务列表。
URI
POST /v1/identity/firm-did
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| orgID | 是 | String | 组织id |
| channelID | 是 | String | 通道id |
| cryptoMethod | 是 | String | 加密方法，目前固定为SW |
| cert | 是 | String | 用户证书，每行末尾均需要增加显式换行符\n |
| sk | 是 | String | 用户私钥，每行末尾均需要增加显式换行符\n |
| timestamp | 是 | String | 时间戳 |
| service | 是 | Array of DIDService objects | 提供的服务 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| type | 是 | String | 类型 |
| serviceEndpoint | 是 | String | 接入点 |
| credentialApplySchema | 否 | CredentialApplySchema object | 申请凭证所需数据的Schema |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| type | 否 | String | 类型 |
| name | 否 | String | 名称 |
| description | 否 | String | 描述信息 |
| attributes | 否 | Array of Attribute objects | 属性列表 |
响应参数
状态码： 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| did | String | 分布式身份标识 |
状态码： 500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errorCode | String | 错误码 最小长度：8 最大长度：36 |
| errorMsg | String | 错误描述 最小长度：2 最大长度：512 |
请求示例
{
"orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198",
"channelID" : "mychannel",
"cryptoMethod" : "SW",
"cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----",
"sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----",
"timestamp" : "2020-10-27T17:28:16+08:00",
"service" : [ {
"type" : "VerifiableCredentialService",
"serviceEndpoint" : "https://example.com/vc/",
"credentialApplySchema" : {
"type" : "file",
"name" : "Test Enterprise Certification",
"description" : "this is test apply info",
"attributes" : [ {
"name" : "bob",
"type" : "string",
"description" : "Attribute's description"
} ]
}
} ]
} 响应示例
状态码： 200
分布式身份标识
{
"did" : "did:example:2THjdfbKMLDVcoYvkiepr9"
} 状态码： 500
失败响应
{
"errorCode" : "BCS.5002033",
"errorMsg" : "Service Type and ServiceEndpoint Can not Null"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 分布式身份标识 |
| 500 | 失败响应 |
错误码
请参见错误码。
父主题： 分布式身份(DID)管理
