Struct NSSKeyManager

pub struct NSSKeyManager { /* private fields */ }

Use the NSSKeyManager to use NSS for key management.

NSS stores keys in key4.db within the profile and wraps the key with a key derived from the primary password, if set. It defers to the provided PrimaryPasswordAuthenticator implementation to handle user authentication. Note that if no primary password is set, the wrapping key is deterministically derived from an empty string.

Make sure to initialize NSS using ensure_initialized_with_profile_dir before creating a NSSKeyManager.

Examples

use std::sync::Arc;
use async_trait::async_trait;
use logins::{PrimaryPasswordAuthenticator, LoginsApiError, NSSKeyManager};
use logins::encryption::KeyManager;

struct MyPrimaryPasswordAuthenticator {}

#[async_trait]
impl PrimaryPasswordAuthenticator for MyPrimaryPasswordAuthenticator {
    async fn get_primary_password(&self) -> Result<String, LoginsApiError> {
        // Most likely, you would want to prompt for a password.
        // let password = prompt_string("primary password").unwrap_or_default();
        Ok("secret".to_string())
    }

    fn on_authentication_success(&self) {
        println!("success");
    }

    fn on_authentication_failure(&self) {
        println!("this did not work, please try again:");
    }
}
let key_manager = NSSKeyManager::new(Arc::new(MyPrimaryPasswordAuthenticator {}));
assert_eq!(key_manager.get_key().unwrap().len(), 63);

Implementations

impl NSSKeyManager

pub fn new( primary_password_authenticator: Arc<dyn PrimaryPasswordAuthenticator>, ) -> Self

Initialize new NSSKeyManager with a given PrimaryPasswordAuthenticator. There must be a previous initializiation of NSS before initializing NSSKeyManager, otherwise this panics.

Trait Implementations

impl KeyManager for NSSKeyManager

fn get_key(&self) -> ApiResult<Vec<u8>>

impl<UT> LiftRef<UT> for NSSKeyManager

type LiftType = Arc<NSSKeyManager>

impl<UT> LowerError<UT> for NSSKeyManager

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for NSSKeyManager

type ReturnType = <Arc<NSSKeyManager> as LowerReturn<UniFfiTag>>::ReturnType

The type that should be returned by scaffolding functions for this type.

fn lower_return(obj: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for NSSKeyManager

const TYPE_ID_META: MetadataBuffer = _