nsICryptoHMAC
This interface provides HMAC signature algorithms.
Initialize the hashing object. This method may be
called multiple times with different algorithm types.
WARNING: This approach is not FIPS compliant.
@throws NS_ERROR_INVALID_ARG if an unsupported algorithm
type is passed.
NOTE: This method must be called before any other method
on this interface is called.
| aAlgorithm | the algorithm type to be used. This value must be one of the above valid algorithm types. |
| aKeyObject | Object holding a key. To create the key object use for instance: var keyObject = Components.classes["@mozilla.org/security/keyobjectfactory;1"] .getService(Components.interfaces.nsIKeyObjectFactory) .keyFromString(Components.interfaces.nsIKeyObject.HMAC, rawKeyData); |
@throws NS_ERROR_NOT_INITIALIZED if |init| has not been
called.
| aData | a buffer to calculate the hash over |
| aLen | the length of the buffer |aData| |
Calculates and updates a new hash based on a given data stream.
@throws NS_ERROR_NOT_INITIALIZED if |init| has not been
called.
@throws NS_ERROR_NOT_AVAILABLE if the requested amount of
data to be calculated into the hash is not available.
| aStream | an input stream to read from. |
| aLen | how much to read from the given |aStream|. Passing UINT32_MAX indicates that all data available will be used to update the hash. |
Completes this HMAC object and produces the actual HMAC diegest data.
@throws NS_ERROR_NOT_INITIALIZED if |init| has not been
called.
NOTE: This method may be called any time after |init|
is called. This call resets the object to its
pre-init state.
| aASCII | if true then the returned value is a base-64 encoded string. if false, then the returned value is binary data. |
| a hash of the data that was read by this object. This can be either binary data or base 64 encoded. |
Reinitialize HMAC context to be reused with the same
settings (the key and hash algorithm) but on different
set of data.
Hashing Algorithms. These values are to be used by the
|init| method to indicate which hashing function to
use. These values map onto the values defined in
mozilla/security/nss/lib/softoken/pkcs11t.h and are
switched to CKM_*_HMAC constant.