1 用途

1.1 交易流程回顾

Hyperledger Fabric 区块链网络交易的执行分为以下几个步骤。Endorser 与 Committer 都是 Hyperledger Fabric 区块链网络中 Peer 节点的具体角色。与背书策略强相关的是第3步。

Client 构造交易并发往 Endorser 节点，Endorser 节点执行交易并调用系统链码 ESCC 对交易签名（背书），结果返回 Client
Client 将交易响应发送给 Orderer 节点进行排序出块，Orderer 节点将交易打包到区块中，广播给网络上的 Committer 节点
Committer 节点收到区块后，对区块内交易逐一验证，其中一个重要的步骤是调用系统链码 VSCC 校验交易是否符合指定的 Endorsement 策略，最后将区块追加到区块链上。
'（流程序号与图中序号无关）

Fabric交易流程图

1.2 作用

系统链码 VSCC 的作用包括，背书策略为 VSCC 提供2、3的准则。

验证 Endorser 节点对交易的签名
验证是否有足够数量的节点对交易背书
背书信息来自指定源

2 用法

2.1 实体的定义

实体( Principal )：一个实体由 MSP 与 ROLE 定义，即某个组织内的某个角色。其中ROLE支持四种 client, peer, admin, member。例如 Org0.admin 表示 Org0 这个 MSP 下的任意管理员; Org1.member 表示 Org1 这个 MSP 下的任意成员。

2.2 表达式

Endorsement Policy 的语法结构如下所示。EXPR 可以是是 AND 或者 OR 逻辑符。E 是实体或者嵌套的表达式。

// 基础表达式形式
EXPR(E[, E...])
// 需要三个实体都提供签名
AND('Org1.member', 'Org2.member', 'Org3.member')
// 需要两个实体任一提供签名
OR('Org1.member', 'Org2.member')
// 需要Org1的admin提供签名，或者Org2，Org3的member同时提供签名
OR('Org1.admin', AND('Org2.member', 'Org3.member'))

2.3 示例

2.3.1 在cli命令行中使用

# 实例化
$ peer chaincode instantiate -C <channelid> -n mycc -P "AND('Org1.member', 'Org2.member')"
# 升级
$ peer chaincode upgrade -o orderer.example.com:7050 --tls $CORE_PEER_TLS_ENABLED --cafile $ORDERER_CA -C $CHANNEL_NAME -n mycc -v 2.0 -c '{"Args":["init","a","90","b","210"]}' -P "OR ('Org1MSP.peer','Org2MSP.peer','Org3MSP.peer')"

2.3.2 在SDK使用

Fabric 为SDK提供了另一套独立的简单语法来指定背书策略。
Node中可以创建如下对象，示例策略对应命令行的：

AND('ordererOrg.admin', OR(peerOrg1.member, peerOrg2.member))

