← COMP5565 全部讲次
L07a-3 · 第 10 周

L07a-3 MSP:网络凭什么认你、把你当成什么角色

CA 只管发证,MSP 决定认哪些 CA、证书持有者是 peer 还是 client、能不能做这件事;MSP 本身是一组文件夹,Local MSP 管一台节点,Channel MSP 管一个 channel。

一句话版

CA 负责发证书,MSP 负责决定网络认不认这张证书、把持有者当成什么角色、允不允许他做这件事。

前两页讲的证书体系是通用的,这一页看 Fabric 怎么在许可链里用它管人。

先认识这几个词

词 全称 / 读法 一句人话
MSP Membership Service Provider,成员服务提供者 一组定义「本组织认谁、谁是什么角色」的文件夹
Fabric CA Fabric 自带的证书颁发机构 组织自己的私有根 CA,给成员发 X.509 证书
ECert Enrollment Certificate,登记证书 代表一个用户或节点身份的证书
OU Organizational Unit,组织单元 证书 Subject 里的一个字段,可写 peer、client 等
NodeOUs 按 OU 认角色的配置 在 config.yaml 里规定哪个 OU 算哪种角色
Local / Channel MSP 本地 MSP / 通道 MSP 前者管一台节点,后者管一个 channel 的成员

一个类比:写字楼的门禁系统

一栋写字楼里有好几家公司。每家公司的人事部给员工发工牌,工牌上印着公司名、部门、职位。人事部就是 CA,工牌就是证书。

光有工牌进不了门。大楼的门禁系统里登记着「认哪几家公司的工牌」「哪个职位能进哪层」。刷卡时,门禁先认这是不是登记过的公司发的,再看职位,最后对照规则决定开不开门。这套门禁登记表就是 MSP。

每家公司办公室门口还有一个小门禁,只管谁能进这间办公室,这是 Local MSP。大楼一层的总门禁记着所有入驻公司,由物业统一维护,这是 Channel MSP。

类比在哪里失效:

  • 工牌可以借给别人刷,证书配着私钥,拿不到私钥就签不出名
  • 大楼门禁表由物业一家说了算,Channel MSP 的修改要经各组织按策略同意、靠共识同步
  • 门禁只决定开不开门,MSP 还会被拿去判断一笔交易的背书算不算数

从零讲起

1. CA 发证,MSP 认人

它解决什么问题

身份由 CA 创建,但光签发出来还不够,还要被网络认可。

设想几家银行合建一个区块链网络。每家银行运行 peer 和排序节点,peer 给交易背书。银行的储户也属于各家组织,但不运行节点,只用手机或网页应用。网络怎么分清:这张证书是哪家银行签的,持有者是节点、管理员还是储户?

直觉

每个组织写一份 MSP,里面说清两件事:本组织认哪个 CA,以及怎么从证书里读出角色。

网络里的成员都知道这份 MSP。看到一张证书,就去对照:签发者对得上,就是这个组织的人;再看证书里的角色字段,决定他是什么身份。

课件有一句话:MSP 实际上不「提供」任何东西。它不是一个跑着的服务,只是一组加进网络配置的文件夹。

一步一步看

目标:用几家银行合建网络的例子走一遍,看出 CA 只负责发证,MSP 才判断持证人属于哪家、是什么角色。

用银行网络走一遍:

  1. 每家银行运行自己的 Fabric CA,给本行的 peer、排序节点、管理员和储户签发证书
  2. 每家银行把自己的 MSP 加进网络配置,写明「本行 CA 的证书是这一张」
  3. 某个储户用手机应用提交交易,交易附上他的证书和签名
  4. 网络里的节点拿这张证书,对照各银行的 MSP,发现签发者是 A 银行的 CA,于是认定他是 A 银行的人
  5. 再从证书的 OU 字段读出他是 client,只能提交交易,不能背书
谁 持什么证书 MSP 认成什么
银行的 peer OU = peer 的证书 peer,可以背书
银行的排序节点 OU = orderer 的证书 orderer
银行的管理员 OU = admin 的证书 admin,可以管网络和 channel
储户 OU = client 的证书 client,可以提交交易

怎么判断

CA 生成证书 + MSP 列出获准的身份 = 网络认识的成员

意思是:只有 CA 没有 MSP,证书签出来没人认;只有 MSP 没有 CA,没有证书可认。MSP 对内让组织决定谁是管理员,对外让别的组织验证某个实体有没有权限。

