Struct fuzzytags::Tag [−][src]
A tag is a probabilistic cryptographic structure. When constructed for a given TaggingKey
it will pass the DetectionKey::test_tag
100% of the time. For other tagging keys
it will pass the test with probability GAMMA
related to the security parameter of the system.
This system provides the following security properties:
- Correctness: Valid tags constructed for a specific tagging key will always validate when tested using the detection key
- Fuzziness: Invalid tags will produce false positives with probability p related to the security property (γ)
- Security: An adversarial server with access to the detection key is unable to distinguish false positives from true positives. (Detection Ambiguity)
Implementations
impl<const GAMMA: u8> Tag<{ GAMMA }>
[src]
pub fn compress(&self) -> Vec<u8>
[src]
An optimal sized copy of the tag
Compressed u || y || ciphertext
Ciphertext is right-padded with zeros to the nearest byte
You probably want to use one of the many serde serialize
apis instead (see README)
use fuzzytags::RootSecret; let secret = RootSecret::<24>::generate(); let tagging_key = secret.tagging_key(); // extract a detection key let detection_key = secret.extract_detection_key(5); // Give tagging key to a another party... // and then they can do... let tag = tagging_key.generate_tag(); let compressed_tag = tag.compress();
pub fn decompress(bytes: &[u8]) -> Option<Tag<{ GAMMA }>>
[src]
decompress an optimally encoded fuzzytag byte array, returns None if invalid
You probably want to use one of the many serde deserialize
apis instead (see README)
use fuzzytags::{RootSecret, Tag}; let secret = RootSecret::<24>::generate(); let tagging_key = secret.tagging_key(); // extract a detection key let detection_key = secret.extract_detection_key(5); // Give tagging key to a another party... // and then they can do... let tag = tagging_key.generate_tag(); let compressed_tag = tag.compress(); let decompressed_tag = Tag::decompress(&compressed_tag).unwrap(); assert_eq!(tag, decompressed_tag);
Trait Implementations
impl<const GAMMA: u8> Clone for Tag<GAMMA>
[src]
impl<const GAMMA: u8> Debug for Tag<GAMMA>
[src]
impl<'de, const GAMMA: u8> Deserialize<'de> for Tag<{ GAMMA }>
[src]
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
[src]
D: Deserializer<'de>,
impl<const GAMMA: u8> Display for Tag<{ GAMMA }>
[src]
impl<const GAMMA: u8> Eq for Tag<GAMMA>
[src]
impl<const GAMMA: u8> PartialEq<Tag<GAMMA>> for Tag<GAMMA>
[src]
impl<const GAMMA: u8> Serialize for Tag<{ GAMMA }>
[src]
impl<const GAMMA: u8> StructuralEq for Tag<GAMMA>
[src]
impl<const GAMMA: u8> StructuralPartialEq for Tag<GAMMA>
[src]
Auto Trait Implementations
impl<const GAMMA: u8> RefUnwindSafe for Tag<GAMMA>
[src]
impl<const GAMMA: u8> Send for Tag<GAMMA>
[src]
impl<const GAMMA: u8> Sync for Tag<GAMMA>
[src]
impl<const GAMMA: u8> Unpin for Tag<GAMMA>
[src]
impl<const GAMMA: u8> UnwindSafe for Tag<GAMMA>
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> DeserializeOwned for T where
T: for<'de> Deserialize<'de>,
[src]
T: for<'de> Deserialize<'de>,
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> Same<T> for T
type Output = T
Should always be Self
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
V: MultiLane<T>,