HMAC Functions

Collaboration diagram for HMAC Functions:

Modules
	Cryptographic Stream Transformations
	Cryptographic Contants
	Crytographic Digest Algorithms

Functions
string	Qore::DSS1_hmac (data data, data key)
	Returns the DSS1 (SHA-1 and DSA) based HMAC of the supplied argument as a hex string. More...
string	Qore::DSS_hmac (data data, data key)
	Returns the DSS (SHA-0 and DSA) based HMAC of the supplied argument as a hex string. More...
string	Qore::MD2_hmac (data data, data key)
	Returns the MD2 based HMAC of the supplied argument as a hex string. More...
string	Qore::MD4_hmac (data data, data key)
	Returns the MD4 based HMAC of the supplied argument as a hex string. More...
string	Qore::MD5_hmac (data data, data key)
	Returns the MD5 based HMAC of the supplied argument as a hex string. More...
string	Qore::MDC2_hmac (data data, data key)
	Returns the MDC2 based HMAC of the supplied argument as a hex string. More...
string	Qore::RIPEMD160_hmac (data data, data key)
	Returns the RIPEMD based HMAC of the supplied argument as a hex string. More...
string	Qore::SHA1_hmac (data data, data key)
	Returns the SHA1 based HMAC of the supplied argument as a hex string. More...
string	Qore::SHA224_hmac (data data, data key)
	Returns the SHA224 based HMAC of the supplied argument as a hex string. More...
string	Qore::SHA256_hmac (data data, data key)
	Returns the SHA256 based HMAC of the supplied argument as a hex string. More...
string	Qore::SHA384_hmac (data data, data key)
	Returns the SHA384 based HMAC of the supplied argument as a hex string. More...
string	Qore::SHA512_hmac (data data, data key)
	Returns the SHA512 based HMAC of the supplied argument as a hex string. More...
string	Qore::SHA_hmac (data data, data key)
	Returns the SHA based HMAC of the supplied argument as a hex string. More...
binary	Qore::decrypt_to_binary (string alg, data data, data key, data iv=Qore::DefaultIV, *data mac, *data aad)
	Returns a binary value of decrypted data corresponding to the input arguments inluding the given algorithm. More...
string	Qore::decrypt_to_string (string alg, data data, data key, data iv=Qore::DefaultIV, *data mac, *data aad, *string encoding)
	Returns a string of decrypted data corresponding to the input arguments inluding the given algorithm. More...
binary	Qore::digest (string digest, data data)
	Returns the digest of the supplied arguments as a binary value. More...
binary	Qore::encrypt (string alg, data data, data key, data iv=Qore::DefaultIV, *reference< binary > mac, *int mac_size, *data aad)
	Returns a binary value of encrypted data corresponding to the input arguments inluding the given algorithm. More...
*hash< auto >	Qore::get_cipher_info (string cipher)
	Returns information about the given cipher or NOTHING if the cipher is unknown. More...
hash< auto >	Qore::get_crypto_info ()
	Returns a hash of information about each cryptographic algorithmn supported by the current build of Qore. More...
Transform	Qore::get_decryptor (string alg, data key, data iv=Qore::DefaultIV, *data mac, *data aad)
	Returns a Transform object for decrypting data using the given algorithm for use with TransformInputStream and TransformOutputStream. More...
list< string >	Qore::get_digests ()
	Returns a list of supported digest algorithms for hmac() More...
Transform	Qore::get_encryptor (string alg, data key, data iv=Qore::DefaultIV, *reference< binary > mac, *int mac_size, *data aad)
	Returns a Transform object for encrypting data using the given algorithm for use with TransformInputStream and TransformOutputStream. More...
binary	Qore::get_random_bytes (int size)
	returns a binary value of random bytes using openssl More...
bool	Qore::has_digest (string digest)
	Returns True if the given digest is supported, False if not. More...
binary	Qore::hmac (string digest, data data, data key)
	Returns the digest-based HMAC of the supplied arguments as a binary value. More...

Detailed Description

Qore's cryptography support is provided by the OpenSSL library.

