區塊鏈教程Fabric1.0源代碼分析MSP成員關係服務提供者一

Fabric 1.0源代碼筆記 之 MSP（成員關係服務提供者）

1、MSP概述

MSP，全稱Membership Service Provider，即成員關係服務提供者，作用爲管理Fabric中的衆多參與者。

成員服務提供者（MSP）是一個提供抽象化成員操作框架的組件。
MSP將頒發與校驗證書，以及用戶認證背後的所有密碼學機制與協議都抽象了出來。一個MSP可以自己定義身份，以及身份的管理（身份驗證）與認證（生成與驗證簽名）規則。
一個Hyperledger Fabric區塊鏈網絡可以被一個或多個MSP管理。

MSP的核心代碼在msp目錄下，其他相關代碼分佈在common/config/msp、protos/msp下。目錄結構如下：

• msp目錄
      * msp.go，定義接口MSP、MSPManager、Identity、SigningIdentity、IdentityDeserializer。

    * mspimpl.go，實現MSP接口，即bccspmsp。
    * mspmgrimpl.go，實現MSPManager接口，即mspManagerImpl。
    * identities.go，實現Identity、SigningIdentity接口，即identity和signingidentity。
    * configbuilder.go，提供讀取證書文件並將其組裝成MSP等接口所需的數據結構，以及轉換配置結構體（FactoryOpts->MSPConfig）等工具函數。
    * cert.go，證書相關結構體及方法。
    * mgmt目錄
        * mgmt.go，msp相關管理方法實現。
        * principal.go，MSPPrincipalGetter接口及其實現，即localMSPPrincipalGetter。
        * deserializer.go，DeserializersManager接口及其實現，即mspDeserializersManager。

• common/config/msp目錄
      * config.go，定義了MSPConfigHandler及其方法，用於配置MSP和configtx工具。
• protos/msp目錄，msp相關Protocol Buffer原型文件。

2、核心接口定義

IdentityDeserializer爲身份反序列化接口，同時被MSP和MSPManger的接口嵌入。定義如下：

type IdentityDeserializer interface {
    DeserializeIdentity(serializedIdentity []byte) (Identity, error)
}
//代碼在msp/msp.go

MSP接口定義：

type MSP interface {
    IdentityDeserializer //需要實現IdentityDeserializer接口
    Setup(config *msp.MSPConfig) error //根據MSPConfig設置MSP實例
    GetType() ProviderType //獲取MSP類型，即FABRIC
    GetIdentifier() (string, error) //獲取MSP名字
    GetDefaultSigningIdentity() (SigningIdentity, error) //獲取默認的簽名身份
    GetTLSRootCerts() [][]byte //獲取TLS根CA證書
    Validate(id Identity) error //校驗身份是否有效
    SatisfiesPrincipal(id Identity, principal *msp.MSPPrincipal) error //驗證給定的身份與principal中所描述的類型是否相匹配
}
//代碼在msp/msp.go

MSPManager接口定義：

type MSPManager interface {
    IdentityDeserializer //需要實現IdentityDeserializer接口
    Setup(msps []MSP) error //用給定的msps填充實例中的mspsMap
    GetMSPs() (map[string]MSP, error) //獲取MSP列表，即mspsMap
}
//代碼在msp/msp.go

Identity接口定義（身份）：

type Identity interface {
    GetIdentifier() *IdentityIdentifier //獲取身份ID
    GetMSPIdentifier() string //獲取MSP ID，即id.Mspid
    Validate() error //校驗身份是否有效，即調取msp.Validate(id)
    GetOrganizationalUnits() []*OUIdentifier //獲取組織單元
    Verify(msg []byte, sig []byte) error //用這個身份校驗消息簽名
    Serialize() ([]byte, error) //身份序列化
    SatisfiesPrincipal(principal *msp.MSPPrincipal) error //調用msp的SatisfiesPrincipal檢查身份與principal中所描述的類型是否匹配
}
//代碼在msp/msp.go

SigningIdentity接口定義（簽名身份）：

type SigningIdentity interface {
    Identity //需要實現Identity接口
    Sign(msg []byte) ([]byte, error) //簽名msg
}
//代碼在msp/msp.go

未完待續感謝關注兄弟連區塊鏈教程分享！