常见误解

误解:MSP 是一个运行中的认证服务器

MSP 的实现是一组文件夹,加进网络配置里。真正跑着、发证书的是 Fabric CA。验证证书的是各个节点自己,它们读 MSP 里的材料来判断。

试一下

一张证书是真的、签名也验得过,但签发它的 CA 不在任何组织的 MSP 里。网络会认吗?

不会。网络只认 MSP 里登记过的 CA 签的证书。证书本身没问题,但没人为它担保,相当于外来者。

2. MSP 判断一个身份的三步

它解决什么问题

一个节点收到一笔带签名的交易或背书,要决定「接不接受」。这个判断要分几步做,顺序不能乱。

直觉

先确认你是真的,再看你是什么角色,最后查规则允不允许这个角色做这件事。

一步一步看

目标:以一次背书签名为例走完 MSP 的三步,看出认证身份、识别角色、评估策略各查什么,任何一步不过就拒绝。

MSP 的三步从左到右:先沿证书链核对受信 CA 并验数字签名,再用 NodeOUs 识别身份是 peer、admin 还是 client,最后对照 channel 或 chaincode 策略得出接受或拒绝

以背书签名为例:

  1. peer 用自己的私钥对交易做数字签名,这就是背书
  2. 第一步认证身份:接收方沿证书链核对,这个 peer 的证书是不是本组织 MSP 里受信的 CA 签的
  3. 用 peer 证书里的公钥验交易上的签名,确认确实是它签的、内容没被改
  4. 第二步识别角色:按 NodeOUs 读证书的 OU,确认它是 peer
  5. 第三步评估策略:对照 channel 或 chaincode 的背书策略,看这个组织的 peer 背书算不算数
  6. 三步都过,接受;任何一步不过,拒绝

怎么判断

接受 = 证书来自受信 CA 且签名验得过 ∧ 角色对得上 ∧ 策略允许

意思是:三步是递进的。第一步回答「你是谁」,第二步回答「你是什么」,第三步回答「你能不能做」。私钥只在签名方手里,验证方从头到尾只用证书。

常见误解

误解:签名验得过就可以接受背书

签名验得过只完成了第一步。还要确认签名者的角色是 peer,并且背书策略允许它的组织背书。一个 client 的签名哪怕验得过,也不能当作背书。

试一下

一张 OU = client 的证书,签名验得过,它的持有者能为交易背书吗?

不能。第二步识别出它是 client,背书需要 peer 角色。在第二步或第三步就会被拒绝。

3. msp 文件夹和 NodeOUs

它解决什么问题

前面说 MSP 是一组文件夹。具体放了什么?角色又是从哪里读出来的?

直觉

一个 msp 目录放五样东西:本组织 CA 的证书、中间 CA 的证书、自己的证书、自己的私钥、一个配置文件。

角色写在证书的 OU 字段里。配置文件里打开 NodeOUs,规定「某个 CA 签的、OU 写着 peer 的证书,算 peer」。

一步一步看

目标:逐项打开 msp 文件夹,看出每个子目录放什么、哪一项只留本地,角色又是从 config.yaml 的 NodeOUs 读出来的。

msp 目录下五项:cacerts 放组织 CA 证书,intermediatecerts 放中间 CA 证书,signcerts 放自己的证书,keystore 放私钥且只留本地,config.yaml 配置 NodeOUs

  1. cacerts/:组织 CA 的证书,用来验证本组织的身份
  2. intermediatecerts/:CA 有层级时,放中间 CA 的证书
  3. signcerts/:这个身份自己的登记证书,peer、admin 或 client 的都放这里
  4. keystore/:证书对应的私钥,只留在本地,不共享
  5. config.yaml:MSP 配置文件,在这里写 NodeOUs

课件给的 config.yaml 里,NodeOUs 的写法是这样的:

配置项 Certificate OrganizationalUnitIdentifier
ClientOUIdentifier cacerts/localhost-8054-ca-org2.pem client
PeerOUIdentifier cacerts/localhost-8054-ca-org2.pem peer
AdminOUIdentifier cacerts/localhost-8054-ca-org2.pem admin
OrdererOUIdentifier cacerts/localhost-8054-ca-org2.pem orderer

怎么判断

