use std::fmt; use std::future::Future; use std::pin::Pin; use std::task::{Context, Poll}; use hyper::{client::connect::HttpConnector, service::Service, Uri}; use tokio::io::{AsyncRead, AsyncWrite}; use tokio_native_tls::TlsConnector; use crate::stream::MaybeHttpsStream; type BoxError = Box; /// A Connector for the `https` scheme. #[derive(Clone)] pub struct HttpsConnector { force_https: bool, http: T, tls: TlsConnector, } impl HttpsConnector { /// Construct a new HttpsConnector. /// /// This uses hyper's default `HttpConnector`, and default `TlsConnector`. /// If you wish to use something besides the defaults, use `From::from`. /// /// # Note /// /// By default this connector will use plain HTTP if the URL provded uses /// the HTTP scheme (eg: http://example.com/). /// /// If you would like to force the use of HTTPS then call https_only(true) /// on the returned connector. /// /// # Panics /// /// This will panic if the underlying TLS context could not be created. /// /// To handle that error yourself, you can use the `HttpsConnector::from` /// constructor after trying to make a `TlsConnector`. pub fn new() -> Self { native_tls::TlsConnector::new() .map(|tls| HttpsConnector::new_(tls.into())) .unwrap_or_else(|e| panic!("HttpsConnector::new() failure: {}", e)) } fn new_(tls: TlsConnector) -> Self { let mut http = HttpConnector::new(); http.enforce_http(false); HttpsConnector::from((http, tls)) } } impl Default for HttpsConnector { fn default() -> Self { Self::new_with_connector(Default::default()) } } impl HttpsConnector { /// Force the use of HTTPS when connecting. /// /// If a URL is not `https` when connecting, an error is returned. pub fn https_only(&mut self, enable: bool) { self.force_https = enable; } /// With connector constructor /// pub fn new_with_connector(http: T) -> Self { native_tls::TlsConnector::new() .map(|tls| HttpsConnector::from((http, tls.into()))) .unwrap_or_else(|e| { panic!( "HttpsConnector::new_with_connector() failure: {}", e ) }) } } impl From<(T, TlsConnector)> for HttpsConnector { fn from(args: (T, TlsConnector)) -> HttpsConnector { HttpsConnector { force_https: false, http: args.0, tls: args.1, } } } impl fmt::Debug for HttpsConnector { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { f.debug_struct("HttpsConnector") .field("force_https", &self.force_https) .field("http", &self.http) .finish() } } impl Service for HttpsConnector where T: Service, T::Response: AsyncRead + AsyncWrite + Send + Unpin, T::Future: Send + 'static, T::Error: Into, { type Response = MaybeHttpsStream; type Error = BoxError; type Future = HttpsConnecting; fn poll_ready(&mut self, cx: &mut Context<'_>) -> Poll> { match self.http.poll_ready(cx) { Poll::Ready(Ok(())) => Poll::Ready(Ok(())), Poll::Ready(Err(e)) => Poll::Ready(Err(e.into())), Poll::Pending => Poll::Pending, } } fn call(&mut self, dst: Uri) -> Self::Future { let is_https = dst.scheme_str() == Some("https"); // Early abort if HTTPS is forced but can't be used if !is_https && self.force_https { return err(ForceHttpsButUriNotHttps.into()); } let host = dst .host() .unwrap_or("") .trim_matches(|c| c == '[' || c == ']') .to_owned(); let connecting = self.http.call(dst); let tls = self.tls.clone(); let fut = async move { let tcp = connecting.await.map_err(Into::into)?; let maybe = if is_https { let tls = tls.connect(&host, tcp).await?; MaybeHttpsStream::Https(tls) } else { MaybeHttpsStream::Http(tcp) }; Ok(maybe) }; HttpsConnecting(Box::pin(fut)) } } fn err(e: BoxError) -> HttpsConnecting { HttpsConnecting(Box::pin(async { Err(e) })) } type BoxedFut = Pin, BoxError>> + Send>>; /// A Future representing work to connect to a URL, and a TLS handshake. pub struct HttpsConnecting(BoxedFut); impl Future for HttpsConnecting { type Output = Result, BoxError>; fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll { Pin::new(&mut self.0).poll(cx) } } impl fmt::Debug for HttpsConnecting { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { f.pad("HttpsConnecting") } } // ===== Custom Errors ===== #[derive(Debug)] struct ForceHttpsButUriNotHttps; impl fmt::Display for ForceHttpsButUriNotHttps { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { f.write_str("https required but URI was not https") } } impl std::error::Error for ForceHttpsButUriNotHttps {}