Added SHA-3 OIDs. (RustCrypto#1000)

Author: bkstein

const-oid/oiddbgen/fips202.md

@@ -0,0 +1,31 @@
+Object Identifiers (OID) for SHA-3
+----------------------------------
+This document lists the OIDs for
+- SHA3-224,
+- SHA3-256,
+- SHA3-384,
+- SHA3-512,
+- SHAKE128, and
+- SHAKE256.
+
+This file was manually created, as there exists no offical document that is easily parsable.
+The SHA-3 standard is specified in [FIPS 202](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.202.pdf).
+It references [Computer Security Objects Register (CSOR)]
+(https://csrc.nist.gov/projects/computer-security-objects-register/algorithm-registration),
+which publishes the following SHA-3 OIDs:
+
+nistAlgorithms OBJECT IDENTIFIER ::= { joint-iso-ccitt(2) country(16) us(840) organization(1) gov(101) csor(3) nistAlgorithm(4) }
+
+hashAlgs OBJECT IDENTIFIER ::= { nistAlgorithms 2 }
+
+id-sha3-224 OBJECT IDENTIFIER ::= { hashAlgs 7 }
+
+id-sha3-256 OBJECT IDENTIFIER ::= { hashAlgs 8 }
+
+id-sha3-384 OBJECT IDENTIFIER ::= { hashAlgs 9 }
+
+id-sha3-512 OBJECT IDENTIFIER ::= { hashAlgs 10 }
+
+id-shake128 OBJECT IDENTIFIER ::= { hashAlgs 11 }
+
+id-shake256 OBJECT IDENTIFIER ::= { hashAlgs 12 }

const-oid/oiddbgen/src/main.rs

@@ -17,8 +17,13 @@ const RFCS: &[(&str, &str)] = &[
     ("rfc8410", include_str!("../rfc8410.txt")),
 ];
 
+// Created from:
+// https://csrc.nist.gov/projects/computer-security-objects-register/algorithm-registration
+const FIPS202: &str = include_str!("../fips202.md");
+
 // Bases defined in other places.
 const BASES: &[(&str, &str)] = &[("id-ad-ocsp", "1.3.6.1.5.5.7.48.1")];
+const NO_BASES: &[(&str, &str)] = &[("","")];
 
 fn main() {
     let mut root = Root::default();
@@ -33,5 +38,9 @@ fn main() {
         }
     }
 
+    for (name, obid) in Asn1Parser::new(FIPS202, NO_BASES).iter() {
+        root.add("fips202", &name, &obid);
+    }
+
     println!("{}", root.module());
 }

const-oid/src/db/gen.rs

@@ -1,4 +1,22 @@
 #![doc = "!! DO NOT EDIT !!: This file is auto-generated by oiddbgen."]
+pub mod fips202 {
+    pub const NIST_ALGORITHMS: crate::ObjectIdentifier =
+        crate::ObjectIdentifier::new_unwrap("2.16.840.1.101.3.4");
+    pub const HASH_ALGS: crate::ObjectIdentifier =
+        crate::ObjectIdentifier::new_unwrap("2.16.840.1.101.3.4.2");
+    pub const ID_SHA_3_512: crate::ObjectIdentifier =
+        crate::ObjectIdentifier::new_unwrap("2.16.840.1.101.3.4.2.10");
+    pub const ID_SHAKE_128: crate::ObjectIdentifier =
+        crate::ObjectIdentifier::new_unwrap("2.16.840.1.101.3.4.2.11");
+    pub const ID_SHAKE_256: crate::ObjectIdentifier =
+        crate::ObjectIdentifier::new_unwrap("2.16.840.1.101.3.4.2.12");
+    pub const ID_SHA_3_224: crate::ObjectIdentifier =
+        crate::ObjectIdentifier::new_unwrap("2.16.840.1.101.3.4.2.7");
+    pub const ID_SHA_3_256: crate::ObjectIdentifier =
+        crate::ObjectIdentifier::new_unwrap("2.16.840.1.101.3.4.2.8");
+    pub const ID_SHA_3_384: crate::ObjectIdentifier =
+        crate::ObjectIdentifier::new_unwrap("2.16.840.1.101.3.4.2.9");
+}
 pub mod rfc1274 {
     pub const TEXT_ENCODED_OR_ADDRESS: crate::ObjectIdentifier =
         crate::ObjectIdentifier::new_unwrap("0.9.2342.19200300.100.1.2");
@@ -2258,6 +2276,14 @@ pub mod rfc8410 {
         crate::ObjectIdentifier::new_unwrap("1.3.101.113");
 }
 pub const DB: super::Database<'static> = super::Database(&[
+    (&fips202::NIST_ALGORITHMS, "nistAlgorithms"),
+    (&fips202::HASH_ALGS, "hashAlgs"),
+    (&fips202::ID_SHA_3_512, "id-sha3-512"),
+    (&fips202::ID_SHAKE_128, "id-shake128"),
+    (&fips202::ID_SHAKE_256, "id-shake256"),
+    (&fips202::ID_SHA_3_224, "id-sha3-224"),
+    (&fips202::ID_SHA_3_256, "id-sha3-256"),
+    (&fips202::ID_SHA_3_384, "id-sha3-384"),
     (&rfc1274::TEXT_ENCODED_OR_ADDRESS, "textEncodedORAddress"),
     (&rfc1274::OTHER_MAILBOX, "otherMailbox"),
     (&rfc1274::LAST_MODIFIED_TIME, "lastModifiedTime"),