riptering 0.7.0

Maintained fork of kryptering: cryptographic operations with RustCrypto or AWS-LC software providers and PKCS#11 HSM backends
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

//! riptering: one provider-neutral cryptography API over a software provider
//! selected at compile time (RustCrypto or AWS-LC) and over PKCS#11 HSMs.
//!
//! riptering is Rhein Industries' maintained fork of
//! [kryptering](https://github.com/kushaldas/kryptering) by Kushal Das and is
//! not affiliated with or endorsed by the upstream author. See the
//! [README](https://github.com/Rhein-Industries/riptering#readme) for the
//! differences from kryptering 0.5.0, feature selection and examples.

#[cfg(not(any(feature = "rustcrypto", feature = "aws-lc")))]
compile_error!("select exactly one document provider: rustcrypto or aws-lc");
#[cfg(all(feature = "rustcrypto", feature = "aws-lc"))]
compile_error!(
    "document provider features are mutually exclusive: select exactly one of rustcrypto or aws-lc"
);
#[cfg(all(feature = "tls-ring", feature = "tls-aws-lc"))]
compile_error!(
    "TLS provider features are mutually exclusive: select at most one of tls-ring or tls-aws-lc"
);
#[cfg(all(feature = "fips", feature = "rustcrypto"))]
compile_error!("fips cannot be combined with the RustCrypto document provider");
#[cfg(all(feature = "fips", feature = "tls-ring"))]
compile_error!("fips cannot be combined with the ring TLS provider");
#[cfg(all(
    any(feature = "aws-lc", feature = "tls-aws-lc"),
    not(all(
        any(target_os = "linux", all(target_os = "macos", not(feature = "fips"))),
        any(target_arch = "x86_64", target_arch = "aarch64")
    ))
))]
compile_error!("AWS-LC requires Linux or non-FIPS macOS on x86_64/aarch64");

pub mod algorithm;
pub mod backend;
#[cfg(feature = "rustcrypto")]
pub mod digest;
#[cfg(not(feature = "rustcrypto"))]
#[path = "alternate/digest.rs"]
pub mod digest;
pub mod error;
#[cfg(feature = "rustcrypto")]
pub mod hazmat;
#[cfg(not(feature = "rustcrypto"))]
#[path = "alternate/hazmat.rs"]
pub mod hazmat;
#[cfg(feature = "rustcrypto")]
pub mod kdf;
#[cfg(not(feature = "rustcrypto"))]
#[path = "alternate/kdf.rs"]
pub mod kdf;
#[cfg(feature = "rustcrypto")]
pub mod key;
#[cfg(not(feature = "rustcrypto"))]
#[path = "alternate/key.rs"]
pub mod key;
pub mod parameters;
pub mod pkcs12;
#[cfg(feature = "rustcrypto")]
pub mod software;
#[cfg(not(feature = "rustcrypto"))]
#[path = "alternate/software.rs"]
pub mod software;
pub mod traits;

#[cfg(all(feature = "pkcs11", not(target_arch = "wasm32")))]
pub mod pkcs11;

// Re-export core types at crate root for convenience.
pub use algorithm::*;
pub use backend::*;
pub use error::{Error, Result};
pub use key::SoftwareKey;
pub use parameters::DhParameters;
pub use traits::*;

// Re-export software backend types.
pub use software::cipher;
#[cfg(all(feature = "post-quantum", feature = "rustcrypto"))]
pub use software::composite::generate_composite_ml_dsa;
#[cfg(feature = "post-quantum")]
pub use software::kem::{generate_ml_kem, SoftwareDecapsulator, SoftwareEncapsulator};
pub use software::keyagreement;
pub use software::keytransport;
pub use software::keywrap;
#[cfg(feature = "post-quantum")]
pub use software::sign::generate_ml_dsa;
#[cfg(feature = "rustcrypto")]
pub use software::sign::{SoftwareSigner, SoftwareVerifier};
#[cfg(not(feature = "rustcrypto"))]
pub use software::{SoftwareSigner, SoftwareVerifier};