feat: Expose parsed X509 certificates and add extra impls to generated bindings

Author: AnthonyGrondin

esp-mbedtls-sys/src/extra_impls.rs

@@ -0,0 +1,13 @@
+//! Provide extra implementations to the generated bindings
+
+
+impl core::fmt::Debug for crate::bindings::mbedtls_x509_time {
+    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
+        write!(
+            f,
+            // ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ
+            "{:04}-{:02}-{:02}T{:02}:{:02}:{:02}Z",
+            self.year, self.mon, self.day, self.hour, self.min, self.sec
+        )
+    }
+}

esp-mbedtls-sys/src/lib.rs

@@ -11,6 +11,7 @@ use esp_wifi as _;
 
 #[cfg(not(target_os = "espidf"))]
 mod c_types;
+mod extra_impls;
 
 #[allow(
     non_camel_case_types,

esp-mbedtls/src/lib.rs

@@ -618,6 +618,30 @@ impl Certificates<'_> {
         }
     }
 
+    /// Get a reference to the underlying parsed X509 peer certificate, if configured
+    pub fn certificate(&self) -> Option<&mbedtls_x509_crt> {
+        self.certificate.as_ref().and_then(|certificate| {
+            let ptr = certificate.crt;
+            if ptr.is_null() {
+                None
+            } else {
+                Some(unsafe { &*ptr })
+            }
+        })
+    }
+
+    /// Get a reference to the underlying parsed CA Chain X509 certificate, if configured
+    pub fn ca_chain(&self) -> Option<&mbedtls_x509_crt> {
+        self.ca_chain.as_ref().and_then(|ca_chain| {
+            let ptr = ca_chain.crt;
+            if ptr.is_null() {
+                None
+            } else {
+                Some(unsafe { &*ptr })
+            }
+        })
+    }
+
     /// Initialize the own certificate chain and private key used for requests
     /// It should contain in order from the bottom up your certificate chain.
     /// The top certificate (self-signed) can be omitted.