Struct SaasState 

pub struct SaasState {
    pub domain_manager: Arc<DomainManager>,
    pub api_key_service: Arc<ApiKeyService>,
    pub auth_layer: Arc<SaasAuthLayer>,
    pub pool: PgPool,
    pub cert_store: Arc<CertificateStore>,
}

Shared state for SaaS API handlers.

Fields

domain_manager: Arc<DomainManager>

Domains, their routes and their upstreams.

api_key_service: Arc<ApiKeyService>

Creating, listing and revoking API keys.

auth_layer: Arc<SaasAuthLayer>

The middleware that turns a credential into an AuthContext.

pool: PgPool

The pool, for handlers whose concern is not domain management.

wellknown serves ACME challenges out of proxy_acme_challenges, which is a TLS concern that has no business being a method on DomainManager. The original code carried a comment saying it needed this and did not have it, and answered with a placeholder instead.

cert_store: Arc<CertificateStore>

Where uploaded and issued certificates are kept.

Implementations

impl SaasState

pub async fn new( pool: PgPool, jwt_secret: Option<String>, cert_dir: impl AsRef<Path>, ) -> ProxyResult<Self>

Build the state with default SaasOptions and this JWT secret.

cert_dir is where certificates are cached on disk. A parameter rather than a default, because a proxy that silently writes private keys to a directory nobody chose is worse than one that makes you say where.

The defaults reserve no platform hostnames. A deployment that serves its own names from the same proxy should use with_options and list them in DomainPolicy::reserved.

pub async fn with_options( pool: PgPool, options: SaasOptions, cert_dir: impl AsRef<Path>, ) -> ProxyResult<Self>

Build the state from explicit options.

Trait Implementations

impl Clone for SaasState

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.