In cryptography, a keyed-hash message authentication code (HMAC) is a specific construction for calculating a message authentication code (MAC) involving a cryptographic hash function in combination with a secret cryptographic key. As with any MAC, it may be used to simultaneously verify both the data integrity and the authentication of a message. Any cryptographic hash function, such as MD5 or SHA-1, may be used in the calculation of an HMAC; the resulting MAC algorithm is termed HMAC-MD5 or HMAC-SHA1 accordingly. The cryptographic strength of the HMAC depends upon the cryptographic strength of the underlying hash function, the size of its hash output, and on the size and quality of the key.

For more info: Wikipedia's Hash-based message authentication code article.

See also:

• Cryptographic Functions
• Digest (Hash) Functions
• Cryptographic Contants

Function Documentation

decrypt_to_binary()

binary Qore::decrypt_to_binary	(	string	alg,
		data	data,
		data	key,
		data	iv = Qore::DefaultIV,
		*data	mac,
		*data	aad
	)

Returns a binary value of decrypted data corresponding to the input arguments inluding the given algorithm.

Code Flags:

RET_VALUE_ONLY

Example:

binary bin = decrypt_to_binary(Qore::CRYPTO_ALG_BLOWFISH, data, key);

Parameters

alg	the transformation algorithm; see Cryptographic Stream Transformations for possible values
data	the data to decrypt
key	the encryption key
iv	the initialization vector or cryptographic nonce
mac	a message authentication code to be used to decrypt the message if required by the cryptographic algorithm, if not required, this argument is ignored
aad	Additional Authenticated Data; if the cryptographic algorithm does not support AAD, then this argument is ignored

Returns

a binary value of decrypted data corresponding to the input arguments

Exceptions

DECRYPT-ERROR

unknown decryption algorithm; error with the decryption algorithm (ex: invalid key)

See also

• Qore::decrypt_to_string()
• Qore::encrypt()
• Qore::get_crypto_info()
• Qore::get_decryptor()
• Qore::get_encryptor()

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all ciphers known to the OpenSSL library, otherwise it tried to match the cipher with known ciphers at compile time; use CipherMap for a list of known ciphers

Since

Qore 0.8.13

decrypt_to_string()

string Qore::decrypt_to_string	(	string	alg,
		data	data,
		data	key,
		data	iv = Qore::DefaultIV,
		*data	mac,
		*data	aad,
		*string	encoding
	)

Returns a string of decrypted data corresponding to the input arguments inluding the given algorithm.

Code Flags:

RET_VALUE_ONLY

Example:

string str = decrypt_to_string(Qore::CRYPTO_ALG_BLOWFISH, data, key);

Parameters

alg	the transformation algorithm; see Cryptographic Stream Transformations for possible values
data	the data to decrypt
key	the encryption key
iv	the initialization vector or cryptographic nonce
mac	a message authentication code to be used to decrypt the message if required by the cryptographic algorithm, if not required, this argument is ignored
aad	Additional Authenticated Data; if the cryptographic algorithm does not support AAD, then this argument is ignored
encoding	the character encoding tag for the string return value; if not present, the default character encoding is assumed

Returns

a string of decrypted data corresponding to the input arguments

Exceptions

DECRYPT-ERROR

unknown decryption algorithm; error with the decryption algorithm (ex: invalid key)

See also

• Qore::decrypt_to_binary()
• Qore::encrypt()
• Qore::get_crypto_info()
• Qore::get_decryptor()
• Qore::get_encryptor()

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all ciphers known to the OpenSSL library, otherwise it tried to match the cipher with known ciphers at compile time; use CipherMap for a list of known ciphers

Since

Qore 0.8.13

digest()

binary Qore::digest	(	string	digest,
		data	data
	)

Returns the digest of the supplied arguments as a binary value.

Code Flags:

RET_VALUE_ONLY

Example:

binary bin = digest("md2", "Hello There This is a Test - 1234567890");
# returns <a9046c73e00331af68917d3804f70655>

Parameters

digest	the digest to use; for supported digests, see DigestMap
data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments

Returns

the binary value of the digest

Exceptions

DIGEST-ERROR	unknown digest
DIGEST-CALCULATION-ERROR	error calculating digest (should not normally happen)

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all digests known to the OpenSSL library, otherwise it tried to match the digest with known digests at compile time; use DigestMap for a list of known digests

