Crate keyring

Source

Expand description

§🔐 keyring-lib

High-level, asynchronous API for keyring-rs, a cross-platform Rust library to manage credentials.

§Features

Uses Secret Service on Linux
Uses the keyutils secure, in-memory Linux kernel cache (if available)
Uses default system security credential on MacOS and Windows
Supports tokio and async-std async runtimes
Supports rustls and openssl crypto libs
Supports serde (de)serialization from/to String

The library comes with 6 cargo features, including 2 default ones:

tokio: enables the tokio async runtime
async-std: enables the async-std async runtime
rustls: enables the rustls crypto
openssl: enables the openssl crypto
derive: enables serde support
vendored: compiles and statically link to a copy of non-Rust vendors like OpenSSL

§Example

use keyring::{set_global_service_name, KeyringEntry};

#[tokio::main]
async fn main() {
    // define the global keyring service name once
    set_global_service_name("example");

    // create a keyring entry from a key string
    let entry = KeyringEntry::try_new("key").unwrap();

    // define a secret
    entry.set_secret("secret").await.unwrap();

    // get a secret
    entry.get_secret().await.unwrap();

    // find a secret
    entry.find_secret().await.unwrap();

    // delete a secret entry
    entry.delete_secret().await.unwrap();
}

See the full API documentation on docs.rs.

§FAQ

Why not using keyring-rs directly?

This library can be seen as a convenient async wrapper around keyring-rs. If you have an async app and just want to have a default keystore for any target OS, then keyring-lib is the right choice. If you do not have an async app, or you want more control over keystores, using keyring-rs is a much better choice.