10 unstable releases (4 breaking)

0.5.0 Feb 24, 2024
0.4.0 Aug 1, 2023
0.3.0 Feb 25, 2023
0.2.0 Oct 27, 2022
0.1.3 Feb 9, 2022

#66 in Authentication

Download history 677/week @ 2023-12-22 1271/week @ 2023-12-29 2141/week @ 2024-01-05 844/week @ 2024-01-12 1154/week @ 2024-01-19 1117/week @ 2024-01-26 1214/week @ 2024-02-02 905/week @ 2024-02-09 863/week @ 2024-02-16 1091/week @ 2024-02-23 804/week @ 2024-03-01 1024/week @ 2024-03-08 592/week @ 2024-03-15 683/week @ 2024-03-22 569/week @ 2024-03-29 448/week @ 2024-04-05

2,420 downloads per month

MIT license

320KB
8K SLoC

libsecret-rs

The Rust bindings of libsecret.

Documentation


lib.rs:

Rust Libsecret bindings

This library contains safe Rust bindings for Libsecret, a library that offers access to the Secret Service API.

See also

Usage

You can add libsecret by adding it in your Cargo.toml file:

[dependencies.secret]
package = "libsecret"
version = "0.x.y"

Define a password schema

Each stored password has a set of attributes which are later used to lookup the password. The names and types of the attributes are defined in a schema. The schema is usually defined once globally. Here’s how to define a schema:

let mut attributes = std::collections::HashMap::new();
attributes.insert("number", libsecret::SchemaAttributeType::Integer);
attributes.insert("string", libsecret::SchemaAttributeType::String);
attributes.insert("even", libsecret::SchemaAttributeType::Boolean);

let schema = libsecret::Schema::new("some.app.Id", libsecret::SchemaFlags::NONE, attributes);

Store a password

Each stored password has a set of attributes which are later used to lookup the password. The attributes should not contain secrets, as they are not stored in an encrypted fashion.

This first example stores a password asynchronously, and is appropriate for GUI applications so that the UI does not block.

let mut attributes = std::collections::HashMap::new();
attributes.insert("number", "8");
attributes.insert("string", "eight");
attributes.insert("even", "true");

let collection = libsecret::COLLECTION_DEFAULT;
libsecret::password_store_future(Some(&schema), attributes, Some(&collection), "The Label", "the password").await?;

Lookup a password

Each stored password has a set of attributes which are used to lookup the password. If multiple passwords match the lookup attributes, then the one stored most recently is returned.

This first example looks up a password asynchronously, and is appropriate for GUI applications so that the UI does not block.

let mut attributes = std::collections::HashMap::new();
attributes.insert("number", "8");
attributes.insert("even", "true");

let password = libsecret::password_lookup_future(Some(&schema), attributes).await?;

Remove a password

Each stored password has a set of attributes which are used to find which password to remove. If multiple passwords match the attributes, then the one stored most recently is removed.

This first example removes a password asynchronously, and is appropriate for GUI applications so that the UI does not block.

let mut attributes = std::collections::HashMap::new();
attributes.insert("number", "8");
attributes.insert("even", "true");

libsecret::password_clear_future(Some(&schema), attributes).await?;

Dependencies

~7–16MB
~228K SLoC