Skip to main content

Profile

Struct Profile 

Source
pub struct Profile {
    pub name: String,
    pub path: String,
    pub base_url: String,
    pub signer: Arc<dyn SignerBackend>,
    pub filter: Arc<FilterPolicy>,
    pub challenges: Arc<ChallengeRegistry>,
    pub order: OrderConfig,
    pub eab: EabConfig,
    pub meta: MetaConfig,
    pub notify: Arc<NotifyDispatcher>,
}
Expand description

One ACME endpoint: its identity, its URLs, and the three subsystems that answer for it.

Everything per-endpoint lives here rather than beside the global config in AppState, so a handler cannot pair one profile’s signer with another’s base URL — the two always travel together.

Fields§

§name: String

The configured name ([profiles.<name>]), also the URL segment and the value stored in accounts.profile / orders.profile.

§path: String

Where the router mounts it: /profile/<name>.

§base_url: String

The public base for every URL this endpoint hands out and for the RFC 8555 §6.4 url check: server.base_url + Profile::path.

§signer: Arc<dyn SignerBackend>§filter: Arc<FilterPolicy>§challenges: Arc<ChallengeRegistry>§order: OrderConfig§eab: EabConfig§meta: MetaConfig

The optional meta members this endpoint’s directory advertises (RFC 8555 §7.1.1). Per-profile, like everything else here: two endpoints on one process can have different terms of service.

§notify: Arc<NotifyDispatcher>

Implementations§

Source§

impl Profile

Source

pub fn new(name: &str, base_url: &str, parts: ProfileParts) -> Self

Assembles a profile, deriving its path and base URL from its name — the two are never configured, so they cannot drift from each other or from what the database records.

Source

pub fn directory_url(&self) -> String

This endpoint’s directory URL — where a client starts.

Derived here rather than format!-ed at each of the three call sites (the startup log line, the admin API’s profile listing, and anything added later), all of which have to agree with what build_router actually mounts.

Source

pub fn build_all( config: &Config, database: Arc<Database>, jobs: &JobQueue, ) -> Result<Vec<Arc<Profile>>>

Builds every endpoint this configuration mounts, ready to serve.

Lives here rather than in cli::serve_on because it is the assembly step, not dispatch: it resolves the profiles, builds the signer backends (deduplicated by configuration — see signer::build_backends), and gives each profile its own filter chain and challenge registry. Every failure is fatal at startup, so they come back as one error for the caller to report and exit on.

Each profile’s subsystems are built inside a span naming it, so the warnings they emit at build time (filter_disabled, challenge_validation_bypassed) say which endpoint is wide open — with several mounted, an unattributed warning is worse than none. jobs is the enqueue side of the durable queue, handed in rather than built here for the reason the Auditor is built in serve_on_with: [jobs] is process-wide, one queue drained by one runner, and a profile is not the thing that owns it.

Source

pub fn build_all_with( config: &Config, resolved: &[ProfileConfig], generation: &GenerationParts, ) -> Result<Vec<Arc<Profile>>>

One generation of profiles, over an Assembly that outlives it.

The half of build_all a configuration reload runs again. Everything it touches is cheap and side-effect-free to rebuild — a filter policy, an IPAM client, a challenge registry — which is exactly why the stateful half lives in the Assembly instead. The signer backends are the interesting middle case: they are rebuilt here too, but only the ones whose configuration actually moved, and those adopt what the outgoing instance held (see signer::build_backends).

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

Source§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

Source§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

Source§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<A, B, T> HttpServerConnExec<A, B> for T
where B: Body,

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more