Parsec 工具

此仓库包含一个用于通过命令行与 Parsec 服务 通信的工具。

入门

编译并列出可用的命令

$ cargo build
$ cargo run

ping 服务

$ cargo run -- ping

修改 Parsec 服务端点

为了演示和测试 Parsec 服务，您可能需要更改 Parsec 端点位置。为此，将 PARSEC_SERVICE_ENDPOINT 环境变量设置为正确的端点。

将 Unix 域套接字监听器端点设置为 /tmp/parsec.sock

$ export PARSEC_SERVICE_ENDPOINT=unix:/tmp/parsec.sock

修改日志输出

您可以通过设置 RUST_LOG 环境变量来修改日志输出。有关更多信息，请参阅 文档。

数据格式

除非以下另有说明，否则命令期望的数据格式与在 Parsec 书籍 中描述的相同。命令的 --help 选项可能会提供有关预期格式的更多信息。

• ECDSA 签名使用在 RFC 3279 中描述的 ASN.1 表示法 Ecdsa-Sig-Value 进行格式化。
• 明文数据期望/显示为 UTF-8 字符串（sign 的输入数据，decrypt 的输出数据）。
• 密文数据期望/显示为 base64（sign 的输出数据，decrypt 的输入数据）。
• 导出的公钥以PEM格式编码。默认情况下，RSA公钥使用PKCS#8格式（RFC 3279）和ECC公钥使用PKCS#8格式（RFC 5480）。使用--pkcs1参数可以将RSA密钥以PKCS#1格式导出（RFC 2313）。

基于SPIFFE的认证器

要使用JWT-SVID认证器进行认证，请使用spiffe-auth特性编译此crate。

演示

可以使用tests/parsec-cli-tests.sh通过parsec-tool进行端到端Parsec测试。

许可协议

本软件在Apache-2.0许可协议下提供。对本项目的贡献也接受相同的许可协议。

贡献

请查阅贡献指南以了解更多关于贡献过程的信息。

版权所有 2020 Parsec项目贡献者。