Skip to content

Commit

Permalink
* Rebuild docs
Browse files Browse the repository at this point in the history
  • Loading branch information
junqizhang-dev committed Apr 15, 2020
1 parent db2e006 commit 7caecd9
Show file tree
Hide file tree
Showing 6 changed files with 11 additions and 28 deletions.
2 changes: 1 addition & 1 deletion docs/_sources/docs/weidentity-build-with-deploy.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,7 @@ FISCO BCOS 1.3请参考\ `1.3 web3sdk客户端配置 <https://fisco-bcos-documen

.. note::
| 发布 WeIdentity 智能合约的机构将会自动注册为委员会机构成员( Committee Member )。
| 发布 WeIdentity 智能合约会同时会在 ``weid-build-tools/output/admin`` 目录下动态生成私钥文件 ``ecdsa_key``,以及对应的公钥文件 ``ecdsa_key.pub``,此私钥后续用于注册权威机构,您可以将起保存到您的其他存储库里
| 发布 WeIdentity 智能合约会同时会在 ``weid-build-tools/output/admin`` 目录下动态生成私钥文件 ``ecdsa_key``,以及对应的公钥文件 ``ecdsa_key.pub``,此私钥后续用于注册权威机构,您可以将其保存到您的其他存储库里

至此,您已经完成 weid-java-sdk 的安装部署,您可以开始您的 Java 应用集成以及便捷工具体验。
Expand Down
21 changes: 2 additions & 19 deletions docs/_sources/docs/weidentity-rest-api.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1705,31 +1705,14 @@ POST /weid/api/encode 接口入参
"errorMessage": "success"
}
请注意,这个生成的CredentialPojo的签名值(proof中的signatureValue项)并没有经过私钥签名。正确的签名方式包括下面几步:
- base64解码,生成一个二进制字节数组
- 对解码的byte[]做一次secp256k1的hash
- 对完成hash过byte[],再做一次hash(如果您使用的是Java web3sdk的SignMessage(),这一步它替您完成了)
- 传入私钥,进行签名,得到r,s,v
- 对进行序列化
- 把序列化的byte进行base64编码发回RestService
请注意,这个生成的CredentialPojo的签名值(proof中的signatureValue项)并没有经过私钥签名。因此,您还需要其经过Base64解码之后,再使用Issuer的私钥进行签名并Base64编码,就能得到一个正确的CredentialPojo了。

使用ECDSA私钥进行签名和Base64编码的范例代码见下(Java和Go)
使用ECDSA私钥进行签名和Base64编码的范例代码见下:

.. code-block:: java
String signature = DataToolUtils.sign(new String(DataToolUtils.base64Decode(signatureValue)), privateKey);
.. code-block:: go
base64SignatureValue := credentialEncodeResponse.RespBody.Proof.SignatureValue
signatureValue, err3 := base64.StdEncoding.DecodeString(base64SignatureValue)
hashedMsg := Hash(signatureValue)
doubleHashedMsg := Hash(hashedMsg)
privateKeyBytes := ConvertPrivateKeyBigIntToPrivateKeyBytes(privateKeyBigInt)
signatureBytes, err4 := SignSignature(doubleHashedMsg, privateKeyBytes)
signatureBase64String := base64.StdEncoding.EncodeToString(signatureBytes)
WeIdentity Endpoint Service API
------------------------------------

Expand Down
8 changes: 4 additions & 4 deletions docs/_sources/docs/weidentity-rest-deploy.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -87,17 +87,17 @@ Server 的环境要求与 WeIdentity-Java-SDK 的 `环境要求 <./weidentity-in

.. code-block:: xml
nodes=127.0.0.1:8812,127.0.0.1:8900
nodes=WeIdentity@127.0.0.1:8812,WeIdentity@127.0.0.1:8900
* 拷贝您 WeIdentity 合约部署者的私钥到 ``keys/priv`` 目录下,并重命名为 ``ecdsa_key``。如果您使用部署工具部署了 WeIdentity 合约,这个文件在 ``output/admin/`` 目录。如果您使用源码部署,这个文件在源代码根目录下。

