Skip to content

Commit

Permalink
Add missing images and fix descriptions
Browse files Browse the repository at this point in the history
  • Loading branch information
chaoxinhu committed Dec 3, 2019
1 parent 8bc23bc commit e2cc529
Show file tree
Hide file tree
Showing 9 changed files with 15 additions and 15 deletions.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/zh_CN/docs/images/linked-events.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/zh_CN/docs/weidentity-contract-design.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

.. _weidentity-contract-design:

WeIdentity智能合约设计文档
WeIdentity 智能合约设计与实现
===============================

WeIdentity智能合约概述
Expand Down
2 changes: 1 addition & 1 deletion docs/zh_CN/docs/weidentity-endpoint.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@

.. _weidentity-endpoint:

WeIdentity Endpoint Service 文档
WeIdentity Endpoint Service
=================================

在开发过程中,您可能会有将自己的某些Java方法暴露给外部调用方调用的需求。在过去,您可能需要自己开发一套基于HTTP/HTTPS的请求,及基于RPC的Endpoint服务端点的创建、维护及处理服务,这可能会花费大量的开发人力和工时。
Expand Down
2 changes: 1 addition & 1 deletion docs/zh_CN/docs/weidentity-installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

.. _weidentity-installation:

WeIdentity Java SDK 安装部署文档
WeIdentity Java SDK 安装部署
================================


Expand Down
2 changes: 1 addition & 1 deletion docs/zh_CN/docs/weidentity-rest.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@

.. _weidentity-rest:

WeIdentity RestService 文档
WeIdentity RestService
================================

WeIdentity RestService提供了简化的WeIdentity集成方式与访问能力。使用者仅需将RestService部署到一台Java的机器并连接到FISCO-BCOS区块链上,便可以通过HTTP/HTTPS协议访问WeIdentity的功能了。请参见:
Expand Down
8 changes: 4 additions & 4 deletions docs/zh_CN/docs/weidentity-sample.rst
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@

.. _weidentity-sample:

WeIdentity 开发样例
======================
WeIdentity Sample 开发样例
================================

\ `weid-sample <https://github.com/WeBankFinTech/weid-sample>`__\ 是基于 \ `WeIdentity <https://weidentity.readthedocs.io/zh_CN/latest/README.html>`__ 开发的 Java 应用样例程序,提供了一整套的流程演示,可以帮您快速理解 WeIdentity 的运行机制,您也可以参考该样例程序,开发您的 Java 应用。
\ `weid-sample <https://github.com/WeBankFinTech/weid-sample>`__\ 是基于 WeIdentity 开发的 Java 应用样例程序,提供了一整套的流程演示,可以帮您快速理解 WeIdentity 的运行机制,您也可以参考该样例程序,开发您的 Java 应用。

环境准备
^^^^^^^^^^^^^^^^^^^^^^^^^^

您可以参考 WeIdentity JAVA SDK 安装部署文档中的\ `准备工作 <https://weidentity.readthedocs.io/zh_CN/latest/docs/weidentity-installation.html#id2>`__\ 章节进行准备。
您可以参考 WeIdentity JAVA SDK 安装部署文档中的\ `准备工作 <./weidentity-installation.html#id2>`__\ 章节进行准备。

快速体验
^^^^^^^^^^^^^^^^^^^^^^^^^^
Expand Down
12 changes: 6 additions & 6 deletions docs/zh_CN/docs/weidentity-spec.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@

.. _weidentity-spec:

WeIdentity 规范文档
WeIdentity 规范
=====================

.. list-table::
Expand Down Expand Up @@ -178,7 +178,7 @@ WeIdentity Document格式



* WeIdentity DID的Authorization机制由补充规范实现
* WeIdentity DID的Authorization机制及Recovery机制由补充规范实现,不在本文中定义

示例:

Expand Down Expand Up @@ -234,7 +234,7 @@ WeIdentity DID支持操作

更新WeIdentity Document的相关属性

4. WeIdentity Credentials
4. WeIdentity Credential
--------------------------

角色和关系
Expand Down Expand Up @@ -501,19 +501,19 @@ Credential撤销
Credential撤销机制利用了下面两点:

#. 任意大于1的整数 a,如果 a 不是素数,则 a 可以表示为一系列素数的乘积,且这个表示是唯一的(不考虑顺序)。参见:\ `算数基本定理 <https://en.wikipedia.org/wiki/Fundamental_theorem_of_arithmetic>`_\
#. 目前没有一个有效率的算法,对两个足够大的素数乘积得到的半素数(\ `semiprime <https://en.wikipedia.org/wiki/Semiprime>`_\ )进行整数分解。参见:\ `整数分解 <https://en.wikipedia.org/wiki/Integer_factorization>`_\
#. 目前没有一个有效率的算法,对两个足够大的素数乘积得到的半素数(\ `semiprime <https://en.wikipedia.org/wiki/Semiprime>`_\ )进行整数分解。参见:\ `整数分解 <https://en.wikipedia.org/wiki/Integer_factorization>`_\

WeIdentity 会公开一个大素数的文件,每个素数会有一个 index,供所有 Issuer 使用。Issuer 发行一个 Credential 的时候,就随机从这个大素数文件中选择一个素数,这个素数的 index 会作为这个 Credential 的属性之一。并把以往所有发行的未撤销的 Credential 的素数相乘,得到一个大数 Accumulator(每个 Issuer 会维护自己的 Accumulator),并将这个 Accumulator 公开供所有接入方查询。

Issuer 如何撤销一个 Credential
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

用这个 Credential 对应的素数去除 Issuer 自己的 Accumulator,将结果更新为新的 Accumulator。
用这个 Credential 对应的大素数去除 Issuer 自己的 Accumulator,将结果更新为新的 Accumulator。

Verifier 如何验证一个 Credential 有效(未被撤销)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

用这个 Credential 对应的素数去除 Credential 的 Issuer 公开的 Accumulator,如果能整除,则表明是 Credential 是有效的(未被撤销)。
用这个 Credential 对应的大素数去除 Credential 的 Issuer 公开的 Accumulator,如果能整除,则表明是 Credential 是有效的(未被撤销)。


.. image:: images/before-revocation.png
Expand Down
2 changes: 1 addition & 1 deletion docs/zh_CN/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,6 @@ WeIdentity文档
docs/miscellaneous.md
docs/weidentity-rest.rst
docs/weidentity-installation.rst
docs/weidentity-endpoint.rst
docs/weidentity-sample.rst
docs/weidentity-endpoint.rst
WeIdentity Java SDK 文档 <https://weidentity.readthedocs.io/projects/javasdk/zh_CN/latest/>

0 comments on commit e2cc529

Please sign in to comment.