Module kvarn::host

Handling of multiple Hosts on one instance of Kvarn.

A single Host contains the certificate, caches, and preferences which are needed to run a domain.

This also implements the logic needed for [rustls] to resolve which Host to use for a connection. This is done by having an optional default and other defined by their SNI (or host header in HTTP/1). If no host is matched, the request is dropped, like when a unsecure connection is sent to a secure port.

Structs

• Collection
  A collection of Hosts, with an optional default and arbitrarily many others, indexed by [Host.name].
• CollectionBuilder
  A builder of Collection. See Collection::builder().
• Host
  A set of settings for a virtual host, allowing multiple DNS entries (domain names) to share a single IP address.
• Options
  Options for Host. Values wrapped in Options usually use hardcoded defaults when the value is None.

Enums

• CacheAction
  Per host filter output of whether or not to cache a response with some StatusCode.
• CertificateErrorhttps
  An error regarding creation of a [rustls::sign::CertifiedKey].

Functions

• alpn
  All the supported ALPN protocols.
• default_status_code_cache_filter
  This is the default for Options::status_code_cache_filter.
• get_certified_keyhttps
  Extracts a [sign::CertifiedKey] from cert_path and private_key_path.

Type Definitions

• CertKeyPairhttps
  A pair of [rustls::Certificate] and [sign::SigningKey].