* 修改 ``dist/conf/application.properties`` ,填入需要打开的监听端口地址(用于 RestServer 监听外来的 HTTP/HTTPS RESTful 请求,默认为 6001/6000,不可被其他程序占用;HTTPS接口默认不开放)。同时,请确认用来调用默认合约部署者私钥的暗语;由于此暗语可直接调用 WeIdentity 合约部署者的私钥,权限较高(详见 \ `RestService API 说明文档 <./weidentity-rest-api.html>`_\ ),因此请您务必对其进行修改。
* 修改 ``dist/conf/application.properties`` ,填入需要打开的监听端口地址(用于 RestServer 监听外来的 HTTP/HTTPS RESTful 请求,默认为 6000/6001,不可被其他程序占用)。同时,请确认用来调用默认合约部署者私钥的暗语;由于此暗语可直接调用 WeIdentity 合约部署者的私钥,权限较高(详见 \ `RestService API 说明文档 <./weidentity-rest-api.html>`_\ ),因此请您务必对其进行修改。

.. code-block:: bash
# HTTP请求端口
# HTTPS请求端口
server.port=6001
# HTTPS请求端口,默认不开放
# HTTP请求端口
server.http.port=6000
# 合约部署者私钥暗语
default.passphrase=ecdsa_key
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/weidentity-build-with-deploy.html
Original file line number Diff line number Diff line change
Expand Up @@ -294,7 +294,7 @@ <h4>1.3 部署智能合约并自动生成配置文件<a class="headerlink" href=
<p class="admonition-title">注解</p>
<div class="line-block">
<div class="line">发布 WeIdentity 智能合约的机构将会自动注册为委员会机构成员( Committee Member )。</div>
<div class="line">发布 WeIdentity 智能合约会同时会在 <code class="docutils literal notranslate"><span class="pre">weid-build-tools/output/admin</span></code> 目录下动态生成私钥文件 <code class="docutils literal notranslate"><span class="pre">ecdsa_key</span></code>,以及对应的公钥文件 <code class="docutils literal notranslate"><span class="pre">ecdsa_key.pub</span></code>,此私钥后续用于注册权威机构,您可以将起保存到您的其他存储库里</div>
<div class="line">发布 WeIdentity 智能合约会同时会在 <code class="docutils literal notranslate"><span class="pre">weid-build-tools/output/admin</span></code> 目录下动态生成私钥文件 <code class="docutils literal notranslate"><span class="pre">ecdsa_key</span></code>,以及对应的公钥文件 <code class="docutils literal notranslate"><span class="pre">ecdsa_key.pub</span></code>,此私钥后续用于注册权威机构,您可以将其保存到您的其他存储库里</div>
</div>
</div>
<p>至此,您已经完成 weid-java-sdk 的安装部署,您可以开始您的 Java 应用集成以及便捷工具体验。</p>
Expand Down
2 changes: 1 addition & 1 deletion docs/searchindex.js

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions readthedocs/zh_CN/docs/weidentity-installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ WeIdentity Java SDK 安装部署
* - FISCO-BCOS区块链环境
- 您需要有一套可以运行的FISCO-BCOS区块链环境,如果没有,可以参考\ `「FISCO-BCOS 2.0节点安装方法」 <https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/installation.html>`_\ \ `「FISCO-BCOS 1.3节点安装方法」 <https://fisco-bcos-documentation.readthedocs.io/zh_CN/release-1.3/docs/tools/index.html>`_\ 来搭建一套区块链环境。
* - JDK
- 要求\ `JDK1.8+ <https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html>`_\ ,推荐使用jdk8u141。
- 要求\ `JDK1.8+ <https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html>`_\ ,推荐使用jdk8u141。JDK 跟 WeID 直接的兼容性,可见\ `兼容性文档 <https://weidentity.readthedocs.io/zh_CN/latest/docs/weid-compatibility-test.html>`_\
* - gradle
- WeIdentity JAVA SDK使用\ `gradle <https://gradle.org/>`_\ 进行构建,您需要提前安装好gradle,版本要求不低于4.3。
* - 网络连通
Expand Down Expand Up @@ -62,4 +62,4 @@ WeIdentity Java SDK 安装部署
:hidden:
:maxdepth: 1

weidentity-quick-tools.rst
weidentity-quick-tools.rst

0 comments on commit 7caecd9

Please sign in to comment.