Since

Qore 0.9.3

DSS1_hmac()

string Qore::DSS1_hmac	(	data	data,
		data	key
	)

Returns the DSS1 (SHA-1 and DSA) based HMAC of the supplied argument as a hex string.

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "37a3cc73159aa129b0eb22bbdf4b9309d389f629")

Example:

string str = DSS1_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "37a3cc73159aa129b0eb22bbdf4b9309d389f629"

Note

this digest algorithm is considered outdated and is included for backwards-compatibility only when Qore is built with an older openssl library

Exceptions

DSS1-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

DSS_hmac()

string Qore::DSS_hmac	(	data	data,
		data	key
	)

Returns the DSS (SHA-0 and DSA) based HMAC of the supplied argument as a hex string.

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "37a3cc73159aa129b0eb22bbdf4b9309d389f629")

Example:

string str = DSS_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "37a3cc73159aa129b0eb22bbdf4b9309d389f629"

Note

this digest algorithm is considered outdated and is included for backwards-compatibility only when Qore is built with an older openssl library

Exceptions

DSS-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

encrypt()

binary Qore::encrypt	(	string	alg,
		data	data,
		data	key,
		data	iv = Qore::DefaultIV,
		*reference< binary >	mac,
		*int	mac_size,
		*data	aad
	)

Returns a binary value of encrypted data corresponding to the input arguments inluding the given algorithm.

Code Flags:

RET_VALUE_ONLY

Example:

binary bin = encrypt(Qore::CRYPTO_ALG_BLOWFISH, data, key);

Parameters

alg	the transformation algorithm; see Cryptographic Stream Transformations for possible values
data	the data to encrypt
key	the encryption key
iv	the initialization vector or cryptographic nonce
mac	a reference to a binary lvalue that will store the Message Authentication Code (MAC) when the transformation is closed, if the algorithm produces one; it is not an error to provide a reference here for cryptographic algorithms that do not generate a MAC, however in such cases, nothing will be written to the reference; in case this argument is passed, the mac_size argument must also be passed or a MAC-ERROR exception will be thrown
mac_size	number of bytes of the MAC to return; this value must be non-negative and less than 4096 or a MAC-ERROR exception will be thrown
aad	Additional Authenticated Data; if the cryptographic algorithm does not support AAD, then this argument is ignored

Returns

a binary value of encrypted data corresponding to the input arguments

Exceptions

MAC-ERROR	this exception is thrown if the mac_size argument is passed but no mac argument or vice-versa or if the mac_size argument is negative or greater than 4096 bytes
ENCRYPT-ERROR	unknown encryption algorithm; error with the encryption algorithm (ex: invalid key size)

See also

• Qore::decrypt_to_binary()
• Qore::decrypt_to_string()
• Qore::get_crypto_info()
• Qore::get_decryptor()
• Qore::get_encryptor()

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all ciphers known to the OpenSSL library, otherwise it tried to match the cipher with known ciphers at compile time; use CipherMap for a list of known ciphers

Since

Qore 0.8.13

get_cipher_info()

*hash<auto> Qore::get_cipher_info

(

string

cipher

)

Returns information about the given cipher or NOTHING if the cipher is unknown.

Code Flags:

RET_VALUE_ONLY

Parameters

cipher

the cipher to look up

Returns

a hash with information about the cipher or NOTHING if the cipher is unknown

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all ciphers known to the OpenSSL library, otherwise it tried to match the cipher with known ciphers at compile time; use CipherMap for a list of known ciphers

Exceptions

ENCODING-CONVERSION-ERROR

this error is thrown if the string cannot be converted to the default character encoding

Since

Qore 1.4.0

get_crypto_info()

hash<auto> Qore::get_crypto_info

(

)

Returns a hash of information about each cryptographic algorithmn supported by the current build of Qore.

Code Flags:

CONSTANT

Example:

hash<auto> h = get_crypto_info();

Returns

a hash of information about each cryptographic algorithmn supported by the current build of Qore; keys are algorithm names, values are hashes with the following keys:

