Struct Server 

#[non_exhaustive]
pub struct Server {
    pub cert: Vec<PathBuf>,
    pub key: Vec<PathBuf>,
    pub generate: Vec<String>,
    pub root: Vec<PathBuf>,
}

TLS configuration for the server.

Certificate and keys must currently be files on disk. Alternatively, you can generate a self-signed certificate given a list of hostnames.

In config files, each list field accepts either a single string or a TOML array.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

cert: Vec<PathBuf>

Load the given certificate from disk.

key: Vec<PathBuf>

Load the given key from disk.

generate: Vec<String>

Or generate a new certificate and key with the given hostnames. This won’t be valid unless the client uses the fingerprint or disables verification.

root: Vec<PathBuf>

PEM file(s) of root CAs for validating optional client certificates (mTLS).

When set, clients may present a certificate during the TLS handshake. Valid presentations are reported via crate::Request::peer_identity and can be used by the application to grant elevated access. Clients that do not present a certificate are unaffected.

Client certificate reporting is only supported by the Quinn and noq QUIC backends. Plain-TLS listeners built via Self::server_config also use these roots for optional mTLS when the feature set includes quinn, noq, or quiche.

Implementations

impl Server

pub fn load_roots(&self) -> Result<RootCertStore>

Load all configured root CAs into a rustls::RootCertStore.

pub fn server_config(&self, alpn: Vec<Vec<u8>>) -> Result<Arc<ServerConfig>>

Build a rustls::ServerConfig for a plain-TLS (non-QUIC) server, e.g. an RTMPS or HTTPS listener fronting the QUIC endpoint, reusing the QUIC backend’s certificate handling: on-disk cert/key pairs, generate self-signed certs, and optional mTLS root client CAs.

alpn sets the advertised ALPN protocols (e.g. vec![b"h2".to_vec(), b"http/1.1".to_vec()]); pass an empty list for a protocol like RTMPS that doesn’t use ALPN.

Trait Implementations

impl Args for Server

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Clone for Server

fn clone(&self) -> Server

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Server

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

Formats the value using the given formatter.

impl Default for Server

fn default() -> Server

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Server

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromArgMatches for Server

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Serialize for Server

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

where __S: Serializer,

Serialize this value into the given Serde serializer.