HMac

Description

Creates Hash-based Message Authentication Code for the given string based on the algorithm and encoding. Hash-based Message Authentication Code (HMAC) is used to verify the data integrity and authenticity of a message transmitted. It involves a cryptographic hash function in combination with a secret key. The cryptographic hash function can be Message Digest 5 (MD5), Secure Hash Algorithm (SHA), and so on.

Returns

a Boolean value. true if successful.

Category

Display and formatting functions

Syntax

HMac(message, key [,algorithm] [,encoding])

See also

SessionInvalidate, SessionRotate

History

ColdFusion 10: Added this function.

Parameters

Parameter

Required\Optional

Description

message

Required

The message to transmit. The message can be a String or a byte array.

key

Required

The secret key to create HMAC. The key can be a String or a byte array.

algorithm

Optional

Algorithm used.

encoding

Optional

Encoding to be used.

Usage

Use this function to create Hash-based Message Authentication Code for the given string based on the algorithm and encoding.

Example

<h2>HMAC Test</h2> 
<cfset x=hmac("Hi There","key1","HMACRIPEMD160")> 
<cfoutput>#x#</cfoutput>