#dbus #password #linux #secret-service

dbus-secret-service

通过 DBUS 与 Secret Service API 交互的库

5 个版本 (3 个稳定版)

4.0.2 2024 年 7 月 23 日
4.0.1 2024 年 7 月 10 日
4.0.0 2024 年 7 月 6 日
4.0.0-rc.22024 年 7 月 5 日

#157认证

Download history 71/week @ 2024-06-29 450/week @ 2024-07-06 434/week @ 2024-07-13 5400/week @ 2024-07-20 4177/week @ 2024-07-27 4874/week @ 2024-08-03 5845/week @ 2024-08-10 7344/week @ 2024-08-17

每月 23,262 次下载
17 个 Crates 中使用(通过 keyring

MIT/Apache

87KB
1.5K SLoC

dbus-secret-service

build dependencies crates.io docs.rs

此 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许可证定义,您有意提交以包含在本作品中的任何贡献,应按照上述双重许可,不附加任何额外条款或条件。

依赖

~8MB
~167K SLoC