Struct Config 

pub struct Config { /* private fields */ }

How a Person Server is set up. issuer, the directory and the trusted agent providers are required; everything else has a default.

Implementations

impl Config

pub fn new<I, S>( issuer: &str, directory: impl Directory + 'static, trusted_agent_providers: I, ) -> Self

where I: IntoIterator<Item = S>, S: AsRef<str>,

issuer is https://host, with no port or path. Agents may ask only when their agent token’s iss is one of trusted_agent_providers.

pub fn default_tenant(self, tenant: impl Into<String>) -> Self

The tenant a request that names none is under. Default: DEFAULT_TENANT. A company’s own Person Server names its own.

pub fn require_tenant(self) -> Self

Refuse a request that names no tenant: for a Person Server that serves several.

pub fn trust( self, trusted: impl Fn(&str) -> bool + Send + Sync + 'static, ) -> Self

Decide trust in an agent provider by its iss instead of a list.

pub fn signing_key(self, key: SigningKey) -> Self

The token-signing key. Unset, a fresh key per process.

pub fn subject_secret(self, secret: impl Into<String>) -> Self

Derives each person’s directed sub per audience. Unset, a fresh secret per process.

pub fn store(self, store: Arc<dyn Store>) -> Self

Where state is kept; in memory by default.

pub fn base_path(self, base: &str) -> Self

Where the routes live under the issuer, e.g. /ps. Default: the root.

pub fn hooks(self, hooks: impl Hooks + 'static) -> Self

Tell hooks about approvals, decisions and issued tokens.

pub fn admin_token(self, token: impl Into<String>) -> Self

Bearer token for the management routes (/consent, /missions). Unset or empty, they are off.

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

A display name, in the metadata document.

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

A display description, in the metadata document.

pub fn token_ttl(self, ttl: Duration) -> Self

How long a person or auth token lasts, at most. Default: an hour.

pub fn mission_ttl(self, ttl: Duration) -> Self

How long an approved mission lasts. Default: 14 days.

pub fn approval_ttl(self, ttl: Duration) -> Self

How long an approval waits for a decision. Default: 24 hours.

pub fn retry_after(self, after: Duration) -> Self

The Retry-After a pending answer carries, in whole seconds. Default: 5 seconds.

pub fn fetch(self, fetch: Arc<dyn Fetch>) -> Self

How agent provider, resource and R3 documents are fetched. Unset, a guarded reqwest client (with the reqwest feature).

pub fn clock(self, now: impl Fn() -> i64 + Send + Sync + 'static) -> Self

Seconds since the epoch; for tests.