背書策略
背書策略用來定義交易是否合法的判斷條件，策略以主體的形式表示。主體格式為'MSP.ROLE'， MSP代表所要求的MSPID， ROLE表示角色，一共有四種合法角色：member, admin, client, peer。
背書策略的語法
背書策略的語法如下：
EXPR(E[, E...])
EXPR可以是AND、OR、OutOf，E可以是一個上面示例的主體或者是另一個嵌套的EXPR策略。示例如下：
AND('Org1.member', 'Org2.member', 'Org3.member') ：要求三個主體中每一個主體都要簽名。
OR('Org1.member', 'Org2.member') ：要求三個主體中至少有一個主體簽名。
OR('Org1.member', AND('Org2.member', 'Org3.member'))：要求同時有主體Org1.member的簽名，以及主體Org2.member與Org3.member中至少一個主體的簽名。
OutOf(2, 'Org1.member', 'Org2.member', 'Org3.member') ：要求三個主體中，至少有兩個主體簽名。
背書策略的新特性
鏈碼級別的背書策略綁定到相關(guān)鏈碼的生命周期中，它只可以在鏈碼初始化時候設(shè)置，或者在升級鏈碼時候更新。在fabric1.3版本中，對背書策略進行了優(yōu)化，增加了背書策略的靈活性。允許針對key設(shè)置背書策略，key級別背書策略的設(shè)置可以在鏈碼中動態(tài)操作?；趉ey級的背書策略修改會保存在正常交易的讀寫集中。
如果沒有設(shè)置基于鍵級別的背書策略的話，使用的是鏈碼級別的背書策略。設(shè)置基于鍵級的背書策略的請求，需要滿足當前的背書策略。
基于鍵值背書策略的應(yīng)用
shim包提供了以下的函數(shù)設(shè)置或者恢復鍵對應(yīng)的背書策略。下面的ep代表是“endorsement policy”的縮寫。
SetStateValidationParameter(key string, ep []byte) error
GetStateValidationParameter(key string) ([]byte, error)
以上兩個函數(shù)是設(shè)置交易中鍵級背書策略的函數(shù)，針對私有信息中鍵級別的背書策略用一下兩個函數(shù)進行設(shè)置。
SetPrivateDataValidationParameter(collection, key string, ep []byte) error
GetPrivateDataValidationParameter(collection, key string) ([]byte, error)
為了幫助設(shè)置背書策略和將背書策略序列化為有效的字節(jié)格式的參數(shù)，shim包提供了便利的接口。
type KeyEndorsementPolicy interface {
// Policy returns the endorsement policy as bytes
Policy() ([]byte, error)
// AddOrgs adds the specified orgs to the list of orgs that are required
// to endorse
AddOrgs(roleType RoleType, organizations ...string) error
// DelOrgs delete the specified channel orgs from the existing key-level endorsement
// policy for this KVS key. If any org is not present, an error will be returned.
DelOrgs(organizations ...string) error
// ListOrgs returns an array of channel orgs that are required to endorse changes
ListOrgs() ([]string)
}
基于鍵級別背書策略的使用示例
此部分主要介紹了如何如何在鏈碼（chaincode）中設(shè)置鍵級別的背書策略。
示例鏈碼主要實現(xiàn)并使用了一下三個接口：
query：查詢
endorsement： 設(shè)置背書策略
add：賬戶添加額度
鏈碼的工程代碼已經(jīng)上傳到git上，需要測試的話可以去git下載，git地址：https://github.com/suchongming/keylevelep
以下部分是測試的過程，測試環(huán)境共運行兩個組織Org1和Org2，鏈碼的背書策略AND('Org1.member', 'Org2.member')：
- 開始時候賬戶a余額為100
root@42ffceeab24e:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
100
- 賬戶a向余額添加10，向org1和org2同時背書，a余額為110，交易成功
root@4318321f14d0:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode invoke -o orderer.example.com:7050 -C mychannel -n mycc --peerAddresses peer0.org1.example.com:7051 --peerAddresses peer1.org2.example.com:7051 -c '{"Args":["add","a","10"]}'
2019-06-03 08:50:16.772 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 001 Chaincode invoke successful. result: status:200
root@4318321f14d0:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
110
- 賬戶a余額添加10，僅向org1背書，a余額為110，交易失敗
root@a0b46d997084:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode invoke -o orderer.example.com:7050 -C mychannel -n mycc --peerAddresses peer0.org1.example.com:7051 -c '{"Args":["add","a","10"]}'
2019-06-04 01:24:39.195 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 001 Chaincode invoke successful. result: status:200
root@a0b46d997084:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
110
- 修改賬戶a的背書策略為AND('Org1.member'),然后賬戶a余額添加10，僅向org1背書，a余額為120，交易成功
root@a0b46d997084:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode invoke -o orderer.example.com:7050 -C mychannel -n mycc --peerAddresses peer0.org1.example.com:7051 --peerAddresses peer0.org2.example.com:7051 -c '{"Args":["endorsement","a","Org1MSP"]}'
2019-06-04 01:24:27.752 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 001 Chaincode invoke successful. result: status:200
root@a0b46d997084:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode invoke -o orderer.example.com:7050 -C mychannel -n mycc --peerAddresses peer0.org1.example.com:7051 -c '{"Args":["add","a","10"]}'
2019-06-04 01:24:39.195 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 001 Chaincode invoke successful. result: status:200
root@a0b46d997084:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
120
