Skip to main content

opentdf_kas/
lib.rs

1//! OpenTDF KAS (Key Access Service) Server Crypto Operations
2//!
3//! This crate provides server-side cryptographic operations for KAS implementations:
4//! - EC P-256 keypair management for NanoTDF
5//! - RSA-2048 keypair management for Standard TDF
6//! - ECDH key agreement and rewrap for NanoTDF
7//! - RSA-OAEP unwrap and rewrap for Standard TDF
8//! - NanoTDF version detection and salt computation
9//!
10//! # Features
11//!
12//! - `ec` (default): EC P-256 support for NanoTDF
13//! - `rsa`: RSA-2048 support for Standard TDF
14//!
15//! # Example
16//!
17//! ```
18//! use opentdf_kas::{KasEcKeypair, ec_unwrap};
19//!
20//! # fn example() -> Result<(), opentdf_kas::KasServerError> {
21//! // Generate KAS EC keypair
22//! let kas_keypair = KasEcKeypair::generate()?;
23//!
24//! // Parse client public key from PEM
25//! let client_pem = kas_keypair.public_key_pem(); // In practice, from client
26//! let _client_public = KasEcKeypair::parse_public_key_pem(client_pem)?;
27//!
28//! // EC unwrap would be called with NanoTDF header and ephemeral key
29//! // let rewrapped = ec_unwrap(header, ephemeral_key, kas_keypair.private_key(), session_secret)?;
30//! # Ok(())
31//! # }
32//! ```
33
34#![allow(deprecated)] // For aes_gcm generic_array 0.x
35
36pub mod error;
37pub mod keypair;
38pub mod rewrap;
39pub mod salt;
40pub mod types;
41pub mod unwrap;
42
43// Re-export error types
44pub use error::KasServerError;
45
46// Re-export keypair types
47#[cfg(feature = "rsa")]
48pub use keypair::KasRsaKeypair;
49pub use keypair::{KasEcKeypair, KasKeypair};
50
51// Re-export rewrap functions
52pub use rewrap::{encode_wrapped_key, rewrap_dek, rewrap_dek_simple};
53
54// Re-export salt functions
55pub use salt::{
56    NANOTDF_MAGIC, NanoTdfVersion, compute_nanotdf_salt, compute_nanotdf_salt_from_byte,
57    detect_nanotdf_version,
58};
59
60// Re-export types
61pub use types::{KeyAccessObject, KeyAlgorithm, KeyInfo, RewrapResult};
62
63// Re-export unwrap functions
64#[cfg(feature = "rsa")]
65pub use unwrap::rsa_unwrap;
66pub use unwrap::{custom_ecdh, ec_unwrap};
67
68// Re-export underlying crypto libraries for advanced use cases
69pub use p256;
70#[cfg(feature = "rsa")]
71pub use rsa;