Skip to main content

CorsDefinition

Struct CorsDefinition 

Source
pub struct CorsDefinition {
    pub name: String,
    pub allow_origins: Vec<String>,
    pub allow_methods: Vec<String>,
    pub allow_headers: Vec<String>,
    pub allow_credentials: bool,
    pub max_age: Option<String>,
    pub expose_headers: Vec<String>,
    pub loc: Loc,
    pub leading_trivia: Vec<Trivia>,
    pub trailing_trivia: Vec<Trivia>,
}
Expand description

cors Name { allow_origins:, allow_methods:, allow_headers:, allow_credentials:, max_age:, expose_headers: }

v2.38.0 — a named, referenced origin-policy declaration, mirroring shield’s shape exactly: declared once, referenced from any number of axonendpoints via cors: <Name> (AxonEndpointDefinition::cors_ref). Makes the browser-facing origin policy a property of the ENDPOINT, resolved per the tenant’s live deployed bundle — the shape a single process-wide CORS knob (the market-standard pattern) cannot express for a multi-tenant deploy where different bundles need different origins for a path with the same name.

Unknown fields are a hard parse error — a CORS policy is security-relevant, so upstream/voice’s stricter posture is followed here, not shield’s lenient axon-W010 record-and-skip.

Fields§

§name: String§allow_origins: Vec<String>

["https://app.example.com", "https://*.kivi.io"] — exact origins or a single leading-wildcard host-label glob (the design decision/T854); no full regex, matching the closed/decidable spirit of the rest of the language. ["*"] (any-origin) is legal UNLESS allow_credentials is also true — that combination is axon-T853 (the design decision, the CORS spec’s own rule, caught at compile time instead of a silent browser rejection).

§allow_methods: Vec<String>

Reuses the closed axonendpoint method catalog (GET/POST/PUT/ PATCH/DELETE) — validated against the same list, not a free string (T855).

§allow_headers: Vec<String>

Request headers the preflight may allow (e.g. ["Content-Type", "Authorization"]) — free-form header-name strings (hyphens are common in real header names, hence string literals, not bare identifiers).

§allow_credentials: bool

trueAccess-Control-Allow-Credentials: true is emitted. Forbidden together with an any-origin allow_origins (T853).

§max_age: Option<String>

Access-Control-Max-Age — a duration literal ("3600s", "1h"), same lexer/token convention as axonendpoint.timeout. None ⇒ the header is omitted (browser default caching applies).

§expose_headers: Vec<String>

Access-Control-Expose-Headers — response headers the browser’s JS may read beyond the CORS-safelisted set. Free-form strings, same rationale as allow_headers.

§loc: Loc§leading_trivia: Vec<Trivia>

v1.5.2 — leading comment trivia.

§trailing_trivia: Vec<Trivia>

v1.5.2 — trailing comment trivia.

Trait Implementations§

Source§

impl Debug for CorsDefinition

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for CorsDefinition

Source§

fn default() -> CorsDefinition

Returns the “default value” for a type. Read more

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<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<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> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. 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 = Infallible

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<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

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