pub struct Fingerprint { /* private fields */ }Available on crate feature
device-id only.Expand description
An app-keyed 16-byte hash per anchor, or absent.
use sys_lib::device::{self, Fingerprint, Verdict};
let now = device::fingerprint("com.example.app")?;
let stored = Fingerprint::from_bytes(&now.to_bytes())?;
match now.compare(&stored).verdict {
Verdict::Same => {}
Verdict::LikelySame => { /* one part changed: update the record */ }
Verdict::Different => { /* treat as a new device */ }
_ => {}
}Implementations§
Source§impl Fingerprint
impl Fingerprint
Sourcepub fn compare(&self, stored: &Fingerprint) -> Comparison
pub fn compare(&self, stored: &Fingerprint) -> Comparison
Compares with a stored fingerprint, each hash in constant time.
Sourcepub fn to_bytes(&self) -> [u8; 112]
pub fn to_bytes(&self) -> [u8; 112]
The stored form: magic, version, anchor bitmap, two reserved bytes, six 16-byte hashes, and an 8-byte checksum.
Sourcepub fn from_bytes(bytes: &[u8]) -> Result<Fingerprint>
pub fn from_bytes(bytes: &[u8]) -> Result<Fingerprint>
Reads the stored form. The checksum catches storage corruption, not tampering.
§Errors
Malformed for a wrong length, magic, or version, non-zero reserved
bytes, a bitmap that disagrees with the hashes, or a bad checksum,
checked in that order (E-78).
Trait Implementations§
Source§impl Clone for Fingerprint
impl Clone for Fingerprint
Source§impl Debug for Fingerprint
impl Debug for Fingerprint
impl Eq for Fingerprint
Source§impl PartialEq for Fingerprint
impl PartialEq for Fingerprint
impl StructuralPartialEq for Fingerprint
Auto Trait Implementations§
impl Forget for Fingerprint
impl Freeze for Fingerprint
impl Move for Fingerprint
impl RefUnwindSafe for Fingerprint
impl Send for Fingerprint
impl Sync for Fingerprint
impl Unpin for Fingerprint
impl UnsafeUnpin for Fingerprint
impl UnwindSafe for Fingerprint
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more