Struct Principal 

pub struct Principal { /* private fields */ }

The authenticated caller, as seen by the routing/tenancy SPI.

Carries a stable PrincipalId and a small set of attributes an implementer may key tenancy decisions on (e.g. a tenant id derived from the client certificate). It never carries the raw credential (token, certificate bytes): those are consumed by the authenticator and dropped, so nothing secret reaches the SPI or telemetry (docs/05 §7, NFR-S2).

Examples

use osproxy_core::PrincipalId;
use osproxy_spi::{Principal, PrincipalAttr};

let p = Principal::new(PrincipalId::from("svc-ingest"))
    .with_attr(PrincipalAttr::new("tenant", "acme"));
assert_eq!(p.id().as_str(), "svc-ingest");
assert_eq!(p.attr("tenant"), Some("acme"));
assert_eq!(p.attr("missing"), None);

Implementations

impl Principal

pub fn new(id: PrincipalId) -> Self

Constructs a principal with no attributes.

pub fn with_attr(self, attr: PrincipalAttr) -> Self

Adds an attribute (builder style).

pub fn id(&self) -> &PrincipalId

The principal’s stable id.

pub fn attr(&self, key: &str) -> Option<&str>

Looks up an attribute value by key, if present.

Trait Implementations

impl Clone for Principal

fn clone(&self) -> Principal

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

fn eq(&self, other: &Principal) -> 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 StructuralPartialEq for Principal