spring-boot服务方式使用¶
整体介绍¶
使用 spring-boot 方式，weid-sample 程序将作为一个后台进程运行，您可以使用 http 方式体验交互流程。
1. 下载源码¶
git clone https://github.com/WeBankBlockchain/weid-sample.git
2. 配置与部署¶
2.1 部署 weid-java-sdk 与配置基本信息¶
安装部署 weid-java-sdk
weid-sample 需要依赖 weid-java-sdk，您需要参考WeIdentity JAVA SDK安装部署完成 weid-java-sdk 的安装部署，并参照Java应用集成章节完成 weid-sample 的配置。
配置 Committee Member 私钥
将您在部署WeIdentity智能合约阶段生成的私钥文件拷贝至
weid-sample/keys/priv/目录中，此私钥后续将用于注册 Authority Issuer，weid-sample 会自动加载。
注解
此项配置并非必要，注册 Authority Issuer 需要委员会机构成员（ Committee Member ）权限，发布智能合约时生成的公私钥对会自动成为委员会机构成员，若您不是发布智能合约的机构，您无需关注此配置项。 若您是智能合约发布的机构，您可以参考以下进行配置：
2.2 基本流程的演示¶
2.2.1 编译和运行¶
编译 weid-sample
cd weid-sample
chmod +x *.sh
./build.sh
启动 weid-sample 服务:
./start.sh
若启动成功，则会打印以下信息：
[main] INFO AnnotationMBeanExporter() - Registering beans for JMX exposure on startup
[main] INFO Http11NioProtocol() - Initializing ProtocolHandler ["https-jsse-nio-6101"]
[main] INFO Http11NioProtocol() - Starting ProtocolHandler ["https-jsse-nio-6100"]
[main] INFO NioSelectorPool() - Using a shared selector for servlet write/read
[main] INFO Http11NioProtocol() - Initializing ProtocolHandler ["http-nio-6101"]
[main] INFO NioSelectorPool() - Using a shared selector for servlet write/read
[main] INFO Http11NioProtocol() - Starting ProtocolHandler ["http-nio-6101"]
[main] INFO TomcatEmbeddedServletContainer() - Tomcat started on port(s): 6100 (https) 6101 (http)
[main] INFO SampleApp() - Started SampleApp in 3.588 seconds (JVM running for 4.294)
2.2.2 流程演示¶
以下将为您演示
假设您的服务部署在本地，地址是 127.0.0.1，服务端口是 6101。您可以在 src/main/resources 里修改端口信息。
创建 WeID
curl -l -H "Content-type: application/json" -X POST http://127.0.0.1:6101/createWeId
若调用成功，则会打印以下信息：
{
"result":{
"weId":"did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24",
"userWeIdPublicKey":{
"publicKey":"3170902924087212850995053706205512080445198963430287429721846825598988998466716040533782467342119206581749393570668868631792331397183368695050591746049552"
},
"userWeIdPrivateKey":null
},
"errorCode":0,
"errorMessage":"success",
"transactionInfo":{
"blockNumber":60643,
"transactionHash":"0xc73b7ba6af39614761423dc8fcbbbc7e5f24c82e8187bc467cf0398b4ce4330b",
"transactionIndex":0
}
}
表明创建的 WeID 是 did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24。
注册 Authority Issuer
curl -l -H "Content-type: application/json" -X POST -d '{"issuer":"did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24","org-id":"webank"}'
http://127.0.0.1:6101/registerAuthorityIssuer
运行成功，则会打印以下信息：
{
"result":true,
"errorCode":0,
"errorMessage":"success",
"transactionInfo":{
"blockNumber":60668,
"transactionHash":"0xa0b84473705da2679cfec9119e2cdef03175df0f1af676e0579d5809e4e8d6cd",
"transactionIndex":0
}
}
注册 CPT
curl -l -H "Content-type: application/json" -X POST -d '{"publisher": "did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24",
"claim": {"properties": {"id":{"type":"string","description":"user weid"},"name":{"type":"string","description":"user name"},"gender":{"type":"string","description":"user gender"}}}}'
http://127.0.0.1:6101/registCpt
运行成功，则会打印以下信息：
{
"result":{
"cptId":1189,
"cptVersion":1
},
"errorCode":0,
"errorMessage":"success",
"transactionInfo":{
"blockNumber":60676,
"transactionHash":"0x72d55eb1d020acd09b115177a46e230ffdb0177ab5dd74e16765d79338522093",
"transactionIndex":0
}
}
表明注册 CPT 成功，CPT ID 为 1189。
创建 Credential
创建 Credential 依赖于具体的 CPT，参数里的 cptId 传入刚刚注册的 CPT 的 ID：
curl -l -H "Content-type: application/json" -X POST -d
'{"cptId": "1189","issuer": "did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24",
"claimData": {"id":"did:weid:101:0xf36fb2308d36bb94c579f568bdf670743d949deb","name":"zhangsan","gender":"F"}}'
http://127.0.0.1:6101/createCredential
若运行成功，则会打印以下信息：
{
"result":{
"credential":{
"context":"https://github.com/WeBankBlockchain/WeIdentity/blob/master/context/v1",
"id":"e4f4accd-6026-4fd0-9392-1379ddd4f778",
"cptId":1189,
"issuer":"did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24",
"issuanceDate":1564371227764,
"expirationDate":1595475227763,
"claim":{
"gender":"F",
"name":"zhangsan",
"id":"did:weid:101:0xf36fb2308d36bb94c579f568bdf670743d949deb"
},
"proof":{
"creator":"did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24",
"signature":"G2kD4u4jrnmYbq/oVl9idmTEQzP3a0KEomHGJaVpWzhITIE+dDYSRMyF9TDy+jPANpYRJGg7pGnANM+QeJ9Ba00=",
"created":"1564371227764",
"type":"EcdsaSignature"
},
"signature":"G2kD4u4jrnmYbq/oVl9idmTEQzP3a0KEomHGJaVpWzhITIE+dDYSRMyF9TDy+jPANpYRJGg7pGnANM+QeJ9Ba00=",
"proofType":"EcdsaSignature"
},
"disclosure":{
"name":1,
"id":1,
"gender":1
}
},
"errorCode":0,
"errorMessage":"success",
"transactionInfo":null
}
表明创建 Credential 成功，Credential 的具体信息为输出中的 Credential 字段对应的内容。
验证 Credential
curl -l -H "Content-type: application/json" -X POST -d
'{"context":"https://github.com/WeBankBlockchain/WeIdentity/blob/master/context/v1",
"id":"e4f4accd-6026-4fd0-9392-1379ddd4f778","cptId":1189,"issuer":"did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24",
"issuanceDate":1564371227764,"expirationDate":1595475227763,"claim":{"gender":"F","name":"zhangsan","id":"did:weid:101:0xf36fb2308d36bb94c579f568bdf670743d949deb"},
"proof":{"creator":"did:weid:101:0xd613fbc0249f2ce5088ed484fa6b7b51ecb95e24","signature":"G2kD4u4jrnmYbq/oVl9idmTEQzP3a0KEomHGJaVpWzhITIE+dDYSRMyF9TDy+jPANpYRJGg7pGnANM+QeJ9Ba00=",
"created":"1564371227764","type":"EcdsaSignature"},"signature":"G2kD4u4jrnmYbq/oVl9idmTEQzP3a0KEomHGJaVpWzhITIE+dDYSRMyF9TDy+jPANpYRJGg7pGnANM+QeJ9Ba00=","proofType":"EcdsaSignature"},
"disclosure":{"name":1,"id":1,"gender":1}'
http://127.0.0.1:6101/verifyCredential
若运行成功，则会打印以下信息：
{
"result":true,
"errorCode":0,
"errorMessage":"success",
"transactionInfo":null
}
表明 Credential 验证成功。
至此，您已经体验了 weid-sample 实现的各个角色的运行流程，实现的入口类在weid-sample工程的 com.webank.weid.demo.server.SampleApp，您可以参考进行您的 Java 应用开发。