WeIdentity 入门

准备工作

配置 说明
操作系统 CentOS (7.2.* 64位)或Ubuntu(16.04 64位)。
FISCO-BCOS区块链环境 您需要有一套可以运行的FISCO-BCOS区块链环境,如果没有,可以参考「FISCO-BCOS 2.0节点安装方法」来搭建一套区块链环境。
JDK 要求Oracle JDK1.8+,如果使用 WeIdentity 过程中发现 JDK 版本导致的任何问题,推荐使用jdk8u141、jdk8u212、jdk8u231。JDK 跟 WeID 直接的兼容性,可见兼容性文档
网络连通 检查部署 WeIdentity JAVA SDK 的服务器是否能 telnet 通 FISCO BCOS 节点的 channel 端口(channel端口是什么,详见),若telnet不通,需要检查网络连通性和安全策略。

工具目录

工具名称 仓库地址 文档地址 说明
WeIdentity-Build-Tools 「github」 「gitee」 「文档地址」 通过安装部署工具,您可以快速的在您的应用项目中集成weid-java-sdk
WeIdentity Sample 「github」 「gitee」 「文档地址」 weid-sample 是基于 WeIdentity 开发的 Java 应用样例程序,提供了一整套的流程演示,可以帮您快速理解 WeIdentity 的运行机制,您也可以参考该样例程序,开发您的 Java 应用。
WeIdentity RestService 「github」 「文档地址」 WeIdentity RestService提供了简化的WeIdentity集成方式与访问能力。使用者仅需将RestService部署到一台Java的机器并连接到FISCO-BCOS区块链上,便可以通过HTTP/HTTPS协议访问WeIdentity的功能了

第1步:安装 WeIdentity (如果使用不依赖区块链的方式,可以跳过部署,直接体验Sample和使用WeIdentity Java SDK)

您可以参照“安装 WeIdentity 部署工具”,安装 WeIdentity 部署工具,这是一个网页工具,可以通过工具可以完成WeIdentity的部署,同时也提供了一些其他功能。

第2步:使用 WeIdentity 部署工具完成部署

参照“配置教程”,完成配置和部署。

第3步:运行 Sample 代码,体验接口(可选)

注解

如果不想体验 Sample,可以直接跳过这一步

您可以参考“开发样例使用”,体验 WeIdentity 的各种接口。

第4步:在自己的 Java Service 中集成 WeIdentity Java SDK

参考:“集成 WeIdentity Java SDK”

注解

如果您是要的是其他语言而非 Java,可以参照RestService文档,通过 WeIdentity Rest Service 来调用相关的接口。

其他:WeIdentity Java SDK 接口文档

参考“Java SDK文档”,深入了解 WeIdentity 的接口调用。

其他: WeIdentity 部署工具其他功能介绍

参考“WeIdentity 部署工具使用简介”

其他: WeIdentity 命令行工具使用

我们提供了一些快捷工具,可以帮您快速体验 weid-java-sdk,请参考“WeIdentity JAVA SDK 便捷工具使用”