Struct WebTransportServerConfig

pub struct WebTransportServerConfig {
    pub cert: CertificateDer<'static>,
    pub key: PrivateKeyDer<'static>,
    pub listen: SocketAddr,
    pub max_clients: usize,
}

Configuration for setting up a WebTransportServer.

Fields

cert: CertificateDer<'static>

The certificate for this server.

Note that if the certificate expires, then the server will no longer make connections. This is relevant for clients that use ServerCertHash, which can only connect to certificates with an expiration under two weeks.

key: PrivateKeyDer<'static>

The private key for this server.

listen: SocketAddr

Socket address to listen on.

It is recommended to use a pre-defined IP and a wildcard port. The pre-defined IP should be used when obtaining Self::cert from your certificate authority (CA).

Using a wildcard port will reduce your chance of competing with other sockets on your machine (e.g. other WebTransport servers running different game instances).

max_clients: usize

Maximum number of active clients allowed.

Implementations

impl WebTransportServerConfig

pub fn new_selfsigned( listen: SocketAddr, max_clients: usize, ) -> (Self, ServerCertHash)

Makes a new config with a self-signed CertificateDer tied to the listen address.

Returns the ServerCertHash of the certificate, which can be used to set up clients via WebTransportClientConfig.

The certificate produced will be valid for two weeks (minus one hour and one minute).

Use Self::new_selfsigned_with_proxies if you want the certificate to bind to a URL (e.g. domain name).

pub fn new_selfsigned_with_proxies( listen: SocketAddr, proxies: Vec<WebServerDestination>, max_clients: usize, ) -> (Self, ServerCertHash)

Makes a new config with a self-signed CertificateDer tied to the proxies destinations.

Returns the ServerCertHash of the certificate, which can be used to set up clients via WebTransportClientConfig.

The certificate produced will be valid for two weeks (minus one hour and one minute).

Use Self::new_selfsigned_with_proxies if you only want the certificate to bind to the listen address.

pub fn create_server_config(self) -> Result<ServerConfig, Error>

Converts self into a wtransport::ServerConfig.

Used automatically by WebTransportServer::new.

Trait Implementations

impl Clone for WebTransportServerConfig

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WebTransportServerConfig

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

Formats the value using the given formatter.