企业组网(JD Chain)

1 联盟链创建

  在登录网络操作者系统后,进入区块链管理页签,点击网络创建按钮,选择联盟链,即可开始联盟链的创建,通过每一步的信息输入完成组网操作。

以下展示网络发起方的操作(受邀方请查看“邀请我的链”部分操作)。

img

  组网过程分为网络概述、邀请成员、底层选择、详细配置四个步骤,每个页面填写完必填项目之后,点击下一步按钮即可进入下一页面。

img

网络概览页面输入信息如下:

参数名 必填项 规则
网络名称 网络名称只得包含小写字母与数字,且不能以数字开头
跨域 单选项,跨域为跨JD BaaS平台组网,非跨域为单独JD BaaS平台组网,默认选项为非跨域。
网络说明 中文或者英文,长度不超过200字

  邀请成员页面会列出所有可以邀请入网的成员名单,每个成员对应一个网络管理者账号。此处可以进行条件查询,可以使用“公司名称”或“BaaS名称”来查询,在邀请成员页面可以选择多个成员加入,支持全选功能,可以邀请全部的成员加入网络。选择完毕成员后可以点击下一步按钮选择JD Chain底层。

img

选择完底层后,点击下一步进入详细配置页面。

img

详细配置页面中需要输入区块链基本信息,具体输入如下:

参数名 必填项 规则
共识模式 JD Chain目前支持BFTSmart、MQ、Raft三种共识
底层版本 目前1.5.0,1.6.1,1.6.4版本可供选择
身份认证模式 可选择KEYPAIR和CA模式
密码算法 可以选择密码算法,JDChain默认为Ed25519算法,也可选择SM2
数据库类型 目前支持Rocksdb和redis
TLS 选择是否支持TLS
浏览器 选择是否启用浏览器功能,如选择时,公网IP为必填项
API用户 用来调用API接口的用户名称,应用系统调用时需要使用该用户调用
API密码 API用户的密码,特殊符号、数字与字母组合
存储 选择区块链数据存储,并设定存储容量
公网IP 可以根据要求输入该集群的公网IP,若启用浏览器功能,则此项为必填项
预计成本 该组网的预计成本

  输入完毕信息后点击发送按钮,系统开始创建区块链网络的进程。点击运行按钮可以查看运行状态。

img

  当所有状态为running时,区块链网络建立完毕。需要注意的是,JD Chain的创建除了需要发起方节点成功运行,参与方节点也要成功运行后,区块链网络才正式创建完成。

img

  网络创建完毕后,可以点击网络名称链接,进入网络详情页面。

img

2 账本管理

  账本管理可以帮助用户创建、加入、邀请加入、以及对账本的一系列操作。JD Chain在组网完毕后,会默认创建一个账本“system-ledger”,此账本会将所有参与方全部纳入进来,如无特殊要求,可以使用此账本进行后续业务。如有特殊的账本隔离需求,那么可以将新建账本。

  创建账本需要进入账本管理Tab页,点击账本创建按钮即可进行账本的创建,创建账本需要输入的信息如下:

参数名 必填项 规则
受邀人 选择一个受邀人,受邀人必须已经加入到创建账本的区块链网络中
网络名称 展示项,不可输入,显示当前
账本名称 输入账本名称,只能英文输入,字符长度不大于20。名称不可重复,输入名称后系统自动校验名称
solidity合约 默认为不支持
账本说明 中文或者英文账本说明,字数不超过200

  账本创建时需要进行人员邀请,点击受邀人按钮,弹出可受邀列表页面,此页面为当前区块链网络中的所有参与者。在需要邀请加入账本的成员前勾选“√”即可,如需全选可在表头方框处勾选即可全部选择。对于勾选错误的受邀人,可以再次点击去掉“√”标识。选择完毕受邀人后,可以点击添加按钮,完成受邀人选择。注意:JD Chain底层要求参与方节点超过4个。

img

  账本创建的页面如下,输入完毕所有信息后,可以点击确认按钮完成账本的创建。

img

  账本创建后,可以在账本列表中查询账本信息,为方便查看,以下根据不同的tab页进行列表功能的详细描述。

我创建的账本: 我创建的账本列表,可以对账本进行一些授权操作,包括公开/隐藏。公开/隐藏功能可以控制账本是否在区块链网络中都可见。

img

我加入的账本: 在我加入的账本下可以查看账本信息,点击账本名称链接,可以进入账本查看详情信息。

img

已公开的账本: 账本创建者在创建完成账本后,对账本进行公开操作,公开的账本在相同网络下可以查看。

邀请我的账本: 账本的创建者可以邀请同网络下的其它成员加入账本。受邀人员在“邀请我的”页签下可以看到受邀信息,并确定是否要加入网络,如要加入,点击概览按钮,查看加入账本标签页,可以点击同意或者拒绝按钮加入或者拒绝加入网络。

img

