aauth-person-server 0.1.0

An AAuth Person Server: missions, person and auth tokens, budgets and approvals, over plain http types
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use async_trait::async_trait;

use crate::types::{Approval, ApprovalKind, Issued, Person};

/// Who this Person Server speaks for, and who decides for them.
#[async_trait]
pub trait Directory: Send + Sync {
    /// The person a `login_hint` names in `tenant`, or `None` if this Person
    /// Server does not speak for them there. A person returned with a
    /// tenant is in that tenant alone: a request under any other is
    /// refused. One returned without a tenant takes the request's, so a
    /// directory that serves several tenants checks `tenant` itself.
    async fn person(&self, login_hint: &str, tenant: &str) -> Option<Person>;

    /// Who decides a request; the person themself when `None`.
    async fn approver(&self, _kind: ApprovalKind, _person: &Person) -> Option<Person> {
        None
    }
}

/// What a Person Server tells its operator.
#[async_trait]
pub trait Hooks: Send + Sync {
    /// A decision is needed: reach whoever decides, however you reach people.
    async fn on_approval(&self, _approval: &Approval) {}
    /// An approval was decided.
    async fn on_decision(&self, _approval: &Approval) {}
    /// A token was issued.
    async fn on_issued(&self, _issued: &Issued) {}
}

/// No hooks.
pub struct NoHooks;

impl Hooks for NoHooks {}