Skip to main content

PinLockSystem

Struct PinLockSystem 

Source
pub struct PinLockSystem<'a> {
    client: &'a Client,
}
Expand description

Provides PIN-based unlock functionality. This includes enrolling into PIN-based unlock, unlocking using the PIN and handling necessary operations (PIN envelope refreshing when transitioning to after-first-unlock mode).

Fields§

§client: &'a Client

Implementations§

Source§

impl PinLockSystem<'_>

Source

fn key_store(&self) -> &KeyStore<KeySlotIds>

Source

pub fn with_client(client: &Client) -> PinLockSystem<'_>

Creates a PIN lock system view for a client instance.

Source

async fn get_active_pin_envelope(&self) -> Option<PasswordProtectedKeyEnvelope>

Retrieves the currently active PIN envelope.

If both envelopes are present, the ephemeral envelope is preferred.

Source

pub(crate) async fn unlock(&self, pin: &str) -> Result<(), UnlockError>

Attempts to unlock the user key using pin.

Returns UnlockError::NoPinSet if no PIN is configured, UnlockError::PinWrong if pin is incorrect, and UnlockError::InternalError for other failures.

Source

async fn migrate_pin_envelope_if_needed(&self) -> Result<(), MigrationFailed>

After a V2 upgrade, when a V2 upgrade token is present and the persistent PIN envelope is still encrypted with the V1 user key, this function migrates the persistent PIN enrollment to be encrypted with the current user-key.

Source

pub(crate) async fn on_unlock(&self)

Refreshes in-memory PIN unlock material after a successful non-PIN unlock.

This recreates the ephemeral PIN envelope from the encrypted PIN, when available.

Source

pub async fn set_pin( &self, pin: String, lock_type: PinLockType, ) -> Result<(), ()>

Sets the PIN and stores the generated envelope according to the lock type.

Source

pub async fn unset_pin(&self)

Clears both persistent and ephemeral PIN envelopes.

Source

pub async fn get_pin_lock_type(&self) -> Option<PinLockType>

Returns the lock type for the currently configured PIN.

Source

pub async fn get_pin_status(&self) -> PinUnlockStatus

Returns the current PIN unlock status.

If a lock type is configured but no ephemeral envelope is currently present, the status is PinUnlockStatus::NeedsUnlock.

Source

pub async fn get_pin(&self) -> Option<String>

Returns the configured PIN, if an encrypted PIN is available and decryptable.

Source

pub async fn validate_pin(&self, pin: String) -> bool

Validates that the provided PIN can decrypt the stored PIN envelope.

Auto Trait Implementations§

§

impl<'a> Freeze for PinLockSystem<'a>

§

impl<'a> !RefUnwindSafe for PinLockSystem<'a>

§

impl<'a> Send for PinLockSystem<'a>

§

impl<'a> Sync for PinLockSystem<'a>

§

impl<'a> Unpin for PinLockSystem<'a>

§

impl<'a> UnsafeUnpin for PinLockSystem<'a>

§

impl<'a> !UnwindSafe for PinLockSystem<'a>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
§

impl<T> Any for T
where T: Any,

§

fn into_any(self: Box<T>) -> Box<dyn Any>

§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

§

fn type_name(&self) -> &'static str

§

impl<T> AnySync for T
where T: Any + Send + Sync,

§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> CompatExt for T

§

fn compat(self) -> Compat<T>

Applies the [Compat] adapter by value. Read more
§

fn compat_ref(&self) -> Compat<&T>

Applies the [Compat] adapter by shared reference. Read more
§

fn compat_mut(&mut self) -> Compat<&mut T>

Applies the [Compat] adapter by mutable reference. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T, UT> HandleAlloc<UT> for T
where T: Send + Sync,

§

fn new_handle(value: Arc<T>) -> Handle

Create a new handle for an Arc value Read more
§

unsafe fn clone_handle(handle: Handle) -> Handle

Clone a handle Read more
§

unsafe fn consume_handle(handle: Handle) -> Arc<T>

Consume a handle, getting back the initial Arc<> Read more
§

unsafe fn get_arc(handle: Handle) -> Arc<Self>

Get a clone of the Arc<> using a “borrowed” handle. Read more
§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<S, T> Upcast<T> for S
where T: UpcastFrom<S> + ?Sized, S: ?Sized,

Source§

fn upcast(&self) -> &T
where Self: ErasableGeneric, T: ErasableGeneric<Repr = Self::Repr>,

Perform a zero-cost type-safe upcast to a wider ref type within the Wasm bindgen generics type system. Read more
Source§

fn upcast_into(self) -> T
where Self: Sized + ErasableGeneric, T: ErasableGeneric<Repr = Self::Repr>,

Perform a zero-cost type-safe upcast to a wider type within the Wasm bindgen generics type system. Read more
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,