3 数据账户管理

  JD Chain通过细化账户分类、分级分类授权的方式,对区块链系统中的数据账户进行管理,达到逻辑清晰化、隔离业务和保护相关数据内容的目的。JD Chain在组网完毕后,会默认创建一个数据账户“system-data-account”。此数据账户会将所有参与方全部纳入进来,如无特殊要求,可以使用此数据账户进行后续业务。如有特殊的数据隔离需求,那么可以根据业务要求重新建立数据账户。

 创建数据账户需要进入数据账户管理Tab页,点击新建数据账户按钮即可进行数据账户的创建,创建数据账户需要输入的信息如下:

参数名 必填项 规则
网络名称 展示项,不可输入,显示当前
账本名称 选项,带出目前网络下的账本名称,可选在哪个账本下建立数据账户。
受邀人 选择一个或多个受邀人,受邀人必须已经加入到创建账本的区块链网络中
数据账户名称 输入账本名称,只能英文输入,字符长度不大于20。名称不可重复,输入名称后系统自动校验名称。
数据账户说明 中文或者英文账本说明,字数不超过200
组织名称 展示项,展示当前创建人账号

  数据账户创建时需要进行人员邀请,点击受邀人按钮,弹出可受邀列表页面,此页面为当前区块链网络中的所有参与者。在需要邀请加入数据账户的人员前勾选“√”即可,如需全选可在表头方框处勾选“√”即可全部选择。对于勾选错误的受邀人,可以再次点击去掉“√”标识。选择完毕受邀人后,可以点击添加按钮,完成受邀人选择。

img

  数据账户创建的页面如下,输入完毕所有信息后,可以点击确认按钮完成创建。

img

  数据账户创建后,为方便查看,以下根据不同的Tab页进行列表功能的详细描述。

我创建的账户: 此页面下为我创建的数据账户列表,可以对账本进行一些授权操作,包括公开/隐藏准入激活/挂起

  公开/隐藏功能可以控制账本是否在区块链网络中都可见。数据账户是否公开可以在显示/隐藏栏下查看。

img

  公开/隐藏功能可以控制账本是否在区块链网络中都可见。数据账户是否公开可以在显示/隐藏栏下查看。   激活/挂起功能主要控制数据账户的状态,只有激活状态的数据账户才可以正常写入数据,挂起状态的数据账户无法读写数据。数据账户的状态在账户状态下显示。

img

  准入功能主要用来审核需要加入数据账户的申请,点击按钮后弹出页面中可以查看申请加入方的信息,可以点击同意拒入将其加入数据账户或者拒绝加入。

img

我加入的账户: 在我加入的账户下可以以账本为维度查看数据账户,点击账本名称左边的“+”图标可以展开该账本下的数据账户信息。点击账本名称左边的“-”符号可以隐藏数据账户信息。

img

  点击数据账户名称链接,可以进入数据账户查看详情信息。

img

已公开的账户: 账本创建者在创建完账本后,对账本进行公开操作,公开的数据账户在相同网络、账本下可以查看。

img

  对于希望加入的数据账户,可以点击申请加入按钮,弹出页面如下:

img

  此页面为当前数据账户的详细信息,确认无误后点击申请加入按钮,即可发出申请。加入数据账户,当账户的创建者同意后,即可加入数据账户。注意:对方同意后,此页面将不再显示该数据账户信息,加入的数据账户将显示在“我加入的账户”页签下。

已受邀的账户: 数据账户的创建者在创建账本时,可以邀请同网络、同账本下的其它成员加入数据账户。受邀人员在“已受邀的账户”页签下可以看到受邀信息,并确定是否要加入该数据账户。如要加入,点击概览按钮,查看加入账本标签页,可以点击同意或者拒绝按钮加入或者拒绝加入网络。

img

4 智能合约管理

  合约管理页面同样为用户提供展示列表,该列表页提供合约查询功能,输入合约名称后点击查询按钮可以查询到符合条件的合约信息。

img

  点击安装合约按钮,可以打开合约创建页面。页面输入信息如下:

参数名 必填项 规则
网络名称 展示字段,展示当前网络信息
账本名称 选择字段,主要选择该区块链网络下的所有账本,合约将安装在对应的账本下
合约名称 输入合约名称,只能英文输入,字符长度不大于20
合约版本 输入合约版本,只能数字输入,长度不超过5
合约文件 在本地系统中上传一个合约文件,JD Chain底层下要求文件必须为.car格式

  智能合约创建时需要进行人员邀请,点击受邀人按钮,弹出可受邀列表页面,此页面为当前区块链网络中的所有参与者。选择完毕受邀人后。可以点击添加按钮,完成受邀人选择。

img

  合约支持jar/.car文件,选择完毕文件后,系统会从本地将文件上传服务器,在出现下图所示状态时表示合约上传完毕。

img

  此时可以点击安装按钮进行安装操作。合约安装完毕后可以在列表页面查看,合约列表页面与区块链网络、账本一样,区分了不同的权限页签,方便用户快速找到自己需要的合约信息,下面将分页签介绍各个列表的功能和操作权限。

我创建的合约: 此页签下可以对本账号创建的合约进行操作,包括合约的公开/隐藏准入操作

  公开和隐藏可以操作合约的状态,是否在该账本下所有参与方都可以看到并申请加入该合约。公开状态下的合约可以被查看并申请加入。

