Hmac

Object Hierarchy:

Description:

[ Compact ]
[ Version ( since = "2.30" ) ]
[ CCode ( ref_function = "g_hmac_ref" , unref_function = "g_hmac_unref" ) ]
public class Hmac

HMACs should be used when producing a cookie or hash based on data and a key.

Simple mechanisms for using SHA1 and other algorithms to digest a key and data together are vulnerable to various security issues. HMAC uses algorithms like SHA1 in a secure way to produce a digest of a key and data.

Both the key and data are arbitrary byte arrays of bytes or characters.

Support for HMAC Digests has been added in GLib 2.30, and support for SHA-512 in GLib 2.42. Support for SHA-384 was added in GLib 2.52.

To create a new `GHmac`, use [ctor@GLib.Hmac.new]. To free a `GHmac`, use [method@GLib.Hmac.unref].

Namespace: GLib

Package: glib-2.0

Content:

Static methods:

public static string compute_for_data (ChecksumType checksum_type, uint8[] key, uint8[] data)
Computes the HMAC for a binary data of data.length .
public static string compute_for_string (ChecksumType checksum_type, uint8[] key, string str, size_t length = -1)
Computes the HMAC for a string.
public static string compute_hmac_for_bytes (ChecksumType checksum_type, Bytes key, Bytes data)
Computes the HMAC for a binary data.

Creation methods:

public Hmac (ChecksumType digest_type, uint8[] key)
Creates a new Hmac, using the digest algorithm digest_type.

Methods:

public Hmac copy ()
Copies a Hmac.
public void get_digest (uint8[] buffer, ref size_t digest_len)
Gets the digest from checksum as a raw binary array and places it into buffer.
public unowned string get_string ()
Gets the HMAC as a hexadecimal string.
public void update (uint8[] data)
Feeds data into an existing Hmac.