fabric-ca 搭建sdk使用

本文档详细介绍了如何搭建和使用Fabric-CA服务,包括前置条件、安装步骤、设置HOME目录、启动服务器、SDK代码实现、CA注册流程、用OpenSSL校验证书以及常见错误解决方案。特别强调了证书匹配、TLS配置以及CSR选项的重要性。

首发于个人博客

前置条件

  • unbuntu 18.04
  • fabric-ca-server 1.4.6

安装

  • 源码安装
  • 二进制安装

我直接用二进制,方便点。
hyperledger-fabric-ca-linux-amd64-1.4.6.tar.gz下载地址

下载完后得到

 bin/
├── fabric-ca-client
└── fabric-ca-server

将这两个可执行文件加入环境变量 PATH.

设置fabric ca server的HOME目录

1.通过 --home参数设置
2.如果设置了FABRIC_CA_SERVER_HOME环境变量,则使用该环境变量作为主文件夹。
3.如果设置了FABRIC_CA_HOME环境变量,则使用该环境变量作为主文件夹。
4.如果设置了CA_CFG_PATH环境变量,则使用该环境变量作为主文件夹。
如果以上方法都没有设置,则将当前工作目录作为主文件夹。

启动fabric-ca-server

直接运行

fabric-ca-server start -b admin:adminpw --tls.enabled

因为tls证书问题,请运行下面这条命令

fabric-ca-server start -b admin:adminpw --tls.enabled --csr.hosts 192.168.128.129

打印如下日志。

2020/04/27 01:51:57 [INFO] Created default configuration file at /home/t/ca02_demo/fabric-ca-server-config.yaml
2020/04/27 01:51:57 [INFO] Starting server in home directory: /home/t/ca02_demo
2020/04/27 01:51:57 [INFO] Server Version: 1.4.6
2020/04/27 01:51:57 [INFO] Server Levels: &{Identity:2 Affiliation:1 Certificate:1 Credential:1 RAInfo:1 Nonce:1}
2020/04/27 01:51:57 [WARNING] &{69 The specified CA certificate file /home/t/ca02_demo/ca-cert.pem does not exist}
2020/04/27 01:51:57 [INFO] generating key: &{A:ecdsa S:256}
2020/04/27 01:51:57 [INFO] encoded CSR
2020/04/27 01:51:57 [INFO] signed certificate with serial number 596481663851329572374858418792394216370550593268
2020/04/27 01:51:57 [INFO] The CA key and certificate were generated for CA
2020/04/27 01:51:57 [INFO] The key was stored by BCCSP provider 'SW'
2020/04/27 01:51:57 [INFO] The certificate is at: /home/t/ca02_demo/ca-cert.pem
2020/04/27 01:51:58 [INFO] Initialized sqlite3 database at /home/t/ca02_demo/fabric-ca-server.db
2020/04/27 01:51:58 [INFO] The issuer key was successfully stored. The public key is at: /home/t/ca02_demo/IssuerPublicKey, secret key is at: /home/t/ca02_demo/msp/keystore/IssuerSecretKey
2020/04/27 01:51:58 [INFO] Idemix issuer revocation public and secret keys were generated for CA ''
2020/04/27 01:51:58 [INFO] The revocation key was successfully stored. The public key is at: /home/t/ca02_demo/IssuerRevocationPublicKey, private key is at: /home/t/ca02_demo/msp/keystore/IssuerRevocationPrivateKey
2020/04/27 01:51:58 [INFO] Home directory for default CA: /home/t/ca02_demo
2020/04/27 01:51:58 [INFO] Operation Server Listening on 127.0.0.1:9443
2020/04/27 01:51:58 [INFO] generating key: &{A:ecdsa S:256}
2020/04/27 01:51:58 [INFO] encoded CSR
2020/04/27 01:51:58 [INFO] signed certificate with serial number 329534585106560547893187291685042549776140207184
2020/04/27 01:51:58 [INFO] Listening on https://0.0.0.0:7054

我开启了tls,https服务已启动。

好像旧版本需要 运行初始化这个命令。

fabric-ca-server init -b admin:adminpw

得到目录结构

