Enum PartialHsts

pub enum PartialHsts {
    Disable,
    Enable,
    IncludeSubDomains,
    Preload,
}

HSTS enabling options as seen from the user’s perspective.

Caution:

The IncludeSubDomains and Preload settings may have lasting unintended effects on unrelated HTTP servers (current and future) running on subdomains of the links host, and may even render those websites unusable for months or years by requiring browsers to use HTTPS (with TLS) exclusively when doing HTTP requests to those domains. The Enable setting, however, only impacts the exact domain it is used from, so should only impact the links redirector server itself. It is recommended to start testing HSTS (especially IncludeSubDomains and Preload) with a short max-age initially, and to test any possible impact on other websites hosted on the same domain and on its subdomains.

See also:

• https://hstspreload.org/
• https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security
• https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security

Variants

Disable

Don’t send the HTTP Strict Transport Security header

Enable

Send the HSTS header without the preload or includeSubDomains attributes.

IncludeSubDomains

Send the HSTS header with the includeSubDomains attribute, but without preload

Caution:

This may have temporary unintended effects on unrelated HTTP servers running on subdomains of the links host. Make sure that this won’t cause any problems before enabling it and try a short max-age first. More info on https://hstspreload.org/, https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security, and https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security.

Preload

Send the HSTS header with the preload and includeSubDomains attributes

Caution:

This may have lasting unintended effects on unrelated HTTP servers (current and future) running on subdomains of the links host, and may even render those websites unusable for months or years.

Read https://hstspreload.org/, https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security, and https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security first, and make sure that this won’t cause any problems before enabling it.

Trait Implementations

impl Clone for PartialHsts

fn clone(&self) -> PartialHsts

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartialHsts

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

Formats the value using the given formatter.

impl Default for PartialHsts

fn default() -> PartialHsts

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PartialHsts

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PartialHsts

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

Formats the value using the given formatter.

impl FromStr for PartialHsts

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<PartialHsts, <Self as FromStr>::Err>

Parses a string s to return a value of this type.

impl PartialEq for PartialHsts

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PartialHsts

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&str> for PartialHsts

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<PartialHsts, <Self as TryFrom<&str>>::Error>

Performs the conversion.

impl Copy for PartialHsts

impl Eq for PartialHsts

impl StructuralPartialEq for PartialHsts