Hyperledger Fabric v1.4 客户端创建通道报KeyMaterial not found错误
Hyperledger Fabric v1.4 通道创建报错排查指引
问题背景
- 集群运行Hyperledger Fabric v1.4,所有实体证书均通过openssl ec命令生成,仅调整不同实体的OU、CN字段,peer、orderer节点已正常达成共识
- 客户端使用fabric-tools 1.4.11镜像,执行
peer channel create -o "orderer1.xxxx.eastus.aksapp.io" -c "mychannel" -f ./channel.tx --tls --cafile "/var/hyperledger/peer/tls/chain.crt" --clientauth --certfile /var/hyperledger/peer/tls/admintls.crt --keyfile /var/hyperledger/peer/tls/admintls.key命令时,报错:
2021-03-25 18:59:05.672 UTC [main] InitCmd -> ERRO 001 Cannot run peer because error when setting up MSP of type bccsp from directory /var/hyperledger/peer/msp: KeyMaterial not found in SigningIdentityInfo
- 当前MSP目录结构符合官方规范:
/var/hyperledger/peer/msp下包含admincerts、cacerts、intermediatecerts、tlscacerts、tlsintermediatecerts、signcerts、keystore目录,均已配置对应证书/私钥/var/hyperledger/peer/tls下存放TLS相关证书、私钥及CA链
- 已完成私钥格式校验、MSP目录权限调整、orderer双向TLS开关切换、证书后缀修改等操作均未解决问题;自行生成的证书无
hf.EnrollmentID、hf.Type、hf.Affiliation扩展属性,不确定是否为诱因
核心结论
hf.EnrollmentID、hf.Type、hf.Affiliation这类扩展属性仅为Fabric CA签发时的附加属性,手动openssl生成的标准x509证书缺失这些属性完全不影响MSP初始化,可直接排除该诱因。
按优先级排序的排查步骤
- 校验签名证书与私钥是否配对
Fabric v1.4的MSP初始化逻辑为:先从signcerts目录读取签名证书,再到keystore目录匹配对应私钥,二者不配对会直接触发该报错。可执行以下命令对比公钥哈希:- 提取私钥公钥哈希:
openssl ec -in /var/hyperledger/peer/msp/keystore/admin.key -pubout | sha256sum - 提取证书公钥哈希:
openssl x509 -in /var/hyperledger/peer/msp/signcerts/admin.crt -pubkey | sha256sum
两个输出值完全一致才是有效配对。
- 提取私钥公钥哈希:
- 转换EC私钥格式兼容旧版bccsp
你当前使用的私钥为PKCS8格式(文件头为-----BEGIN PRIVATE KEY-----),Fabric v1.4内置的bccsp模块对该格式的EC私钥解析存在已知兼容问题,需转换为SEC1格式(文件头为-----BEGIN EC PRIVATE KEY-----):- 执行转换:
openssl ec -in admin.key -out admin_ec.key - 替换
/var/hyperledger/peer/msp/keystore/下的原私钥后重试命令。
- 执行转换:
- 校验MSP目录的路径与文件规范性
- 确认
CORE_PEER_MSPCONFIGPATH指向的路径无拼写错误,且keystore、signcerts、cacerts三个必填目录存在,路径大小写完全符合要求(Fabric对大小写敏感,不要出现KeyStore这类错误命名) - 确认
signcerts目录下无空文件、非证书类冗余文件,避免bccsp扫描时无法识别有效证书。
- 确认
- 校验证书链完整性
若签名证书由中间CA签发,确认intermediatecerts下的中间证书完整、可被cacerts下的根CA验证,否则bccsp会判定证书无效,同样会触发KeyMaterial找不到的错误。
内容的提问来源于stack exchange,提问作者Ana Franco
相关产品推荐
相关产品推荐

