Add pub unsafe accessors for object/session handles and ObjectHandle new

Signed-off-by: Jack Shannon <[email protected]>

Author: jhshannon17

cryptoki/src/object.rs

@@ -1029,9 +1029,23 @@ impl ObjectHandle {
         ObjectHandle { handle }
     }
 
+    /// Create a new object handle from a raw handle.
+    /// # Safety
+    /// Considered unsafe due to ability for client to arbitrarily create object handles.
+    pub unsafe fn new_from_raw(handle: CK_OBJECT_HANDLE) -> Self {
+        ObjectHandle { handle }
+    }
+
     pub(crate) fn handle(&self) -> CK_OBJECT_HANDLE {
         self.handle
     }
+
+    /// Get the raw handle of the object.
+    /// # Safety
+    /// Considered unsafe because of pub access to the underlying handle type.
+    pub unsafe fn raw_handle(&self) -> CK_OBJECT_HANDLE {
+        self.handle
+    }
 }
 
 impl std::fmt::Display for ObjectHandle {

cryptoki/src/session/mod.rs

@@ -80,6 +80,13 @@ impl Session {
         self.handle
     }
 
+    /// Get the raw handle of the session.
+    /// # Safety
+    /// Considered unsafe because of pub access to the underlying handle type.
+    pub unsafe fn raw_handle(&self) -> CK_SESSION_HANDLE {
+        self.handle
+    }
+
     pub(crate) fn client(&self) -> &Pkcs11 {
         &self.client
     }