{identities: [// 以下几项自动编号为[0,1,2]{ role: { name: "member", mspId: "peerOrg1" }},{ role: { name: "member", mspId: "peerOrg2" }},{ role: { name: "admin", mspId: "ordererOrg" }}],policy: {// n-of 指定需要组内多少个进行签名， 1-of 等价于 OR, max-of 等价于AND，此处2与后面的组相同，因此是AND"2-of": [// 对应编号2的身份{ "signed-by": 2},// 嵌套{ "1-of": [{ "signed-by": 0 }, { "signed-by": 1 }]}]}
}

Java中创建如下 .yaml 文件，并调用 ChaincodeEndorsementPolicy.fromYamlFile() 进行解析即可。示例策略对应命令行的：

OR(OR('Org1MSP.member', 'Org1MSP.admin'), OR('Org2MSP.member', 'Org2MSP.admin'))

# 指定策略中会用到的角色
identities: # Org1MSP 中的 memberuser1: {"role": {"name": "member", "mspId": "Org1MSP"}} # Org2MSP 中的 memberuser2: {"role": {"name": "member", "mspId": "Org2MSP"}}# Org1MSP 中的 adminadmin1: {"role": {"name": "admin", "mspId": "Org1MSP"}}# Org2MSP 中的 adminadmin2: {"role": {"name": "admin", "mspId": "Org2MSP"}}policy:# n-of 指定需要组内多少个进行签名， 1-of 等价于 OR, max-of 等价于AND1-of:# 嵌套- 1-of:# user1 即上面角色中的 user1- signed-by: "user1"- signed-by: "admin1"- 1-of:- signed-by: "user2"- signed-by: "admin2"

3 注意点

3.1 默认策略

Chaincode需要在部署时指定 Endorsement Policy ，否则默认的背书策略为通道中组织的任意成员( “any member of the organizations in the channel”)。例如，通道中有两个组织 Org1, Org2 ，则默认策略为 OR('Org1.member', 'Org2.member')。

3.2 新增实体

对于 Chaincode 实例化后才加入的组织，其节点可以进行 Chaincode 查询操作，但是不能对背书交易进行提交，此时需要修改 Chaincode 的背书策略以增加该组织相关节点的权限。我们可以通过 Upgrade Chaincode 来达到为其指定新的背书策略的目标。

3.3 交易验证失败

如1.1所述，Hyperledger Fabric 区块链网络的交易执行到第3步时， Orderer 节点已经出块，交易包含在区块中。若此处仅仅是区块内部的交易验证失败，不会影响区块上链，只是对于该交易会标记一个交易失败的验证码（ValidationCode: "0" 表示交易成功，"非0"表示交易无效），对于背书策略不符的情况，验证码为 ENDORSEMENT_POLICY_FAILURE(10)。

4 参考资料

Hyperledger Fabric v1.1 官方文档
https://hyperledger-fabric.readthedocs.io/en/release-1.1/endorsement-policies.html
Fabric Node SDK 说明文档
https://fabric-sdk-node.github.io/global.html#ChaincodeInstantiateUpgradeRequest
Fabric 源码
fabric-sdk-java-release-1.1\src\test\fixture\sdkintegration\chaincodeendorsementpolicy.yaml

Fabric背书策略相关推荐

Hyperledger Fabric 背书策略
背书策略是为了告知peer节点,交易是否被正确的背书.当peer接收到一个交易到时候,它将会invoke与交易相关的chaincode的VSCC(Validation System Chaincode ...
区块链学习8：超级账本项目Fabric中的背书、背书节点、背书策略、背书签名
☞ ░ 前往老猿Python博文目录 ░ 在Hyperledger Fabric区块链中,有背书节点进行背书,Hyperledger Fabric 使用背书策略来定义哪些节点需要执行交易. Hyper ...
Fabric框架的学习-4-链码与背书策略
六. 智能合约 6.1 Golang版本的ChainCode的代码结构链代码的包名的指定 // xxx.go package main // main不能改必须要引入的包 // go get gi ...
fabric1.1 node-sdk实现AND多方背书策略
大概过程就是将背书节点添加到channel中,然后构造交易提案请求参数发送交易提案,然后构造交易请求参数,发送交易即可. 我这里在链码实例化的时候指定的背书策略为:AND('Org1MSP.membe ...
(七)Fabric2.0智能合约实践-设置背书策略
总目录: (0) 如何利用区块链保护知识产权 (一)HyperLedger Fabric 2.0-release测试网络部署 (二)Fabric2.0 first-network 生成配置说明 (三) ...
Fabric背书过程中链码是并行还是串行？
声明:链码开发语言是golang,源码分析是基于fabric 1.4.0版本链码开发的时候,总是有一个疑问,链码的调用到底是并行还是串行?如果是并行,就需要我们对一些线程不安全的对象进行保护,反之则 ...
Fabric权限管理和策略
权限管理是区块链网络十分重要的功能,负责控制某个身份在某个场景下是否允许采取某个操作(如读写某个资源). 超级账本 Fabric 项目通过策略(Policy)来灵活指定各场景下的操作权限. 策略应用场 ...
超级账本Fabric中的权限管理和策略
权限管理是区块链网络十分重要的功能,负责控制某个身份在某个场景下是否允许采取某个操作(如读写某个资源). 超级账本 Fabric 项目通过策略(Policy)来灵活指定各场景下的操作权限. 策略应用场 ...
Hyperledger Fabric权限管理和策略
权限管理是区块链网络十分重要的功能,负责控制某个身份在某个场景下是否允许采取某个操作(如读写某个资源). 超级账本 Fabric 项目通过策略(Policy)来灵活指定各场景下的操作权限. 策略应用场 ...

Fabric背书策略