被认成某角色 = 签发 CA 与配置里的 Certificate 一致 ∧ 证书 OU 与 OrganizationalUnitIdentifier 一致

意思是:两个条件都要对上。OU 写着 peer,但签发者是别的组织的 CA,照样不算这个组织的 peer。

三类最常用的 OU 各有用途:peer 用于身份认证和交易背书,admin 用于网络管理和 channel 操作,client 用于向网络提交交易。

常见误解

误解:整个 msp 文件夹都可以复制给别的组织

cacerts、intermediatecerts、signcerts 和 config.yaml 是公开材料,可以给。私钥目录一旦交出去,别人就能冒充这个身份签名。

试一下

两张证书 OU 都是 peer,一张由 localhost-8054-ca-org2 签发,另一张由别的组织的 CA 签发。按上表的配置,各算什么?

前者被这个组织的 MSP 认成 peer。后者签发 CA 对不上,不会被认成这个组织的任何角色。

4. Local MSP 和 Channel MSP

它解决什么问题

MSP 要回答两类不同的问题。一类是「谁能管理我这台节点」,只跟一台机器有关。另一类是「这个 channel 认哪些组织、谁能改 channel 配置」,跟 channel 里所有成员有关。

两类问题的范围不同,所以分成两种 MSP。

直觉

Local MSP 属于一个节点或一个用户。每个 peer、orderer、客户端应用都有自己的一份,放在自己的文件系统上,里面有自己签名用的私钥。

Channel MSP 属于一个 channel。它是 channel 配置的一部分,channel 里每个参与组织都必须有一份为它定义的 MSP。它只用来验证身份,不含任何节点的私钥。

一步一步看

目标:按课件里 channel C 的例子分清 Local MSP 和 Channel MSP,看出两者的范围、内容和同步方式有什么不同。

左右两栏对比:左栏 Local MSP 存在 peer P 自己的文件系统,回答谁能管理这台 peer,含自己的私钥;右栏 Channel MSP 是 channel 配置的一部分,列出 ORG1.MSP 和 ORG2.MSP,只有公开材料

按课件的图:channel C 里有 ORG1 和 ORG2,根 CA 分别是 RCA1 和 RCA2,peer P 属于 ORG1。

  1. P 的本地文件系统里存着 ORG1 的 Local MSP:根 CA 证书 RCA1、中间 CA 证书目录、P 自己的私钥
  2. channel C 的配置里有 Channel MSP:ORG1.MSP 和 ORG2.MSP 两份
  3. 每个 peer 都把 channel 策略存一份本地副本,里面同样有 ORG1.MSP 和 ORG2.MSP
  4. ORG2 的 peer 要验 ORG1 用户的签名,查的是自己那份副本里的 ORG1.MSP
  5. 有人要往 channel 里加新组织,改的是 Channel MSP,修改经共识同步到每个节点
对比 Local MSP Channel MSP
作用范围 单个节点或用户 整个 channel,所有参与组织共享
回答什么 谁能管理这台 peer 谁能加组织、改配置、和 channel 账本交互
放在哪 节点自己的文件系统 channel 配置,每个节点存一份副本
含不含私钥 含 不含
怎么保持一致 只有一份,无需同步 靠共识同步

怎么判断

问题只涉及一台机器 → 看 Local MSP;问题涉及 channel 里的多个组织 → 看 Channel MSP

意思是:先问「这件事的影响范围是谁」。管这台 peer 的管理员是谁,是本地问题;某个组织能不能参与这个 channel,是 channel 问题。

常见误解

误解:Channel MSP 放在某个中心服务器上

Channel MSP 是 channel 配置的一部分,在 channel 里每个节点的文件系统上都实例化了一份副本,靠共识保持同步。没有一个中心点存它。

试一下

ORG2 的 peer 验证 ORG1 用户 B 的签名,要不要用到 P 的 Local MSP?

不用。它查自己本地那份 channel 策略副本里的 ORG1.MSP,用其中的 RCA1 验 B 的证书,再用 B 证书里的公钥验签名。P 的 Local MSP 只管 P 自己。

把它们串起来

四个概念回答了同一个问题的不同层次:网络凭什么认你。

CA 发证书,MSP 决定认不认。没有 MSP 登记,证书再真也没人认。

MSP 认人分三步:沿证书链认证身份,按 NodeOUs 识别角色,对照策略决定接受或拒绝。背书签名的校验就是这三步的典型用法。

