Enum Principal 

#[non_exhaustive]
pub enum Principal {
    Anonymous,
    Signer {
        ed25519: [u8; 32],
    },
    BearerHolder,
    TransportPeer {
        ed25519: [u8; 32],
    },
    SshForcedCommand {
        key: Option<[u8; 32]>,
    },
}

The identity a request was mapped to. Non-exhaustive: M2 may add a caller-view class.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Anonymous

No credentials.

Signer

An auth v2 signer.

Fields

ed25519: [u8; 32]

The signer’s raw Ed25519 public key.

BearerHolder

Holder of a deployment-wide shared bearer token (mkit-server serve --auth bearer, formerly mkit serve --http).

TransportPeer

The authenticated peer of an encrypted (enc) listener.

Fields

ed25519: [u8; 32]

The peer’s raw Ed25519 static key.

SshForcedCommand

mkit serve over stdio. The identity is the ssh forced command (SSH-SECURITY §5). key is always None in M0; WP-1.15 sets it from mkit serve --principal <ed25519-hex>.

Fields

key: Option<[u8; 32]>

The Ed25519 key the forced command names, if any.

Implementations

impl Principal

pub const fn kind(&self) -> &'static str

A stable, key-free label for tracing spans and metrics: anonymous, signer, bearer, transport_peer or ssh_forced_command.

pub fn ed25519(&self) -> Option<&[u8; 32]>

The principal’s Ed25519 public key, when it has one.

Trait Implementations

impl Clone for Principal

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Principal

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

Formats the value using the given formatter.

impl Eq for Principal

impl Hash for Principal

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 PartialEq for Principal

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Principal