• key_len: the minimum required length of the cryptographic key; if 0 it means that the cipher takes a variable key length
• iv_len: the minimum required lengh of the initialization vector or nonce; if 0 it means that the initialization vector can be of any length (note that initialization vector or nonce is always optional); -1 means that the algorithm does not support (ignores) initialization vectors
• type: either "GCM" for Galois Counter Mode (meaning that the cipher accepts AAD and produces / requires a Message Authentication Code (MAC) for encryption / decryption, respectively) or "CBC" for Cipher Block Chaining (meaning that the cipher does not support AAD or a MAC)

See also

• Qore::decrypt_to_binary()
• Qore::decrypt_to_string()
• Qore::encrypt()
• Qore::get_decryptor()
• Qore::get_encryptor()

Since

Qore 0.8.13

get_decryptor()

Transform Qore::get_decryptor	(	string	alg,
		data	key,
		data	iv = Qore::DefaultIV,
		*data	mac,
		*data	aad
	)

Returns a Transform object for decrypting data using the given algorithm for use with TransformInputStream and TransformOutputStream.

Code Flags:

RET_VALUE_ONLY

Example:

Qore::FileOutputStream of("my-file.txt.enc");
Qore::TransformOutputStream ts(of, get_decryptor(Qore::CRYPTO_ALG_BLOWFISH, key));

Parameters

alg	the transformation algorithm; see Cryptographic Stream Transformations for possible values
key	the encryption key
iv	the initialization vector
mac	a message authentication code to be used to decrypt the message if required by the cryptographic algorithm, if not required, this argument is ignored
aad	Additional Authenticated Data; if the cryptographic algorithm does not support AAD, then this argument is ignored

Returns

a Transform object for decrypting data using the given algorithm for use with TransformInputStream and TransformOutputStream

Exceptions

DECRYPT-ERROR

unknown encryption algorithm; error decrypting the data

See also

• Qore::decrypt_to_binary()
• Qore::decrypt_to_string()
• Qore::encrypt()
• Qore::get_crypto_info()
• Qore::get_encryptor()

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all ciphers known to the OpenSSL library, otherwise it tried to match the cipher with known ciphers at compile time; use CipherMap for a list of known ciphers

Since

Qore 0.8.13

get_digests()

list<string> Qore::get_digests

(

)

Returns a list of supported digest algorithms for hmac()

Code Flags:

CONSTANT

Example:

# make a map of supported digests
hash<string, bool> digest_map = map {$1: True}, get_digests();

Returns

a list of supported digest algorithms for hmac()

See also

hmac()

Note

This function returns the same value as the keys of DigestMap

Since

Qore 0.9.3

get_encryptor()

Transform Qore::get_encryptor	(	string	alg,
		data	key,
		data	iv = Qore::DefaultIV,
		*reference< binary >	mac,
		*int	mac_size,
		*data	aad
	)

Returns a Transform object for encrypting data using the given algorithm for use with TransformInputStream and TransformOutputStream.

Code Flags:

RET_VALUE_ONLY

Example:

Qore::FileOutputStream of("my-file.txt.enc");
Qore::TransformOutputStream ts(of, get_encryptor(Qore::CRYPTO_ALG_BLOWFISH, key));

Parameters

alg	the transformation algorithm; see Cryptographic Stream Transformations for possible values
key	the encryption key
iv	the initialization vector
mac	a reference to a binary lvalue that will store the Message Authentication Code (MAC) when the transformation is closed, if the algorithm produces one; it is not an error to provide a reference here for cryptographic algorithms that do not generate a MAC, however in such cases, nothing will be written to the reference; in case this argument is passed, the mac_size argument must also be passed or a MAC-ERROR exception will be thrown
mac_size	number of bytes of the MAC to return; this value must be non-negative and less than 4096 or a MAC-ERROR exception will be thrown
aad	Additional Authenticated Data; if the cryptographic algorithm does not support AAD, then this argument is ignored

Returns

a Transform object for encrypting data using the given algorithm for use with TransformInputStream and TransformOutputStream

Exceptions

