主题
fabric-ca · API 参考
REST 端点
来源:lib/server.go:549-564 + 各 handler 文件。完整路径同时映射到 /{Path} 与 /api/v1/{Path}(lib/server.go:567-570)。
| 端点 | 方法 | 注册 file:line | 成功 RC |
|---|---|---|---|
cainfo | GET / POST / HEAD | lib/serverinfo.go:14-20 | 200 |
register | POST | lib/serverregister.go:23-31 | 201 |
enroll | POST | lib/serverenroll.go:49-57 | 201 |
reenroll | POST | lib/serverenroll.go:59-67 | 201 |
idemix/credential | POST | lib/serveridemixenroll.go:16-24 | 201 |
idemix/cri | POST | lib/serveridemixcri.go:13-21 | 201 |
revoke | POST | lib/serverrevoke.go:36-43 | 200 |
gencrl | POST | lib/servergencrl.go:36-43 | 200 |
identities | GET / POST | lib/serveridentities.go:35-43 | 200 |
identities/{id} | GET / DELETE / PUT | lib/serveridentities.go:25-33 | 200 |
affiliations | GET / POST | lib/serveraffiliations.go:36-44 | 200 |
affiliations/{affiliation} | GET / DELETE / PUT | lib/serveraffiliations.go:26-34 | 200 |
certificates | GET / DELETE | lib/servercertificates.go:26-34 | 200 |
[未核]
- 请求 / 响应 JSON 字段定义(在
api/client.go、api/net.go、api/serverresponses.go)。 - 认证方式(BasicAuth vs TokenAuth)的具体匹配规则与所需身份属性,需读 handler 源码与中间件。
- 各端点的 query 参数(如
?ca=)的实际处理位置 [未核]。
CLI 子命令
fabric-ca-server
入口 cmd/fabric-ca-server/main.go:26-30 → RunMain(os.Args)。cobra rootCmd 在 cmd/fabric-ca-server/servercmd.go:77-90。子命令在 ServerCmd.init() 中注册:init(servercmd.go:93-109,调 Server.Init)、start(servercmd.go:111-127,调 Server.Start)、version(servercmd.go:129-136)。
fabric-ca-client
入口 cmd/fabric-ca-client/main.go:26-30 → command.RunMain(os.Args)。子命令在 ClientCmd.init() 注册(clientcmd.go:153-169):register、enroll、reenroll、revoke、getcainfo(别名 getcacert,见 getcainfo.go:58)、gencsr、gencrl、identity、affiliation、certificate、version。对应实现文件(同 command/ 目录):register.go、enroll.go、reenroll.go、revoke.go、getcainfo.go、gencsr.go、gencrl.go、identity.go、affiliation.go、certificate.go。
[未核]
完整的子命令清单、每个子命令的 flag、environment 变量映射,请运行:
fabric-ca-server --helpfabric-ca-client --help
Go SDK
| 入口包 | 出处 |
|---|---|
github.com/hyperledger/fabric-ca/lib(Server / Client) | README.md:58-68 |
github.com/hyperledger/fabric-ca/api(请求/响应类型:api/client.go、api/net.go、api/serverresponses.go) | 目录存在 |
具体函数签名、字段语义 [未核],请直接看 godoc 或源码。
监听端口
| 项 | 默认值 | 出处 |
|---|---|---|
Port | 7054 | lib/serverconfig.go:16(DefaultServerPort) |
Address | 0.0.0.0 | lib/serverconfig.go:19(DefaultServerAddr) |
Operations / 健康检查端口 [未核]。