Crate spki

RustCrypto: X.509 Subject Public Key Info (SPKI)

X.509 Subject Public Key Info types describing public keys as well as their associated AlgorithmIdentifiers (i.e. OIDs).

Specified in RFC 5280 § 4.1.

Documentation

Minimum Supported Rust Version

This crate requires Rust 1.65 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:

• Apache License, Version 2.0
• MIT license

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.

Usage

The following example demonstrates how to use an OID as the parameters of an AlgorithmIdentifier.

Borrow the ObjectIdentifier first then use der::AnyRef::from or .into():

use spki::{AlgorithmIdentifier, ObjectIdentifier};

let alg_oid = "1.2.840.10045.2.1".parse::<ObjectIdentifier>().unwrap();
let params_oid = "1.2.840.10045.3.1.7".parse::<ObjectIdentifier>().unwrap();

let alg_id = AlgorithmIdentifier {
    oid: alg_oid,
    parameters: Some(params_oid)
};

Re-exports

• pub use der;

Structs

• AlgorithmIdentifier
  X.509 AlgorithmIdentifier as defined in RFC 5280 Section 4.1.1.2.
• Documentalloc
  ASN.1 DER-encoded document.
• ObjectIdentifier
  Object identifier (OID).
• SubjectPublicKeyInfo
  X.509 SubjectPublicKeyInfo (SPKI) as defined in RFC 5280 § 4.1.2.7.

Enums

• Error
  Error type

Traits

• AssociatedAlgorithmIdentifier
  Returns AlgorithmIdentifier associated with the structure.
• DecodePublicKey
  Parse a public key object from an encoded SPKI document.
• DynAssociatedAlgorithmIdentifieralloc
  Returns AlgorithmIdentifier associated with the structure.
• DynSignatureAlgorithmIdentifieralloc
  Returns AlgorithmIdentifier associated with the signature system.
• EncodePublicKeyalloc
  Serialize a public key object to a SPKI-encoded document.
• SignatureAlgorithmIdentifier
  Returns AlgorithmIdentifier associated with the signature system.
• SignatureBitStringEncodingalloc
  Returns the BitString encoding of the signature.

Type Aliases

• AlgorithmIdentifierOwnedalloc
  AlgorithmIdentifier reference which has Any parameters.
• AlgorithmIdentifierRef
  AlgorithmIdentifier reference which has AnyRef parameters.
• AlgorithmIdentifierWithOid
  AlgorithmIdentifier with ObjectIdentifier parameters.
• FingerprintBytesfingerprint
  Raw bytes of a SPKI fingerprint i.e. SHA-256 digest of SubjectPublicKeyInfo’s DER encoding.
• Result
  Result type with spki crate’s Error type.
• SubjectPublicKeyInfoOwnedalloc
  SubjectPublicKeyInfo with Any algorithm parameters, and BitString params.
• SubjectPublicKeyInfoRef
  SubjectPublicKeyInfo with AnyRef algorithm parameters, and BitStringRef params.