├── ca-cert.pem    CA根证书
├── fabric-ca-server-config.yaml  自动生成的一个配置
├── fabric-ca-server.db      存储CA服务器的用户名,密码。默认用sqllite3,刚刚的admin,adminpw就存在这
├── IssuerPublicKey                    零时证明文件,不知有啥用
├── IssuerRevocationPublicKey      零时证明文件,不知有啥用
├── msp
│   ├── cacerts
│   ├── keystore     这里存放的私钥,暂时没用到。一个是根证书的,有一个应该是tls-cert的。
│   │   ├── 251d980426e6406042f82553d123dd640ac3b63faaba490430eb73b8f023d840_sk
│   │   ├── fabeb56f55f65503c1ec6e91c8163b29607a51d710c5afb65dd62efd93918455_sk
│   │   ├── IssuerRevocationPrivateKey
│   │   └── IssuerSecretKey
│   ├── signcerts
│   └── user
└── tls-cert.pem   tls加密通信根证书。不加--tls.enable不会生成。

sdk代码

主要代码。

 //设置 ca tls根证书,需在ca-server 开启--tls-enable.
        Properties properties = new Properties(
### 如何使用 Java SDK 搭建 Hyperledger Fabric 区块链网络 #### 1. 准备工作 为了构建基于 Hyperledger Fabric区块链网络并集成 Java SDK,需要先完成必要的准备工作。这包括设置开发环境以及初始化 Fabric 测试网络。 - 需要安装 Docker 和 Docker Compose 来运行 Fabric 网络节点和服务[^2]。 - 下载 `fabric-samples` 并通过命令启动基础测试网络[^4]。 ```bash curl -sSL https://bit.ly/2ysbOFE | bash -s -- 2.5.0 cd fabric-samples/test-network ./network.sh up createChannel -c mychannel -ca ``` 上述脚本会部署一个带有 CA(证书颁发机构)、两个组织和四个对等节点的基础 Fabric 网络。 --- #### 2. 创建 Java 工程 创建一个新的 Maven 或 Gradle 工程,并导入所需的依赖项。以下是典型的 `pom.xml` 文件中的依赖配置: ```xml <dependencies> <!-- Fabric Gateway Java --> <dependency> <groupId>org.hyperledger.fabric-gateway</groupId> <artifactId>fabric-gateway-java</artifactId> <version>2.2.10</version> </dependency> <!-- JSON Processing --> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.13.3</version> </dependency> </dependencies> ``` 此部分描述了如何在 Java 中引入官方支持的 Fabric Gateway SDK[^1]。 --- #### 3. 实现连接逻辑 编写代码来建立与 Fabric 网络的连接。以下是一个简单的示例程序,展示如何加载网络配置文件并与通道交互: ```java import org.hyperledger.fabric.gateway.Gateway; import java.nio.file.Path; public class FabricConnection { public static void main(String[] args) throws Exception { Path networkConfigPath = Path.of("src/main/resources/network-config.yaml"); try (Gateway gateway = Gateway.connect( Gateway.ConnectionOptions.builder() .identity("user1", "src/main/resources/org1/wallet/user1.pem") // 加载身份 .networkConfig(networkConfigPath.toString()) // 设置网络配置路径 .build())) { System.out.println("Connected to the blockchain network."); var contract = gateway.getNetwork("mychannel").getContract("basic"); // 获取指定通道上的合约实例 byte[] result = contract.submitTransaction("queryAllAssets"); // 调用智能合约函数 System.out.println(new String(result)); } } } ``` 这段代码展示了如何利用 `fabric-gateway-java` 库连接到 Fabric 网络并调用智能合约功能。 --- #### 4. 处理错误情况 当遇到常见问题时,可以参考文档解决。例如,在 IDE 中调试可能涉及类路径冲突或其他兼容性问题。建议按照以下方式排查: - 确认所有依赖版本一致。 - 如果发生签名验证失败,则重新生成钱包密钥或更新 TLS 配置[^3]。 --- #### 5. 自定义智能合约 如果希望扩展默认的功能集,可以通过 Java 编写自定义智能合约。下面列出了基本流程: 1. **设计业务逻辑**:确定数据模型及其操作接口。 2. **编码实现**:遵循 Chaincode API 定义交易处理器。 3. **编译打包**:将 `.jar` 文件上传至目标 Peer 节点上。 4. **生命周期管理**:依次执行安装、批准及提交步骤以激活新合约。 --- #### 总结 以上介绍了从零开始搭建 Hyperledger Fabric 区块链网络的过程,重点在于结合 Java SDK 提供的强大工具简化跨平台协作体验。无论是初学者还是高级开发者都能从中受益匪浅。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值