MSP 落到磁盘上是一个文件夹,五样东西里只有私钥不能离开本机。角色写在证书的 OU 里,由 config.yaml 的 NodeOUs 规定怎么读。

MSP 分两种:Local MSP 管一台节点、含私钥;Channel MSP 管一个 channel、所有成员共享、不含私钥。

还有一种更细的控制叫 ABAC,按属性访问控制。持 ECert 的用户可以带一组附加属性,都是 name/value 对,合约读出属性后据此决定能不能调用某个函数。

课件里的坑

  • [过时] p.64 说 Channel MSP 管「谁能 instantiate chaincode」。instantiate 是 Fabric 1.x 的说法,Fabric 2.x 改用 chaincode lifecycle,各组织 approve 后再 commit 定义(p.64)
  • [读图提醒] p.26 说 ECert「is used as a signed transaction」。签名用的是 ECert 对应的私钥,ECert 随交易附上,供别人验签和识别身份(p.26)
  • [读图提醒] p.60 说 MSP「does not actually provide anything」,指它本身不是一个运行中的服务,只是一组配置文件夹;名字里的 Provider 容易让人误会(p.60)

课后 10 分钟

这 10 分钟怎么用:先默写 MSP 三步和 msp 目录的五样东西;再用一句话分别说出 Local MSP 和 Channel MSP 放在哪、含不含私钥;最后做完整例题。

必背

  1. MSP 三步:认证身份(沿证书链查受信 CA、验签名)→ 识别角色(NodeOUs)→ 对照 channel 或 chaincode 策略决定接受或拒绝
  2. CA 生成代表身份的证书,MSP 列出获准的身份;MSP 本身是一组文件夹:cacerts、intermediatecerts、signcerts、keystore、config.yaml
  3. NodeOUs 用证书的 OU 字段区分角色:peer(认证与背书)、admin(网络管理与 channel 操作)、client(提交交易)、orderer
  4. 背书签名的校验:peer 用私钥签,MSP 确认它来自受信 CA 且有背书资格,再用 peer 证书里的公钥验签名
  5. Local MSP 管单个节点或用户,在节点文件系统上、含签名私钥;Channel MSP 管 channel 级权限,是 channel 配置的一部分、靠共识同步、不含私钥

课件例题

例 1(课件 p.19–20):银行网络怎么区分身份

几家银行运营一个区块链网络,银行运行 peer 和排序节点,储户只用手机或网页应用、不运行节点。网络怎么识别和区分这些身份?

提示

谁发证?谁认证?靠证书里哪个字段分角色?

解答

各银行的 CA 给自己的节点、管理员、储户签发证书。每家银行的 MSP 写明认哪个 CA,网络据此判断证书属于哪家银行。NodeOUs 按证书的 OU 分角色:银行的节点是 peer 或 orderer,管理员是 admin,储户是 client。

例 2(课件 p.24):背书签名怎么被校验

peer 用私钥给交易签名背书。接收方按什么顺序检查?

提示

对照 MSP 三步。

解答

先用 MSP 确认这个 peer 的证书来自受信 CA,并确认它有背书资格;再用 peer 证书里的公钥验交易上的签名。私钥只在 peer 手里,验证方只用证书。

例 3(课件 p.29):按 NodeOUs 配置判角色

config.yaml 里四个角色都指向 cacerts/localhost-8054-ca-org2.pem,OU 分别是 client、peer、admin、orderer。一张由这个 CA 签发、OU 为 peer 的证书算什么?一张由别的 CA 签发、OU 也是 peer 的证书呢?

提示

两个条件都要满足:签发 CA 对得上,OU 对得上。

解答

前者被这个组织的 MSP 识别为 peer。后者签发 CA 不是 localhost-8054-ca-org2,不会被识别成这个组织的任何角色,OU 写什么都没用。8054 是这个 CA 服务的端口号,带进了文件名。

例 4(课件 p.65):Local MSP 和 Channel MSP 各管什么

见下方完整例题。

完整例题

题面:按课件 p.65 的图,channel C 里有 ORG1 和 ORG2,根 CA 分别是 RCA1、RCA2。peer P 属于 ORG1,B 是 ORG1 的用户。channel 策略里有 ORG1.MSP 和 ORG2.MSP。回答:(1)P 的本地文件系统里存着什么 MSP 材料?(2)ORG2 的一个 peer 收到 B 签名的交易,用哪份材料验?(3)ORG2 想改 channel C 的成员,改的是哪里?