img

  准入功能用来审核需要加入合约的组织,只有认为有必要的情况下,才会准入共同执行一段合约。准入页面打开后,可以看到申请人的姓名和公司,可以选择同意拒绝对方加入该合约。

img

  操作功能可以让用户试调用合约在合约方法和合约参数处输入信息可以直接将信息写入。

img

  在调用后,同样此页面的查询功能,可以将之前写入的信息读取出来。

img

我加入的合约: 受邀请并且同意加入后,合约会显示在此页面,他人创建的合约不可进行更新;此页面可以操作合约,对合约进行调用。调用方式与我创建的合约一致,在此不做累述。

已公开的合约: 此页签下显示账本内所有已经公开的合约信息,对于不是本账号创建的合约可以申请加入,对于是本账号创建的合约只能查看节点信息。

邀请我的合约: 在此页面下,可以看到受邀请加入的合约,可以点击概览按钮查看合约信息,并决定是否加入,加入可以选择同意按钮,不加入可以选择拒绝按钮,加入后合约信息将在已安装的合约中显示。

img

5 应用管理

  应用管理页面可以查看联盟链网络下安装的所有应用,可以对已安装的应用进行公开/隐藏转发升级应答删除操作。

应用管理列表

img

1)敏感词管理

  根据公安部的要求,区块链网络需要有统一的敏感词管理功能,避免一些非法信息上链存储,造成不必要的损失或造成不良信息的传播。

  新创建的网络没有默认的敏感词,需要在应用商店进行手工配置,点击“jd-baas-bian-sensitive”应用下详情按钮可以开始配置敏感词。敏感词配置页面如下:

img

敏感词应用配置界面(应用商店)

  配置完成后进入敏感词管理应用下的敏感词管理页签,点击添加敏感词按钮。

添加敏感词 img

此页面输入信息如下:

参数名 必填项 规则
敏感词类型 选择敏感词类型,目前类型有政治和公共两种
详细分类 敏感词类型为政治时,详细分类为军事方面和机密内容;敏感词类型为公共时,详细分类为暴力倾向和黄赌毒倾向
时间 敏感词禁止的时间段设置,永久为9999-12-31
敏感词 输入需要管控的敏感词

添加完成,回到敏感词管理列表页面,此页面展示设置的敏感词相关信息。

敏感词列表页面

img

2)敏感交易管理

  敏感交易管理是一种事后管控手段,针对一些新型敏感词,没有及时维护到链上的时候,已经入链的内容,可以定期查看其交易号及交易账户。敏感交易为列表页面,可以查看到该区块链网络下的所有交易信息。

img

3)投诉举报管理

  投诉举报管理是向联盟链管理方反馈问题的最有效捷径,参与者可以在此对区块链网络中的不良现象进行投诉。进入列表页面后点击投诉举报即可开始投诉举报内容的编写。

img

投诉举报内容编写如下表:

参数名 必填项 规则
操作类型 选择操作类型,目前类型有投诉和举报两种
详细分类 操作类型为投诉时,详细分类为业务投诉和内容投诉;操作类型为公共时,详细分类敏感词举报和重大事故举报
详细说明 添加投诉的详细说明

4)IPFS管理

  JD BaaS平台集成了IPFS功能,并将在应用商店中组件化,与敏感词管理应用安装类似,帮助用户安全的存储文件。

IPFS应用安装

img
  当区块链网络安装了IPFS应用功能时可以在网络详情页面中发现IPFS管理的标签,此标签页面可以手工上传一些文件至IPFS分布式存储系统,并列出所有存储在IPFS中的文件。点击上传按钮,在页面中选择本地文件,在页面进度条达到100%后,可以点击确认按钮后开始上传。

img

还可以在左上角输入文件名称后点击查询按钮查看对应的文件。

IPFS管理列表

img   此页面同样提供两个下载功能,一个是每条记录的后方下载操作按钮,点击后直接开始下载动作。还可以输入文件的哈希值,输入完毕后,后方下载按钮可以开始下载。

6 操作日志管理

  在区块链网络建成后,所有对于网络的操作都会被记录,并在操作日志管理中列表展示,操作日志管理是对系统达成监管要求的必要功能。

img

7 API用户管理

  API用户用来对接应用层与区块链底层,当需要调用区块链接口时,可以利用此用户来进行,此用户账号密码由网络管理者创建并保存。需要建立API账户需要进入API用户管理页面,点击注册按钮,打开用户注册页面注册API用户,该页面输入信息如下:

参数名 必填项 规则
API用户名称 输入用户名称,仅限英文输入,长度不超过255
API用户密码 输入用户密码,区分大小写,仅限英文及特殊字符
邮箱 可选输入,邮箱可以接收API调用信息。

  输入完毕所有信息后,可以点击确认创建API用户,也可以点击取消按钮或者“×”来关闭当前页面。

img

8 浏览器

  JD BaaS集成了JD Chain原生浏览器,在组建网络时选择了浏览器后,用户可以使用其查看区块链网络状态、区块高度、交易、账户、合约和链上数据。

浏览器首页

img

区块链高度页面

img

数据账户页面

img

合约页面

img

用户页面

img