Struct OpenSSLConfig

pub struct OpenSSLConfig { /* private fields */ }

Available on crate feature tls-openssl only.

OpenSSL configuration.

Implementations

impl OpenSSLConfig

pub fn from_acceptor(acceptor: Arc<SslAcceptor>) -> Self

Create config from Arc<SslAcceptor>.

pub fn from_der(cert: &[u8], key: &[u8]) -> Result<Self, OpenSSLError>

This helper will establish a TLS server based on strong cipher suites from a DER-encoded certificate and key.

pub fn from_pem(cert: &[u8], key: &[u8]) -> Result<Self, OpenSSLError>

This helper will establish a TLS server based on strong cipher suites from a PEM-formatted certificate and key.

pub fn from_pem_file( cert: impl AsRef<Path>, key: impl AsRef<Path>, ) -> Result<Self, OpenSSLError>

This helper will establish a TLS server based on strong cipher suites from a PEM-formatted certificate and key.

pub fn from_pem_chain_file( chain: impl AsRef<Path>, key: impl AsRef<Path>, ) -> Result<Self, OpenSSLError>

This helper will establish a TLS server based on strong cipher suites from a PEM-formatted certificate chain and key.

pub fn get_inner(&self) -> Arc<SslAcceptor>

Get inner Arc<SslAcceptor>.

pub fn reload_from_acceptor(&self, acceptor: Arc<SslAcceptor>)

Reload acceptor from Arc<SslAcceptor>.

pub fn reload_from_der( &self, cert: &[u8], key: &[u8], ) -> Result<(), OpenSSLError>

Reload acceptor from a DER-encoded certificate and key.

pub fn reload_from_pem( &self, cert: &[u8], key: &[u8], ) -> Result<(), OpenSSLError>

Reload acceptor from a PEM-formatted certificate and key.

pub fn reload_from_pem_file( &self, cert: impl AsRef<Path>, key: impl AsRef<Path>, ) -> Result<(), OpenSSLError>

Reload acceptor from a PEM-formatted certificate and key.

pub fn reload_from_pem_chain_file( &self, chain: impl AsRef<Path>, key: impl AsRef<Path>, ) -> Result<(), OpenSSLError>

Reload acceptor from a PEM-formatted certificate chain and key.

Trait Implementations

impl Clone for OpenSSLConfig

fn clone(&self) -> OpenSSLConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for OpenSSLConfig

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

Formats the value using the given formatter.

impl TryFrom<SslAcceptorBuilder> for OpenSSLConfig

fn try_from(tls_builder: SslAcceptorBuilder) -> Result<Self, Self::Error>

Build the OpenSSLConfig from an SslAcceptorBuilder. This allows precise control over the settings that will be used by OpenSSL in this server.

Example

use axum_server::tls_openssl::OpenSSLConfig;
use openssl::ssl::{SslAcceptor, SslMethod};
use std::convert::TryFrom;

#[tokio::main]
async fn main() {
    let mut tls_builder = SslAcceptor::mozilla_modern_v5(SslMethod::tls())
        .unwrap();
    // Set configurations like set_certificate_chain_file or
    // set_private_key_file.
    // let tls_builder.set_ ... ;
    let _config = OpenSSLConfig::try_from(tls_builder);
}

type Error = Error

The type returned in the event of a conversion error.