5 个版本 (3 个稳定版)
4.0.2 | 2024 年 7 月 23 日 |
---|---|
4.0.1 | 2024 年 7 月 10 日 |
4.0.0 | 2024 年 7 月 6 日 |
4.0.0-rc.2 | 2024 年 7 月 5 日 |
#157 在 认证
每月 23,262 次下载
在 17 个 Crates 中使用(通过 keyring)
87KB
1.5K SLoC
dbus-secret-service
此 crate 是对 hwchen/secret-service crate 的仿制,目前版本为 4,使用 zbus 访问秘密服务。此 crate 的基本集合、项目和搜索 API 设计得与基于 zbus 的 crate 中的阻塞 API 相同。如果它们不相同,请提交一个错误报告。
为什么要仿制?这样编写同步 Rust 应用(通常通过 hwchen/keyring crate)来访问秘密服务的人就不需要添加异步运行时。因为这个仿制品使用 lib-dbus,所以不需要异步运行时。
为什么这个 crate 从版本 4 开始?因为它与基于 dbus 的 crate 的特定版本匹配,所以我认为其版本号应该与该版本号匹配。
用法
有关代码用法的示例,请参阅 文档。
此 crate 没有默认功能,运行时不需要任何功能。如果您需要将秘密在前往和离开秘密服务的过程中加密,则可以添加加密功能之一
crypto-rust
使用纯 Rust crate 进行加密。crypto-openssl
使用 openssl 库进行加密(必须安装)。
有关如何指定加密会话的详细信息,请参阅 文档。
要 构建 使用此 crate 的项目,您的开发机器需要安装 dbus 开发头文件,以及 crypto-openssl
功能的 openssl 开发头文件。要 运行 使用此 crate 的应用程序,您的机器需要安装 libdbus
(几乎所有都安装了),以及 crypto-openssl
功能的 openssl 库。如果您想避免这种运行时要求,您可以在构建时指定 vendored
功能:这将静态链接所需的库与您的可执行文件链接在一起。
功能
- SecretService: 初始化 dbus,创建明文/加密会话。
- 集合:创建、删除、搜索。
- 项目:创建、删除、搜索、获取/设置秘密。
变更日志
v4.0.0:第一个版本,API 与 secret-service v4.0 相同。
许可
本仓库中所有材料的版权属于将材料存入本仓库的贡献者集体。
本仓库中的所有材料均受以下任一许可协议的许可:
- Apache许可证,版本2.0,(LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
- MIT许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)
由您选择。
贡献
除非您明确声明,否则根据Apache-2.0许可证定义,您有意提交以包含在本作品中的任何贡献,应按照上述双重许可,不附加任何额外条款或条件。
依赖
~8MB
~167K SLoC