#private-key #pkcs #key-derivation #encryption-key #key #private #key-pair

no-std pkcs8

Pure Rust implementation of Public-Key Cryptography Standards (PKCS) #8: Private-Key Information Syntax Specification (RFC 5208), with additional support for PKCS#8v2 asymmetric key packages (RFC 5958)

31 releases

0.11.0-rc.1 Sep 6, 2024
0.11.0-rc.0 Jul 26, 2024
0.11.0-pre.0 Jan 8, 2024
0.10.2 Apr 5, 2023
0.0.0 Jun 12, 2020

#320 in Cryptography

Download history 993047/week @ 2024-08-18 968539/week @ 2024-08-25 940791/week @ 2024-09-01 984203/week @ 2024-09-08 937202/week @ 2024-09-15 1028792/week @ 2024-09-22 1033195/week @ 2024-09-29 1094053/week @ 2024-10-06 1089541/week @ 2024-10-13 1209740/week @ 2024-10-20 1158131/week @ 2024-10-27 1197925/week @ 2024-11-03 1172162/week @ 2024-11-10 1235939/week @ 2024-11-17 1065797/week @ 2024-11-24 1222832/week @ 2024-12-01

4,761,883 downloads per month
Used in 3,621 crates (77 directly)

Apache-2.0 OR MIT

435KB
10K SLoC

RustCrypto: PKCS#8 (Private Keys)

crate Docs Build Status Apache2/MIT licensed Rust Version Project Chat

Pure Rust implementation of Public-Key Cryptography Standards (PKCS) #8: Private-Key Information Syntax Specification (RFC 5208).

Documentation

About PKCS#8

PKCS#8 is a format for cryptographic private keys, often containing pairs of private and public keys.

You can identify a PKCS#8 private key encoded as PEM (i.e. text) by the following:

-----BEGIN PRIVATE KEY-----

PKCS#8 private keys can optionally be encrypted under a password using key derivation algorithms like PBKDF2 and scrypt, and encrypted with ciphers like AES-CBC. When a PKCS#8 private key has been encrypted, it starts with the following:

-----BEGIN ENCRYPTED PRIVATE KEY-----

PKCS#8 private keys can also be serialized in an ASN.1-based binary format. The PEM text encoding is a Base64 representation of this format.

Supported Algorithms

This crate is implemented in an algorithm-agnostic manner with the goal of enabling PKCS#8 support for any algorithm.

That said, it has been tested for interoperability against keys generated by OpenSSL for the following algorithms:

  • ECC (id-ecPublicKey)
  • Ed25519 (id-Ed25519)
  • RSA (id-rsaEncryption)
  • X25519 (id-X25519)

Please open an issue if you encounter trouble using it with a particular algorithm, including the ones listed above or other algorithms.

Minimum Supported Rust Version

This crate requires Rust 1.71 at a minimum.

We may change the MSRV in the future, but it will be accompanied by a minor version bump.

License

Licensed under either of:

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~320–670KB
~12K SLoC