Module cose 

This file contains private-use constants for COSE encoded key types and algorithms. Standardized values from https://www.iana.org/assignments/cose/cose.xhtml should always be preferred unless there is a a clear benefit, such as a clear cryptographic benefit, which MUST be documented publicly.

Structs

DecryptFailed

Enums

CoseExtractError 🔒

SafeObjectNamespace 🔒

Constants

ALG_ARGON2ID13 🔒

ARGON2_ITERATIONS 🔒

ARGON2_MEMORY 🔒

ARGON2_PARALLELISM 🔒

ARGON2_SALT 🔒

CONTAINED_KEY_ID 🔒

Indicates for any object containing a key (wrapped key, password protected key envelope) which key ID that contained key has

CONTENT_TYPE_BITWARDEN_LEGACY_KEY 🔒

CONTENT_TYPE_PADDED_CBOR 🔒

CONTENT_TYPE_PADDED_UTF8 🔒

CONTENT_TYPE_SPKI_PUBLIC_KEY 🔒

SAFE_CONTENT_NAMESPACE 🔒

Each type of object has it’s own namespace for strong domain separation to eliminate attacks which attempt to confuse object types. For signatures, this refers to signature namespaces, for data envelopes to data envelope namespaces and so on.

SAFE_OBJECT_NAMESPACE 🔒

MUST be placed in the protected header of cose objects

SIGNING_NAMESPACE 🔒

The label used for the namespace ensuring strong domain separation when using signatures.

SYMMETRIC_KEY 🔒

XCHACHA20_POLY1305 🔒

XChaCha20 https://datatracker.ietf.org/doc/html/draft-irtf-cfrg-xchacha-03 is used over ChaCha20 to be able to randomly generate nonces, and to not have to worry about key wearout. Since the draft was never published as an RFC, we use a private-use value for the algorithm.

XCHACHA20_TEXT_PAD_BLOCK_SIZE 🔒

Traits

ContentNamespace 🔒

CoseSerializable

Trait for structs that are serializable to COSE objects.

Functions

debug_key_operation 🔒

Helper function to convert a COSE KeyOperation to a debug string

decrypt_cose 🔒

Decrypt a CoseEncrypt0 message with a CoseKey

decrypt_xchacha20_poly1305 🔒

Decrypts a COSE Encrypt0 message, using a XChaCha20Poly1305 key

encrypt_cose 🔒

Encrypt a plaintext message with a given key

encrypt_xchacha20_poly1305 🔒

Encrypts a plaintext message using XChaCha20Poly1305 and returns a COSE Encrypt0 message

extract_bytes 🔒

extract_integer 🔒

should_pad_content 🔒