125 lines
3.5 KiB
Rust
125 lines
3.5 KiB
Rust
use std::fmt;
|
|
use native_tls;
|
|
|
|
/// Represent an X509 certificate.
|
|
pub struct Certificate(native_tls::Certificate);
|
|
|
|
impl Certificate {
|
|
/// Create a `Certificate` from a binary DER encoded certificate
|
|
///
|
|
/// # Examples
|
|
///
|
|
/// ```
|
|
/// # use std::fs::File;
|
|
/// # use std::io::Read;
|
|
/// # fn cert() -> Result<(), Box<std::error::Error>> {
|
|
/// let mut buf = Vec::new();
|
|
/// File::open("my_cert.der")?
|
|
/// .read_to_end(&mut buf)?;
|
|
/// let cert = reqwest::Certificate::from_der(&buf)?;
|
|
/// # drop(cert);
|
|
/// # Ok(())
|
|
/// # }
|
|
/// ```
|
|
///
|
|
/// # Errors
|
|
///
|
|
/// If the provided buffer is not valid DER, an error will be returned.
|
|
pub fn from_der(der: &[u8]) -> ::Result<Certificate> {
|
|
let inner = try_!(native_tls::Certificate::from_der(der));
|
|
Ok(Certificate(inner))
|
|
}
|
|
|
|
|
|
/// Create a `Certificate` from a PEM encoded certificate
|
|
///
|
|
/// # Examples
|
|
///
|
|
/// ```
|
|
/// # use std::fs::File;
|
|
/// # use std::io::Read;
|
|
/// # fn cert() -> Result<(), Box<std::error::Error>> {
|
|
/// let mut buf = Vec::new();
|
|
/// File::open("my_cert.pem")?
|
|
/// .read_to_end(&mut buf)?;
|
|
/// let cert = reqwest::Certificate::from_pem(&buf)?;
|
|
/// # drop(cert);
|
|
/// # Ok(())
|
|
/// # }
|
|
/// ```
|
|
///
|
|
/// # Errors
|
|
///
|
|
/// If the provided buffer is not valid PEM, an error will be returned.
|
|
pub fn from_pem(der: &[u8]) -> ::Result<Certificate> {
|
|
let inner = try_!(native_tls::Certificate::from_pem(der));
|
|
Ok(Certificate(inner))
|
|
}
|
|
|
|
pub(crate) fn cert(self) -> native_tls::Certificate {
|
|
self.0
|
|
}
|
|
|
|
}
|
|
|
|
impl fmt::Debug for Certificate {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
f.debug_struct("Certificate")
|
|
.finish()
|
|
}
|
|
}
|
|
|
|
|
|
/// Represent a private key and X509 cert as a client certificate.
|
|
pub struct Identity(native_tls::Identity);
|
|
|
|
impl Identity {
|
|
/// Parses a DER-formatted PKCS #12 archive, using the specified password to decrypt the key.
|
|
///
|
|
/// The archive should contain a leaf certificate and its private key, as well any intermediate
|
|
/// certificates that allow clients to build a chain to a trusted root.
|
|
/// The chain certificates should be in order from the leaf certificate towards the root.
|
|
///
|
|
/// PKCS #12 archives typically have the file extension `.p12` or `.pfx`, and can be created
|
|
/// with the OpenSSL `pkcs12` tool:
|
|
///
|
|
/// ```bash
|
|
/// openssl pkcs12 -export -out identity.pfx -inkey key.pem -in cert.pem -certfile chain_certs.pem
|
|
/// ```
|
|
///
|
|
/// # Examples
|
|
///
|
|
/// ```
|
|
/// # use std::fs::File;
|
|
/// # use std::io::Read;
|
|
/// # fn pkcs12() -> Result<(), Box<std::error::Error>> {
|
|
/// let mut buf = Vec::new();
|
|
/// File::open("my-ident.pfx")?
|
|
/// .read_to_end(&mut buf)?;
|
|
/// let pkcs12 = reqwest::Identity::from_pkcs12_der(&buf, "my-privkey-password")?;
|
|
/// # drop(pkcs12);
|
|
/// # Ok(())
|
|
/// # }
|
|
/// ```
|
|
///
|
|
/// # Errors
|
|
///
|
|
/// If the provided buffer is not valid DER, an error will be returned.
|
|
pub fn from_pkcs12_der(der: &[u8], password: &str) -> ::Result<Identity> {
|
|
let inner = try_!(native_tls::Identity::from_pkcs12(der, password));
|
|
Ok(Identity(inner))
|
|
}
|
|
|
|
pub(crate) fn pkcs12(self) -> native_tls::Identity {
|
|
self.0
|
|
}
|
|
}
|
|
|
|
impl fmt::Debug for Identity {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
f.debug_struct("Identity")
|
|
.finish()
|
|
}
|
|
}
|
|
|