#asn1-der #asn-1 #itu #pkcs

no-std der

Pure Rust embedded-friendly implementation of the Distinguished Encoding Rules (DER) for Abstract Syntax Notation One (ASN.1) as described in ITU X.690 with full support for heapless no_std targets

31 releases

0.8.0-rc.1 Aug 18, 2024
0.8.0-rc.0 Jul 26, 2024
0.8.0-pre.0 Jan 7, 2024
0.7.9 Apr 1, 2024
0.1.0 Dec 22, 2020

#288 in Cryptography

Download history 936408/week @ 2024-06-19 960394/week @ 2024-06-26 862370/week @ 2024-07-03 977140/week @ 2024-07-10 1030714/week @ 2024-07-17 1021216/week @ 2024-07-24 1071261/week @ 2024-07-31 1098864/week @ 2024-08-07 1056014/week @ 2024-08-14 1151515/week @ 2024-08-21 1034547/week @ 2024-08-28 1149737/week @ 2024-09-04 1097775/week @ 2024-09-11 1091736/week @ 2024-09-18 1152959/week @ 2024-09-25 966747/week @ 2024-10-02

4,521,457 downloads per month
Used in 4,907 crates (81 directly)

Apache-2.0 OR MIT

440KB
10K SLoC

RustCrypto: ASN.1 DER

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

Pure Rust embedded-friendly implementation of the Distinguished Encoding Rules (DER) for Abstract Syntax Notation One (ASN.1) as described in ITU X.690.

Documentation

About

This crate provides a no_std-friendly implementation of a subset of ASN.1 DER necessary for decoding/encoding the following cryptography-related formats implemented as crates maintained by the RustCrypto project:

  • cms: Cryptographic Message Syntax
  • pkcs1: RSA Cryptography Specifications
  • pkcs5: Password-Based Cryptography Specification
  • pkcs8: Private-Key Information Syntax Specification
  • pkcs12: Personal Information Exchange Syntax
  • sec1: Elliptic Curve Cryptography
  • spki: X.509 Subject Public Key Info
  • x509-cert: Public Key Infrastructure Certificate
  • x509-ocsp: Online Certificate Status Protocol

The core implementation avoids any heap usage (with convenience methods that allocate gated under the off-by-default alloc feature).

The DER decoder in this crate performs checks to ensure that the input document is in canonical form, and will return errors if non-canonical productions are encountered. There is currently no way to disable these checks.

Features

  • Rich support for ASN.1 types used by PKCS/PKIX documents
  • Performs DER canonicalization checks at decoding time
  • no_std friendly: supports "heapless" usage
  • Optionally supports alloc and std if desired
  • No hard dependencies! Self-contained implementation with optional integrations with the following crates, all of which are no_std friendly:
    • const-oid: const-friendly OID implementation
    • pem-rfc7468: PKCS/PKIX-flavored PEM library with constant-time decoder/encoders
    • time crate: date/time library

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

~0–370KB