authority

Module: config::authority

Contents

Structs

• AuthorityConfig - Validated tuning for background Authority stream clients.
• AuthorityEndpoint - A validated Authority destination.

Enums

• AuthorityConfigError - Error validating an [AuthorityConfig].
• AuthorityEndpointError - Error constructing an [AuthorityEndpoint].

---

firma_sidecar::config::authority::AuthorityConfig

Struct

Validated tuning for background Authority stream clients.

Fields:

• url: Option<String> - Authority gRPC URL (e.g. https://127.0.0.1:9443).
• connect_addr: Option<std::net::SocketAddr> - Optional physical TCP destination for the Authority connection.

Trait Implementations:

• Debug
  • fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result
• TryFrom
  • fn try_from(s: SchemaAuthorityConfig) -> Result<Self, <Self as >::Error>
• Clone
  • fn clone(self: &Self) -> AuthorityConfig
• Default
  • fn default() -> Self

firma_sidecar::config::authority::AuthorityConfigError

Enum

Error validating an [AuthorityConfig].

Variants:

• AgentId(firma_identifiers::AgentIdParseError) - agent_id was not a valid TypeID.
• MaxBackoffLessThanMin - The maximum reconnect backoff was below the minimum.
• EmptyPublicKeyPath - public_key_path was set but empty.
• EmptyCaCertPath - ca_cert_path was set but empty.
• TlsClientPairMismatch - Exactly one of the mTLS client cert/key pair was set.
• EmptyTlsClientCertPath - tls_client_cert_path was set but empty.
• EmptyTlsClientKeyPath - tls_client_key_path was set but empty.
• Credentials(crate::authority_credentials::SidecarCredentialsConfigError) - The nested credentials were invalid.

Trait Implementations:

• Error
  • fn source(self: &Self) -> ::core::option::Option<&dyn ::thiserror::__private18::Error>
• From
  • fn from(source: SidecarCredentialsConfigError) -> Self
• Display
  • fn fmt(self: &Self, __formatter: & mut ::core::fmt::Formatter) -> ::core::fmt::Result
• Debug
  • fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result
• From
  • fn from(source: AgentIdParseError) -> Self

firma_sidecar::config::authority::AuthorityEndpoint

Struct

A validated Authority destination.

The URI is the logical HTTP and TLS origin. The optional socket address is only the physical TCP route and does not change HTTP authority or TLS server-name verification.

Methods:

• fn new(url: &str, connect_addr: Option<SocketAddr>) -> Result<Self, AuthorityEndpointError> - Validate and construct an Authority endpoint.

Traits: Eq

Trait Implementations:

• Debug
  • fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result
• Clone
  • fn clone(self: &Self) -> AuthorityEndpoint
• PartialEq
  • fn eq(self: &Self, other: &AuthorityEndpoint) -> bool

firma_sidecar::config::authority::AuthorityEndpointError

Enum

Error constructing an [AuthorityEndpoint].

Variants:

• EmptyUrl - The configured URL is empty.
• InvalidUrl(String) - The configured URL is not a valid URI.
• ConnectAddrWithoutUrl - A physical route was configured without a logical origin.
• MissingScheme - The configured URL has no scheme.
• MissingHost - The configured URL has no host.
• UnsupportedScheme(String) - The configured URL does not use HTTP or HTTPS.
• ZeroPhysicalPort - The physical route uses port zero.
• UnspecifiedPhysicalIp - The physical route uses an unspecified IP address.

Traits: Error, Eq

Trait Implementations:

• Clone
  • fn clone(self: &Self) -> AuthorityEndpointError
• PartialEq
  • fn eq(self: &Self, other: &AuthorityEndpointError) -> bool
• Debug
  • fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result
• Display
  • fn fmt(self: &Self, __formatter: & mut ::core::fmt::Formatter) -> ::core::fmt::Result