MAC-ERROR	this exception is thrown if the mac_size argument is passed but no mac argument or vice-versa or if the mac_size argument is negative or greater than 4096 bytes
ENCRYPT-ERROR	unknown encryption algorithm; error with the encryption algorithm (ex: invalid key size)

See also

• Qore::decrypt_to_binary()
• Qore::decrypt_to_string()
• Qore::encrypt()
• Qore::get_crypto_info()
• Qore::get_decryptor()

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all ciphers known to the OpenSSL library, otherwise it tried to match the cipher with known ciphers at compile time; use CipherMap for a list of known ciphers

Since

Qore 0.8.13

get_random_bytes()

binary Qore::get_random_bytes

(

int

size

)

returns a binary value of random bytes using openssl

Code Flags:

RET_VALUE_ONLY

Example:

# return 16 bytes of random data
binary b = get_random_bytes(16);

Parameters

size	the number of bytes in the output; if this value is not positive, an empty binary value is returned

Returns

a binary value of random bytes using openssl

Exceptions

GET-RANDOM-BYTES-ERROR

thrown if there is an error generating or acquiring random data (ex: not enough entropy; random function not supported by the current random method)

Since

Qore 0.8.13

has_digest()

bool Qore::has_digest

(

string

digest

)

Returns True if the given digest is supported, False if not.

Code Flags:

RET_VALUE_ONLY

Parameters

digest

the digest to check

Returns

True if the given digest is supported, False if not

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all digests known to the OpenSSL library, otherwise it tried to match the digest with known digests at compile time; use DigestMap for a list of known digests

Exceptions

ENCODING-CONVERSION-ERROR

this error is thrown if the string cannot be converted to the default character encoding

Since

Qore 1.4.0

hmac()

binary Qore::hmac	(	string	digest,
		data	data,
		data	key
	)

Returns the digest-based HMAC of the supplied arguments as a binary value.

Code Flags:

RET_VALUE_ONLY

Example:

binary bin = hmac("ripemd160", "Hello There This is a Test - 1234567890", "a key");
# returns <4bca70bca1601aba57624eeb2606535cb12f2079>

Parameters

digest	the digest to use; for supported digests, see DigestMap
data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

the binary value of the HMAC

Exceptions

DIGEST-ERROR	unknown digest
HMAC-CALCULATION-ERROR	error calculating digest (should not normally happen)

See also

DigestMap

Note

If Qore is compiled with OpenSSL 3+, it will use dynamic lookups of all digests known to the OpenSSL library, otherwise it tried to match the digest with known digests at compile time; use DigestMap for a list of known digests

Since

Qore 0.9.3

MD2_hmac()

string Qore::MD2_hmac	(	data	data,
		data	key
	)

Returns the MD2 based HMAC of the supplied argument as a hex string.

Platform Availability:

Qore::Option::HAVE_MD2

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "27f5f17500b408e97643403ea8ef1413")

Example:

string str = MD2_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "27f5f17500b408e97643403ea8ef1413"

Exceptions

MD2-HMAC-ERROR

error calculating digest (should not normally happen)

See also

• hmac()
• MD2_bin()

MD4_hmac()

string Qore::MD4_hmac	(	data	data,
		data	key
	)

Returns the MD4 based HMAC of the supplied argument as a hex string.

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "053d084f321a3886e60166ebd9609ce1")

Example:

string str = MD4_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "053d084f321a3886e60166ebd9609ce1"

Exceptions

MD4-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

MD5_hmac()

string Qore::MD5_hmac	(	data	data,
		data	key
	)

Returns the MD5 based HMAC of the supplied argument as a hex string.

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "87505c6164aaf6ca6315233902a01ef4")

Example:

string str = MD5_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "87505c6164aaf6ca6315233902a01ef4"

Note

the MD5 algorithm is not collision-resistant; it's recommended to use another hash algorithm (like SHA-256) if cryptographic security is important

Exceptions

MD5-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

MDC2_hmac()

string Qore::MDC2_hmac	(	data	data,
		data	key
	)

Returns the MDC2 based HMAC of the supplied argument as a hex string.

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "e0ef6a6803e58807c5db395e180a999c")

Example:

string str = MDC2_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "e0ef6a6803e58807c5db395e180a999c"

Exceptions

