core
/
trifid
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects 7 Releases Wiki Activity

finish up trifid-pki for now

This commit is contained in:
core 2023-02-27 19:04:28 -05:00
parent b0872780dd
commit 2bc8544140
Signed by: core
GPG Key ID: FDBF740DADDCEECF
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
trifid-pki/src/lib.rs
View File

@ -3,6 +3,35 @@
//! It is designed to be interoperable with the original Go implementation and as such has some oddities with key management to ensure compatability.
//!
//! This crate has not received any formal security audits, however the underlying crates used for actual cryptographic operations (ed25519-dalek and curve25519-dalek) have been audited with no major issues.
//! # Examples
//! ## Load a certificate from PEM
//! ```rust
//! use trifid_pki::cert::deserialize_nebula_certificate_from_pem;
//! let cert_bytes = b"-----BEGIN NEBULA CERTIFICATE-----
//! CmUKCGNvcmUtdHdyEgmBhMRQgID4/w8orp+/nAYwlIXEqwY6IDBOYnnYci8P2Nlm
//! +qcK2u7AjEZJ1IZFe7A4viQ3U6dHSiBWhg3tPRS387d8oqBi7l1oPdBrNfh0RtjW
//! p+kjtqd4PRJA611raI7aDTbpJSGcCY/yeZ5CIHoJP32bfYdYI8oFsuDTp0ndL8nO
//! yBHtmihl1xxNU8/f0b9+bVBYvZ7NOI3fDQ==
//! -----END NEBULA CERTIFICATE-----";
//! let cert = deserialize_nebula_certificate_from_pem(cert_bytes).unwrap();
//! println!("{}", cert);
//! // NebulaCertificate {
//! // Details {
//! // Name: core-twr
//! // Ips: [10.17.2.1/15]
//! // Subnets: []
//! // Gruops: []
//! // Not before: SystemTime { tv_sec: 1670369198, tv_nsec: 0 }
//! // Not after: SystemTime { tv_sec: 1701905044, tv_nsec: 0 }
//! // Is CA: false
//! // Issuer: 56860ded3d14b7f3b77ca2a062ee5d683dd06b35f87446d8d6a7e923b6a7783d
//! // Public key: 304e6279d8722f0fd8d966faa70adaeec08c4649d486457bb038be243753a747
//! // }
//! // Fingerprint: c1a723acf8a1c8a438eb1f8efb756eb9e1a3c529d5b93cd143d282ca87e549b4
//! // Signature: eb5d6b688eda0d36e925219c098ff2799e42207a093f7d9b7d875823ca05b2e0d3a749dd2fc9cec811ed9a2865d71c4d53cfdfd1bf7e6d5058bd9ecd388ddf0d
//! // }
//! ```
#![warn(clippy::pedantic)]
#![warn(clippy::nursery)]
@ -16,6 +45,9 @@
#![allow(clippy::too_many_lines)]
#![allow(clippy::module_name_repetitions)]
pub use ed25519_dalek;
pub use x25519_dalek;
pub use rand_core;
extern crate core;