Enum BrokerTransportSecurity 

pub enum BrokerTransportSecurity {
    RequireTls,
    AllowInsecurePlaintext,
}

How Photon may connect to an external broker.

Production hosts should use Self::RequireTls. Plaintext endpoints require an explicit Self::AllowInsecurePlaintext opt-in (builder method or ALLOW_INSECURE_BROKER_ENV).

Variants

RequireTls

Reject plaintext broker URLs/endpoints; prefer TLS (tls://, SDK TLS options).

AllowInsecurePlaintext

Development/CI only: allow nats:// and other plaintext broker endpoints.

Implementations

impl BrokerTransportSecurity

pub fn from_env() -> BrokerTransportSecurity

Load from ALLOW_INSECURE_BROKER_ENV (1/true → insecure; otherwise require TLS).

pub const fn allows_plaintext(self) -> bool

Returns true when plaintext broker endpoints are permitted.

pub fn check_endpoint(self, endpoint: &str) -> Result<(), PhotonError>

Fail closed when endpoint looks like plaintext and insecure opt-in is absent.

Recognizes common plaintext schemes: nats://, kafka://, ftp://, bare host:port without a tls / ssl / https marker. tls://, nats+tls://, and URLs containing ssl/tls as the scheme are treated as TLS-oriented.

Errors

Returns PhotonError::Internal when plaintext would be used without opt-in.

Trait Implementations

impl Clone for BrokerTransportSecurity

fn clone(&self) -> BrokerTransportSecurity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BrokerTransportSecurity

impl Debug for BrokerTransportSecurity

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

Formats the value using the given formatter.

impl Default for BrokerTransportSecurity

fn default() -> BrokerTransportSecurity

Returns the “default value” for a type.

impl Eq for BrokerTransportSecurity

impl PartialEq for BrokerTransportSecurity

fn eq(&self, other: &BrokerTransportSecurity) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BrokerTransportSecurity