Changeset 1265 for pjproject/trunk/pjlib-util/include/pjlib-util/hmac_sha1.h

Timestamp:

May 11, 2007 10:37:14 AM (17 years ago)

Author:

bennylp

Message:

Fixed missing padding when calculating MESSAGE-INTEGRITY in STUN

File:

• pjproject/trunk/pjlib-util/include/pjlib-util/hmac_sha1.h (modified) (3 diffs)

pjproject/trunk/pjlib-util/include/pjlib-util/hmac_sha1.h

@@ -26 +26 @@
 
 #include <pj/types.h>
+#include <pjlib-util/sha1.h>
 
 PJ_BEGIN_DECL
@@ -35 +36 @@
  *
  * 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.
@@ -54 +65 @@
 
 /**
+ * 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]);
+
+
+/**
  * @}
  */