Struct quinn::ServerConfig

pub struct ServerConfig {
    pub transport: Arc<TransportConfig>,
    pub crypto: Arc<dyn ServerConfig + 'static>,
    /* private fields */
}

Parameters governing incoming connections

Default values should be suitable for most internet applications.

Fields

transport: Arc<TransportConfig>

Transport configuration to use for incoming connections

crypto: Arc<dyn ServerConfig + 'static>

TLS configuration used for incoming connections.

Must be set to use TLS 1.3 only.

Implementations

impl ServerConfig

pub fn new(
    crypto: Arc<dyn ServerConfig + 'static>,
    token_key: Arc<dyn HandshakeTokenKey + 'static>
) -> ServerConfig

Create a default config with a particular handshake token key

pub fn token_key(
    &mut self,
    value: Arc<dyn HandshakeTokenKey + 'static>
) -> Result<&mut ServerConfig, ConfigError>

Private key used to authenticate data included in handshake tokens.

pub fn use_retry(&mut self, value: bool) -> &mut ServerConfig

Whether to require clients to prove ownership of an address before committing resources.

Introduces an additional round-trip to the handshake to make denial of service attacks more difficult.

pub fn retry_token_lifetime(&mut self, value: Duration) -> &mut ServerConfig

Duration after a stateless retry token was issued for which it’s considered valid.

pub fn concurrent_connections(&mut self, value: u32) -> &mut ServerConfig

Maximum number of simultaneous connections to accept.

New incoming connections are only accepted if the total number of incoming or outgoing connections is less than this. Outgoing connections are unaffected.

pub fn migration(&mut self, value: bool) -> &mut ServerConfig

Whether to allow clients to migrate to new addresses

Improves behavior for clients that move between different internet connections or suffer NAT rebinding. Enabled by default.

impl ServerConfig

pub fn with_single_cert(
    cert_chain: Vec<Certificate, Global>,
    key: PrivateKey
) -> Result<ServerConfig, Error>

Create a server config with the given certificate chain to be presented to clients

Uses a randomized handshake token key.

pub fn with_crypto(crypto: Arc<ServerConfig>) -> ServerConfig

Create a server config with the given rustls::ServerConfig

Uses a randomized handshake token key.

Trait Implementations

impl Clone for ServerConfig

fn clone(&self) -> ServerConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ServerConfig

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

Formats the value using the given formatter.