左右两个组织 ORG1 和 ORG2,各有根 CA(RCA1、RCA2)和本地 MSP(ORG1.MSP、ORG2.MSP);各自的 peer P 带账本 L,ORG1 一侧还有用户 B 向 P 发请求;每个 peer 本地文件系统存本组织 MSP 的根 CA 和中间 CA 目录;两 peer 连到 channel C,下方 channel 策略里有全局 MSP 两份,并以虚线实例化成两侧 peer 的本地副本
图片来源:COMP5565 Lecture 7.pdf, p.65

解法:

  1. P 的本地有 ORG1 的 Local MSP,里面有根 CA 证书 RCA1、中间 CA 证书目录,以及 P 自己的签名私钥。它只回答「谁能管理 P 这台节点」
  2. 每个 peer 都把 channel 策略存了一份本地副本,里面有 ORG1.MSP 和 ORG2.MSP
  3. ORG2 的 peer 收到 B 的交易,查自己那份副本里的 ORG1.MSP,用其中的 RCA1 沿证书链验 B 的证书,再用 B 证书里的公钥验签名。然后按 NodeOUs 确认 B 是 client,最后对照策略决定接受或拒绝
  4. 这一步用不到 B 的私钥,也用不到 P 的 Local MSP
  5. 改 channel 成员是改 Channel MSP,属于 channel 配置更新,要经共识同步到所有节点,不能只改某一台 peer 的本地文件

要点:验别的组织的人,查 Channel MSP 副本;管自己这台节点,看 Local MSP;私钥只在 Local MSP 里。

变式题

1. 一张证书 Subject 为 O Hyperledger、OU orderer、CN orderer0,Issuer 为 CN ca.org1.example.com。org1 的 config.yaml 开了 NodeOUs,OrdererOUIdentifier 指向 ca.org1.example.com 的证书。这张证书在 MSP 眼里是什么角色?如果它的 Issuer 换成另一个组织的 CA 呢?这个排序节点要加入 org2 也在的 channel,org2 的节点凭什么认它?(改编自课件 p.29、p.61–65)

提示

先看签发 CA 对不对得上,再看 OU;跨组织认人看 Channel MSP。

判分点与答案(非官方评分标准)

签发 CA 与配置一致、OU 为 orderer,被识别为 org1 的 orderer。Issuer 换成别的组织的 CA,org1 的 MSP 不认,不算 org1 的任何角色。org2 的节点查 channel 配置里 org1 的 MSP,用其中的 org1 CA 证书验它的证书。自检:三问各答对一条即算对。

闪卡自测

1. CA 和 MSP 分工有什么不同?

CA 生成代表身份的证书;MSP 列出获准的身份,定义认哪些组织、谁有什么角色(p.21–22、p.60)。

2. MSP 三步是什么?

认证身份、识别角色、评估策略(p.25)。

3. 参与者为什么要有能被网络识别的身份?

参与者要向网络其他成员证明身份才能交易,这个身份必须能被网络识别,这正是 MSP 的作用(p.23)。

4. keystore/ 里放什么?

证书对应的私钥,留在本地、不共享(p.28)。

5. signcerts/ 里放什么?

这个身份自己的登记证书,比如 peer、admin 或 client 的证书(p.28)。

6. 三类 OU 证书各用来做什么?

peer 用于身份认证和交易背书,admin 用于网络管理和 channel 操作,client 用于提交交易(p.27)。

7. 用户在提交交易前必须做什么?

先注册,再从 Fabric CA 拿到 ECert(p.26)。

8. Local MSP 含私钥吗?Channel MSP 呢?

Local MSP 含节点签交易用的私钥;Channel MSP 只做身份验证,不含私钥(p.62、p.64)。

9. Channel MSP 怎么在各节点间保持一致?

它是 channel 配置的一部分,在每个节点上实例化一份,靠共识同步(p.64)。

10. ABAC 靠什么做访问控制?

ECert 附带的 name/value 属性,合约读出属性据此决策(p.59)。

下一讲

L07a-4 Fabric CA 与证书:Fabric CA 自己怎么分工、证书怎么一步步领到手、每类证书过期会出什么事。

下一讲 →
L07a-4 L07a-4 Fabric CA:证书怎么领、哪张过期最要命

个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。