Struct CaaPolicy 

pub struct CaaPolicy {
    pub records: Vec<CaaRecord>,
    pub effective_domain: Option<String>,
    pub has_policy: bool,
    pub issuer_match: Option<IssuerCaaMatch>,
    pub iodef: Vec<String>,
    pub wildcard_note: Option<String>,
    pub note: String,
}

CAA policy collected for a domain, plus the informational note that callers should surface to users.

Fields

records: Vec<CaaRecord>

Records discovered (may be empty if no policy is set).

effective_domain: Option<String>

Domain at which the records were found. Per RFC 8659 the resolver climbs the tree until a CAA RRset is encountered, so this may be a parent of the queried name.

has_policy: bool

True iff at least one CAA record was found in the tree-walk.

issuer_match: Option<IssuerCaaMatch>

Result of comparing a presented cert’s issuer against the policy. None if no cert was supplied for comparison.

iodef: Vec<String>

iodef incident-reporting contacts declared in the policy (RFC 8659 §4.4) — a takedown/abuse channel available nowhere else in seer.

wildcard_note: Option<String>

A note when the wildcard issuance policy (issuewild) is broader than the base (issue) policy — i.e. a CA may issue wildcard certs it is not permitted to issue named certs for. None when the policies are consistent, or issuewild/issue is absent (RFC 8659 §4.3: absent issuewild inherits issue, which is NOT a gap).

note: String

Informational note about CAA semantics. Always populated.

Implementations

impl CaaPolicy

pub fn empty() -> Self

Empty policy — used when no CAA records were found anywhere in the tree.

Trait Implementations

impl Clone for CaaPolicy

fn clone(&self) -> CaaPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CaaPolicy

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CaaPolicy

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CaaPolicy

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.