#oid #iso-iec #iso #itu #iec #embedded #namespaces

no-std const-oid

Const-friendly implementation of the ISO/IEC Object Identifier (OID) standard as defined in ITU X.660, with support for BER/DER encoding/decoding as well as heapless no_std (i.e. embedded) support

31 releases

Uses new Rust 2024

0.10.0 Feb 24, 2025
0.10.0-rc.3 Nov 3, 2024
0.10.0-rc.2 Oct 7, 2024
0.10.0-rc.0 Jul 26, 2024
0.2.0 Sep 5, 2020

#40 in Encoding

Download history 1140631/week @ 2024-11-19 951985/week @ 2024-11-26 1141825/week @ 2024-12-03 1235678/week @ 2024-12-10 1048325/week @ 2024-12-17 462933/week @ 2024-12-24 706261/week @ 2024-12-31 1315256/week @ 2025-01-07 1318166/week @ 2025-01-14 1338716/week @ 2025-01-21 1486206/week @ 2025-01-28 1557749/week @ 2025-02-04 1644726/week @ 2025-02-11 1592677/week @ 2025-02-18 1596004/week @ 2025-02-25 2013680/week @ 2025-03-04

7,111,652 downloads per month
Used in 5,898 crates (49 directly)

Apache-2.0 OR MIT

325KB
6.5K SLoC

RustCrypto: Object Identifiers (OIDs)

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

Const-friendly implementation of the ISO/IEC Object Identifier (OID) standard as defined in ITU X.660, with support for BER/DER encoding/decoding as well as heapless no_std (i.e. embedded) environments.

Documentation

About OIDs

Object Identifiers, a.k.a. OIDs, are an International Telecommunications Union (ITU) and ISO/IEC standard for naming any object, concept, or "thing" with a globally unambiguous persistent name.

The ITU's X.660 standard provides the OID specification. Every OID is part of a hierarchical namespace which begins with a root OID, which is either the ITU's root OID (0), the ISO's root OID (1), or the joint ISO/ITU root OID (2).

The following is an example of an OID, in this case identifying the rsaEncryption algorithm:

1.2.840.113549.1.1.1

For more information, see: https://en.wikipedia.org/wiki/Object_identifier

Implementation

This library supports parsing OIDs in const contexts, e.g.:

use const_oid::ObjectIdentifier;

pub const MY_OID: ObjectIdentifier = ObjectIdentifier::new_unwrap("1.2.840.113549.1.1.1");

The OID parser is implemented entirely in terms of const fn and without the use of proc macros.

Additionally, it also includes a const fn OID serializer, and stores the OIDs parsed from const contexts encoded using the BER/DER serialization (sans header).

This allows ObjectIdentifier to impl AsRef<[u8]> which can be used to obtain the BER/DER serialization of an OID, even one declared const.

Additionally, it impls FromStr and TryFrom<&[u8]> and functions just as well as a runtime OID library.

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