Struct RsaIdentity

pub struct RsaIdentity { /* private fields */ }

An identifier for an RSA key, based on SHA1 and DER.

These are used (for legacy purposes) all over the Tor protocol.

This object is an “identity” in the sense that it identifies (up to) one RSA key. It may also represent the identity for a particular entity, such as a relay or a directory authority.

Note that for modern purposes, you should almost always identify a relay by its Ed25519Identity instead of by this kind of identity key.

Implementations

impl RsaIdentity

pub fn as_bytes(&self) -> &[u8]

Expose an RsaIdentity as a slice of bytes.

pub fn from_bytes(bytes: &[u8]) -> Option<Self>

Construct an RsaIdentity from a slice of bytes.

Returns None if the input is not of the correct length.

use tor_llcrypto::pk::rsa::RsaIdentity;

let bytes = b"xyzzyxyzzyxyzzyxyzzy";
let id = RsaIdentity::from_bytes(bytes);
assert_eq!(id.unwrap().as_bytes(), bytes);

let truncated = b"xyzzy";
let id = RsaIdentity::from_bytes(truncated);
assert_eq!(id, None);

pub fn from_hex(s: &str) -> Option<Self>

Decode an RsaIdentity from a hexadecimal string.

The string must have no spaces, or any extra characters.

pub fn is_zero(&self) -> bool

Return true if this RsaIdentity is composed entirely of zero-valued bytes.

Such all-zero values should not be used internally, since they are not the ID of any valid key. Instead, they are used in some places in the Tor protocols.

Trait Implementations

impl Clone for RsaIdentity

fn clone(&self) -> RsaIdentity

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConstantTimeEq for RsaIdentity

fn ct_eq(&self, other: &Self) -> Choice

Determine if two items are equal.

fn ct_ne(&self, other: &Self) -> Choice

Determine if two items are NOT equal.

impl Debug for RsaIdentity

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RsaIdentity

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RsaIdentity

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<[u8; 20]> for RsaIdentity

fn from(id: [u8; 20]) -> RsaIdentity

Converts to this type from the input type.

impl HasMemoryCostStructural for RsaIdentity

fn indirect_memory_cost(&self, et: EnabledToken) -> usize

Memory cost of data stored out-of-line

impl Hash for RsaIdentity

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for RsaIdentity

fn cmp(&self, other: &RsaIdentity) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for RsaIdentity

fn eq(&self, other: &RsaIdentity) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for RsaIdentity

fn partial_cmp(&self, other: &RsaIdentity) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Redactable for RsaIdentity

fn display_redacted(&self, f: &mut Formatter<'_>) -> Result

Warning: This displays 16 bits of the RSA identity, which is enough to narrow down a public relay by a great deal.

fn debug_redacted(&self, f: &mut Formatter<'_>) -> Result

As Debug::fmt, but produce a redacted representation.

fn redacted(&self) -> Redacted<&Self>

Return a smart pointer that will display or debug this object as its redacted form.

fn maybe_redacted(&self, redact: bool) -> MaybeRedacted<&Self>

Return a smart pointer that redacts this object if redact is true.

impl Serialize for RsaIdentity

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for RsaIdentity

impl Eq for RsaIdentity

impl StructuralPartialEq for RsaIdentity