业务网络卡片
业务网络卡片提供连接区块链业务网络所需的所有信息。只能通过有效的业务网络卡片访问区块链业务网络。业务网络卡片包含已部署业务网络中的单个参与者的身份。Hyperledger Composer Playground中使用业务网络卡片连接到已部署业务网络。你可以为单个已部署业务网络配置多个业务网络卡片,其中这些业务网络卡片属于多个参与者。
业务网络卡片分组在连接配置文件下,每个卡片显示了相应的业务网络,可以通过立即连接选项使用显示的身份访问该网络。可以使用卡片上的图标删除或导出业务网络卡片。
这是一张业务网络卡片,可以使用“新用户”身份连接到名为“my-business-network”的业务网络。
在Playground内颁发身份时,可以创建业务网络卡片。此业务网络卡片随后可以导出并与其他人共享,从而允许他们使用颁发的身份连接到业务网络。如果管理员向用户提供了登记ID和密码,这对应了业务网络中的有效身份,然后业务网络卡片可以直接在Playground中创建。也可以手工创建业务网络卡片。
使用Playground创建peer管理卡片
首次将业务网络部署到Hyperledger Fabric实例需要将Hyperledger Composer链码安装在相关的Hyperledger Fabric peer上,然后在该通道上实例化业务网络。这个过程需要peer或通道管理员拥有的特殊的Hyperledger Fabric特权。
必须创建peer管理业务网络卡片才能将Hyperledger Composer业务网络部署到Hyperledger Fabric实例。创建peer管理业务网络卡片:
在我的业务网络屏幕上,点击创建业务网卡。
选择Hyperledger Fabric v1.0,然后单击下一步。
输入你的连接配置文件的详细信息。要更好地了解创建连接配置文件,请参阅部署到Hyperledger Fabric并单击下一步。
选择“ 证书”并上传peer管理员身份的证书和私钥信息。“ 部署到Hyperledger Fabric”教程概述了在哪里可以找到正确的证书。
输入业务网络卡片的名称。
选择管理卡片,然后peer管理和通道管理。
点击下一步
peer管理卡现在应该出现在你的“ 我的业务网络”屏幕中。你现在可以使用Playground将业务网络部署到Hyperledger Fabric实例。
使用业务网络卡片对业务网络提供访问权限
通过向其他用户提供业务网络卡片,来授权他访问你的业务网络。一旦创建,业务网络卡片就可以被导出并提供给为其创建的用户。
业务网络中必须存在一个参与者,以绑定创建业务网络卡片所需的身份。
当在Playground中颁发身份时,可以选择保存身份以用于“业务网络”页面。通过选择此选项,将为当前业务网络的颁发身份创建业务网络卡片。一旦你退出当前业务网络,业务网络卡片将出现在你的业务网络页面上,而且该业务网络卡片可以从该位置导出并与其他用户共享。
创建业务网络卡片
1.从“ 业务网络”页面中,选择一个用于连接到你的业务网络的身份。点击立即连接。请注意:你必须使用有权创建新身份的身份。
2.如果需要,请创建你要为其分配身份的参与者:
- 单击测试选项卡,然后单击创建新参与者。
- 完成参与者定义并单击新建。
视频
3.点击右上方你的身份名称,然后在下拉菜单中点击ID Registry。
4.点击+颁发新的ID。
5.选择一个ID名称,并输入一个现有的参与者关联新的身份。这里提供了一个预见性服务来自动完成已知的参与者。
6.点击新建。
7.点击添加到我的钱包。将业务网络卡片添加到你的“业务网络”页面可让你使用它连接到业务网络,或将其导出供其他人使用。
该业务网络页面现在应该显示新的业务网络卡片。 视频
导出业务网络卡片
业务网络卡片从Playground的业务网络页面导出,与希望导出的业务网络卡片进行交互,这个过程只有一步。
-在“ 业务网络”页面上,单击你想要导出的业务网络卡上的导出图标。业务网络卡片会作为.card
文件下载。
请注意:如果你导出一张从未用过的业务网络卡片,例如发给新的参与者的,它将包含获取证书和私钥所需的登记ID和登记密码,证书和私钥用于识别参与者。或者,如果你导出了之前使用过的业务网络卡片,它将已经包含了证书和私钥。有关参与者和身份的更多信息,请参阅我们的主要文档。
重要:导出的身份卡片应该小心处理,因为它们包含不受保护的证书。我们建议你只发送已加密的身份卡片。
获得业务网络的访问权限
导入业务网络卡片
导入业务网络卡片可让你连接到已部署业务网络。
在“ 业务网络”页面上,单击右上角的导入业务网络卡片。
拖放或浏览以选择要导入的业务网络卡片(
.card
)文件。点击导入。
业务网络卡片现在应该在你的业务网络页面中可见; 你现在可以连接到已部署业务网络。
使用凭据进行连接
业务网络页面可以通过两种方式创建业务网络卡。
业务网络卡片可以使用证书创建,这需要以下内容:由业务网络管理员提供的证书和私钥 ; 一个业务网络卡片的名称; 凭证对应的业务网络名称 ; 目标业务网络部署的运行时的连接配置文件详细信息。
使用证书从“ 业务网络”页面创建业务网络卡片:
收到证书和私钥后,单击“ 业务网络”页面右上角的“ 使用凭据连接”按钮。
如果以前连接到已部署的运行时,请从显示的列表中选择它,单击下一步继续执行步骤4; 否则选择单选选项连接到一个新的区块链,然后点击下一步。
确认提供给你的连接配置文件详细信息,然后单击保存。
输入证书、私钥、业务网络卡片名称和业务网络名称,然后单击创建。
业务网络卡片现在应显示在“ 业务网络”页面中。
手动创建业务网络卡片
业务网络卡片是档案(.zip
)文件,最多包含三个元素:
一个连接配置文件。(
.json
)一个包含用于连接到业务网络的身份数据的元数据文件。(
metadata.json
)一个可选凭据目录,包含一个证书和私钥。
请注意:如果没有凭据目录,则元数据文件必须包含属性名称是enrollmentSecret的登记密码属性。如果指定了enrollmentSecret,则会导出包含证书的凭据目录并填充业务网络卡片。
元数据文件应采用以下格式:
{
"name": "PeerAdmin",
"description": "A valid Business Network Card",
"businessNetwork": "basic-sample-network",
"enrollmentId": "UserID",
"enrollmentSecret": "UserSecret",
"roles": [
]
}
businessNetworkName、image、enrollmentSecret和roles属性是可选的。可用的roles是PeerAdmin
和ChannelAdmin
。
要创建业务网络卡片文件,请压缩连接配置文件,元数据文件和凭证目录,然后修改文件类型为.card
。
此业务网络卡片现在可以使用Hyperledger Composer Playground导入。