//! `rustls` based TLS connection acceptor service. //! //! See [`Acceptor`] for main service factory docs. use std::{ convert::Infallible, future::Future, io::{self, IoSlice}, pin::Pin, sync::Arc, task::{Context, Poll}, time::Duration, }; use actix_codec::{AsyncRead, AsyncWrite, ReadBuf}; use actix_rt::{ net::{ActixStream, Ready}, time::{sleep, Sleep}, }; use actix_service::{Service, ServiceFactory}; use actix_utils::{ counter::{Counter, CounterGuard}, future::{ready, Ready as FutReady}, }; use derive_more::{Deref, DerefMut, From}; use pin_project_lite::pin_project; use tokio_rustls::rustls::ServerConfig; use tokio_rustls::{Accept, TlsAcceptor}; use super::{TlsError, DEFAULT_TLS_HANDSHAKE_TIMEOUT, MAX_CONN_COUNTER}; pub mod reexports { //! Re-exports from `rustls` that are useful for acceptors. pub use tokio_rustls::rustls::ServerConfig; } /// Wraps a `rustls` based async TLS stream in order to implement [`ActixStream`]. #[derive(Deref, DerefMut, From)] pub struct TlsStream(tokio_rustls::server::TlsStream); impl AsyncRead for TlsStream { fn poll_read( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &mut ReadBuf<'_>, ) -> Poll> { Pin::new(&mut **self.get_mut()).poll_read(cx, buf) } } impl AsyncWrite for TlsStream { fn poll_write( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &[u8], ) -> Poll> { Pin::new(&mut **self.get_mut()).poll_write(cx, buf) } fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { Pin::new(&mut **self.get_mut()).poll_flush(cx) } fn poll_shutdown(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { Pin::new(&mut **self.get_mut()).poll_shutdown(cx) } fn poll_write_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &[IoSlice<'_>], ) -> Poll> { Pin::new(&mut **self.get_mut()).poll_write_vectored(cx, bufs) } fn is_write_vectored(&self) -> bool { (&**self).is_write_vectored() } } impl ActixStream for TlsStream { fn poll_read_ready(&self, cx: &mut Context<'_>) -> Poll> { IO::poll_read_ready((&**self).get_ref().0, cx) } fn poll_write_ready(&self, cx: &mut Context<'_>) -> Poll> { IO::poll_write_ready((&**self).get_ref().0, cx) } } /// Accept TLS connections via the `rustls` crate. pub struct Acceptor { config: Arc, handshake_timeout: Duration, } impl Acceptor { /// Constructs `rustls` based acceptor service factory. pub fn new(config: ServerConfig) -> Self { Acceptor { config: Arc::new(config), handshake_timeout: DEFAULT_TLS_HANDSHAKE_TIMEOUT, } } /// Limit the amount of time that the acceptor will wait for a TLS handshake to complete. /// /// Default timeout is 3 seconds. pub fn set_handshake_timeout(&mut self, handshake_timeout: Duration) -> &mut Self { self.handshake_timeout = handshake_timeout; self } } impl Clone for Acceptor { fn clone(&self) -> Self { Self { config: self.config.clone(), handshake_timeout: self.handshake_timeout, } } } impl ServiceFactory for Acceptor { type Response = TlsStream; type Error = TlsError; type Config = (); type Service = AcceptorService; type InitError = (); type Future = FutReady>; fn new_service(&self, _: ()) -> Self::Future { let res = MAX_CONN_COUNTER.with(|conns| { Ok(AcceptorService { acceptor: self.config.clone().into(), conns: conns.clone(), handshake_timeout: self.handshake_timeout, }) }); ready(res) } } /// Rustls based acceptor service. pub struct AcceptorService { acceptor: TlsAcceptor, conns: Counter, handshake_timeout: Duration, } impl Service for AcceptorService { type Response = TlsStream; type Error = TlsError; type Future = AcceptFut; fn poll_ready(&self, cx: &mut Context<'_>) -> Poll> { if self.conns.available(cx) { Poll::Ready(Ok(())) } else { Poll::Pending } } fn call(&self, req: IO) -> Self::Future { AcceptFut { fut: self.acceptor.accept(req), timeout: sleep(self.handshake_timeout), _guard: self.conns.get(), } } } pin_project! { /// Accept future for Rustls service. #[doc(hidden)] pub struct AcceptFut { fut: Accept, #[pin] timeout: Sleep, _guard: CounterGuard, } } impl Future for AcceptFut { type Output = Result, TlsError>; fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll { let mut this = self.project(); match Pin::new(&mut this.fut).poll(cx) { Poll::Ready(Ok(stream)) => Poll::Ready(Ok(TlsStream(stream))), Poll::Ready(Err(err)) => Poll::Ready(Err(TlsError::Tls(err))), Poll::Pending => this.timeout.poll(cx).map(|_| Err(TlsError::Timeout)), } } }