Struct Conversation 

pub struct Conversation<S: ConversationState> { /* private fields */ }

A conversation with peer, parameterized by its consent state.

Implementations

impl<S: ConversationState> Conversation<S>

pub fn peer(&self) -> &str

The peer this conversation addresses.

pub fn purpose(&self) -> Option<&str>

The declared purpose, if any.

pub fn resource_id(&self) -> String

The resource id consent is minted against: conversation/<peer>.

impl Conversation<Proposed>

pub fn propose(peer: impl Into<String>) -> Self

Open a conversation proposal with peer.

pub fn with_purpose(self, purpose: impl Into<String>) -> Self

Declare the purpose of the conversation.

pub fn request_consent<I, T>(self, scopes: I) -> Conversation<AwaitingConsent>

where I: IntoIterator<Item = T>, T: Into<String>,

Ask for consent to the named action scopes. The conversation can no longer be treated as consent-free — and is not yet consented.

impl Conversation<AwaitingConsent>

pub fn requested_scopes(&self) -> &[String]

The scopes consent was requested for.

pub fn grant_via( self, engine: &dyn PolicyEngine, subject: impl Into<SubjectId>, ) -> Result<Conversation<Consented>, (Self, CapabilityError)>

Resolve the consent request through a policy engine.

Consent is granted only if engine allows subject the delegate action on conversation/<peer> — the decision is audited and the resulting capability expires like any other. On deny, the conversation is returned unchanged so the caller can renegotiate.

impl Conversation<Consented>

pub fn consented_scopes(&self) -> &[String]

The scopes this conversation is consented for.

pub fn covers(&self, action: &str) -> bool

true if action is within the consented scopes.

pub fn consent(&self) -> &Capability<CanDelegate, GenericResource>

The consent proof: a real capability, checkable and expiring.

Trait Implementations

impl<S: ConversationState> Debug for Conversation<S>

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

Formats the value using the given formatter.