MDC2-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

RIPEMD160_hmac()

string Qore::RIPEMD160_hmac	(	data	data,
		data	key
	)

Returns the RIPEMD based HMAC of the supplied argument as a hex string.

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "4bca70bca1601aba57624eeb2606535cb12f2079")

Example:

string str = RIPEMD160_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "4bca70bca1601aba57624eeb2606535cb12f2079"

Exceptions

RIPEMD160-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

SHA1_hmac()

string Qore::SHA1_hmac	(	data	data,
		data	key
	)

Returns the SHA1 based HMAC of the supplied argument as a hex string.

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "37a3cc73159aa129b0eb22bbdf4b9309d389f629")

Example:

string str = SHA1_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "37a3cc73159aa129b0eb22bbdf4b9309d389f629"

Note

Cryptographic weaknesses were discovered in SHA-1, and the standard was no longer approved for most cryptographic uses after 2010.

Exceptions

SHA1-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

SHA224_hmac()

string Qore::SHA224_hmac	(	data	data,
		data	key
	)

Returns the SHA224 based HMAC of the supplied argument as a hex string.

Platform Availability:

Qore::Option::HAVE_SHA224

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "fad5667fa5aa412044555b7e077fced62372fe9c6ce20815609da12c")

Example:

string str = SHA224_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "fad5667fa5aa412044555b7e077fced62372fe9c6ce20815609da12c"

Exceptions

SHA224-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

SHA256_hmac()

string Qore::SHA256_hmac	(	data	data,
		data	key
	)

Returns the SHA256 based HMAC of the supplied argument as a hex string.

Platform Availability:

Qore::Option::HAVE_SHA256

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "1c90c21e227712b62019ff831f34cba22c2e70f1a902651ef69a70705ee0f754")

Example:

string str = SHA256_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "1c90c21e227712b62019ff831f34cba22c2e70f1a902651ef69a70705ee0f754"

Exceptions

SHA256-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

SHA384_hmac()

string Qore::SHA384_hmac	(	data	data,
		data	key
	)

Returns the SHA384 based HMAC of the supplied argument as a hex string.

Platform Availability:

Qore::Option::HAVE_SHA384

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "e2c253c6dcb050990b4da3cee95cd7b227f43388fa8116f476f59395af295d0d3bb7156ab2fcd0663b0500249a7a0865")

Example:

string str = SHA384_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "e2c253c6dcb050990b4da3cee95cd7b227f43388fa8116f476f59395af295d0d3bb7156ab2fcd0663b0500249a7a0865"

Exceptions

SHA384-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

SHA512_hmac()

string Qore::SHA512_hmac	(	data	data,
		data	key
	)

Returns the SHA512 based HMAC of the supplied argument as a hex string.

Platform Availability:

Qore::Option::HAVE_SHA512

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "8dcefd7ea3f90ff1c822b5e9547fc36edf78c3e4ce13d47510a212a406bdda1a4094e7ea5ade90e1c736e204d331a814520eba49f3d074e2c261208de07264f6")

Example:

string str = SHA512_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "8dcefd7ea3f90ff1c822b5e9547fc36edf78c3e4ce13d47510a212a406bdda1a4094e7ea5ade90e1c736e204d331a814520eba49f3d074e2c261208de07264f6"

Exceptions

SHA512-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()

SHA_hmac()

string Qore::SHA_hmac	(	data	data,
		data	key
	)

Returns the SHA based HMAC of the supplied argument as a hex string.

Parameters

data	the data to process and produce a digest for; the trailing null character is not included in the digest when processing string arguments
key	a secret passphrase/key

Returns

a hex string of the digest (ex: "0ad47c8d36dc4606d52f7e4cbd144ef2fda492a0")

Example:

string str = SHA_hmac("Hello There This is a Test - 1234567890", "a key");
# returns "0ad47c8d36dc4606d52f7e4cbd144ef2fda492a0"

Note

SHA/SHA0 was withdrawn shortly after publication due to an undisclosed "significant flaw" and replaced by the slightly revised version SHA-1.

Exceptions

SHA-HMAC-ERROR

error calculating digest (should not normally happen)

See also

hmac()