diff options
Diffstat (limited to 'pjlib-util/include/pjlib-util/hmac_sha1.h')
-rw-r--r-- | pjlib-util/include/pjlib-util/hmac_sha1.h | 46 |
1 files changed, 44 insertions, 2 deletions
diff --git a/pjlib-util/include/pjlib-util/hmac_sha1.h b/pjlib-util/include/pjlib-util/hmac_sha1.h index 6fe4b6ad..70984c53 100644 --- a/pjlib-util/include/pjlib-util/hmac_sha1.h +++ b/pjlib-util/include/pjlib-util/hmac_sha1.h @@ -25,6 +25,7 @@ */ #include <pj/types.h> +#include <pjlib-util/sha1.h> PJ_BEGIN_DECL @@ -34,12 +35,22 @@ PJ_BEGIN_DECL * @{ * * This module contains the implementation of HMAC: Keyed-Hashing - * for Message Authentication, as described in RFC 2104 + * for Message Authentication, as described in RFC 2104. */ +/** + * The HMAC-SHA1 context used in the incremental HMAC calculation. + */ +typedef struct pj_hmac_sha1_context +{ + pj_sha1_context context; /**< SHA1 context */ + pj_uint8_t k_opad[64]; /**< opad xor-ed with key */ +} pj_hmac_sha1_context; + /** - * Calculate HMAC SHA1 digest for the specified input and key. + * Calculate HMAC-SHA1 digest for the specified input and key with this + * single function call. * * @param input Pointer to the input stream. * @param input_len Length of input stream in bytes. @@ -53,6 +64,37 @@ PJ_DECL(void) pj_hmac_sha1(const pj_uint8_t *input, unsigned input_len, /** + * Initiate HMAC-SHA1 context for incremental hashing. + * + * @param hctx HMAC-SHA1 context. + * @param key Pointer to the authentication key. + * @param key_len Length of the authentication key. + */ +PJ_DECL(void) pj_hmac_sha1_init(pj_hmac_sha1_context *hctx, + const pj_uint8_t *key, unsigned key_len); + +/** + * Append string to the message. + * + * @param hctx HMAC-SHA1 context. + * @param input Pointer to the input stream. + * @param input_len Length of input stream in bytes. + */ +PJ_DECL(void) pj_hmac_sha1_update(pj_hmac_sha1_context *hctx, + const pj_uint8_t *input, + unsigned input_len); + +/** + * Finish the message and return the digest. + * + * @param hctx HMAC-SHA1 context. + * @param digest Buffer to be filled with HMAC SHA1 digest. + */ +PJ_DECL(void) pj_hmac_sha1_final(pj_hmac_sha1_context *hctx, + pj_uint8_t digest[20]); + + +/** * @} */ |