Loading...
Searching...
No Matches
pdftron::Crypto::DigestAlgorithm Class Reference

#include <DigestAlgorithm.h>

Public Types

enum  Type {
  e_SHA1 = 0 , e_SHA256 = 1 , e_SHA384 = 2 , e_SHA512 = 3 ,
  e_RIPEMD160 = 4 , e_unknown_digest_algorithm = 5
}

Static Public Member Functions

static std::vector< UChar > CalculateDigest (DigestAlgorithm::Type in_digest_algorithm_type, const std::vector< UChar > &in_message_buf)
static std::vector< UChar > SignDigest (const std::vector< UChar > &digest_buf, const DigestAlgorithm::Type digest_algorithm_type, const UString pkcs12_keyfile_path, const UString pkcs12_password)
static std::vector< UChar > SignDigest (const std::vector< UChar > &digest_buf, const DigestAlgorithm::Type digest_algorithm_type, const std::vector< UChar > &pkcs12_buf, const UString pkcs12_password)
static std::vector< UChar > CalculateDigest (DigestAlgorithm::Type in_digest_algorithm_type, const UChar *in_message_buf, const size_t in_message_buf_size)
static std::vector< UChar > SignDigest (const UChar *digest_buf, const size_t digest_buf_size, const DigestAlgorithm::Type digest_algorithm_type, const UString pkcs12_keyfile_path, const UString pkcs12_password)
static std::vector< UChar > SignDigest (const UChar *digest_buf, const size_t digest_buf_size, const DigestAlgorithm::Type digest_algorithm_type, const UChar *pkcs12_buf, const size_t pkcs12_buf_size, const UString pkcs12_password)

Detailed Description

Definition at line 17 of file DigestAlgorithm.h.

Member Enumeration Documentation

◆ Type

enum pdftron::Crypto::DigestAlgorithm::Type
Enumerator
e_SHA1 
e_SHA256 
e_SHA384 
e_SHA512 
e_RIPEMD160 
e_unknown_digest_algorithm 

Definition at line 21 of file DigestAlgorithm.h.

Member Function Documentation

◆ CalculateDigest() [1/2]

std::vector< UChar > pdftron::Crypto::DigestAlgorithm::CalculateDigest ( DigestAlgorithm::Type in_digest_algorithm_type,
const std::vector< UChar > & in_message_buf )
static

Calculates a digest of arbitrary data. Useful during CMS generation custom signing workflows for digesting signedAttributes before sending off for CMS signatureValue generation (e.g. by HSM device or cloud signing platform).

Parameters
in_digest_algorithm_type– the digest algorithm to use
in_message_buf– the message to digest
Returns
a container of bytes corresponding to the digest of the message

◆ CalculateDigest() [2/2]

std::vector< UChar > pdftron::Crypto::DigestAlgorithm::CalculateDigest ( DigestAlgorithm::Type in_digest_algorithm_type,
const UChar * in_message_buf,
const size_t in_message_buf_size )
static

Calculates a digest of arbitrary data. Useful during CMS generation custom signing workflows for digesting signedAttributes before sending off for CMS signatureValue generation (e.g. by HSM device or cloud signing platform).

Parameters
in_digest_algorithm_type– the digest algorithm to use
in_message_buf– the message to digest
in_message_buf_size– the size of in_message_buf
Returns
a container of bytes corresponding to the digest of the message

◆ SignDigest() [1/4]

std::vector< UChar > pdftron::Crypto::DigestAlgorithm::SignDigest ( const std::vector< UChar > & digest_buf,
const DigestAlgorithm::Type digest_algorithm_type,
const std::vector< UChar > & pkcs12_buf,
const UString pkcs12_password )
static

Sign the digest of arbitrary data with private key in the provided PKCS #12 key file (.pfx). This function is part of the low-level custom signing API, and works with GenerateESSSigningCertPAdESAttribute, GenerateCMSSignedAttributes, and GenerateCMSSignature.

Parameters
digest_buf– The digest to sign.
digest_algorithm_type– The digest algorithm used to generate the digest.
pkcs12_buf– The buffer containing the PKCS #12 key (as usually stored in .pfx files) to use for signing.
pkcs12_password– The password to use to parse the PKCS 12 key.
Returns
the DER-serialized bytes of the signature.

◆ SignDigest() [2/4]

std::vector< UChar > pdftron::Crypto::DigestAlgorithm::SignDigest ( const std::vector< UChar > & digest_buf,
const DigestAlgorithm::Type digest_algorithm_type,
const UString pkcs12_keyfile_path,
const UString pkcs12_password )
static

Sign the digest of arbitrary data with private key in the provided PKCS #12 key file (.pfx). This function is part of the low-level custom signing API, and works with GenerateESSSigningCertPAdESAttribute, GenerateCMSSignedAttributes, and GenerateCMSSignature.

Parameters
digest_buf– The digest to sign.
digest_algorithm_type– The digest algorithm used to generate the digest.
pkcs12_keyfile_path– The path to the PKCS #12 keyfile (usually has a .pfx extension) to use for signing.
pkcs12_password– The password to use to parse the PKCS #12 keyfile.
Returns
the DER-serialized bytes of the signature.

◆ SignDigest() [3/4]

std::vector< UChar > pdftron::Crypto::DigestAlgorithm::SignDigest ( const UChar * digest_buf,
const size_t digest_buf_size,
const DigestAlgorithm::Type digest_algorithm_type,
const UChar * pkcs12_buf,
const size_t pkcs12_buf_size,
const UString pkcs12_password )
static

Sign the digest of arbitrary data with private key in the provided PKCS #12 key file (.pfx). This function is part of the low-level custom signing API, and works with GenerateESSSigningCertPAdESAttribute, GenerateCMSSignedAttributes, and GenerateCMSSignature.

Parameters
digest_buf– The digest to sign.
digest_buf_size– The size of the digest.
digest_algorithm_type– The digest algorithm used to generate the digest.
pkcs12_buf– The buffer containing the PKCS #12 key (as usually stored in .pfx files) to use for signing.
pkcs12_buf_size– The size of the buffer containing the PKCS #12 key.
pkcs12_password– The password to use to parse the PKCS 12 key.
Returns
the DER-serialized bytes of the signature.

◆ SignDigest() [4/4]

std::vector< UChar > pdftron::Crypto::DigestAlgorithm::SignDigest ( const UChar * digest_buf,
const size_t digest_buf_size,
const DigestAlgorithm::Type digest_algorithm_type,
const UString pkcs12_keyfile_path,
const UString pkcs12_password )
static

Sign the digest of arbitrary data with private key in the provided PKCS #12 key file (.pfx). This function is part of the low-level custom signing API, and works with GenerateESSSigningCertPAdESAttribute, GenerateCMSSignedAttributes, and GenerateCMSSignature.

Parameters
digest_buf– The digest to sign.
digest_buf_size– The size of the digest.
digest_algorithm_type– The digest algorithm used to generate the digest.
pkcs12_keyfile_path– The path to the PKCS #12 keyfile (usually has a .pfx extension) to use for signing.
pkcs12_password– The password to use to parse the PKCS #12 keyfile.
Returns
the DER-serialized bytes of the signature.
The documentation for this class was generated from the following file: