1. 程式人生 > >區塊鏈教程Fabric1.0源代碼分析MSP成員關系服務提供者一

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

member 區塊鏈 root 組裝 ring conf 目錄 多個 com

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

未完待續感謝關註!

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