123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113 |
- /*
- * Copyright (C) 2017-2020 Alibaba Group Holding Limited
- */
- /******************************************************************************
- * @file seccrypt_mac.h
- * @brief Header File for MAC
- * @version V1.0
- * @date 20. Jul 2020
- * @model mac
- ******************************************************************************/
- #ifndef _SC_MAC_H_
- #define _SC_MAC_H_
- #include "sec_include_config.h"
- #include <stdint.h>
- #include "sec_crypto_errcode.h"
- #include "sec_crypto_sha.h"
- #define SC_MAC_KEY_LEN_MAX (64)
- #define HMAC_SHA1_BLOCK_SIZE (64)
- #define HMAC_SHA224_BLOCK_SIZE (64)
- #define HMAC_SM3_BLOCK_SIZE (64)
- #define HMAC_SHA256_BLOCK_SIZE (64)
- #define HMAC_MD5_BLOCK_SIZE (64)
- #define HMAC_SHA384_BLOCK_SIZE (128)
- #define HMAC_SHA512_BLOCK_SIZE (128)
- #define HMAC_MAX_BLOCK_SIZE (128)
- #ifdef __cplusplus
- extern "C" {
- #endif
- typedef struct sc_mac {
- sc_sha_t sha;
- uint8_t key[HMAC_MAX_BLOCK_SIZE];
- sc_sha_mode_t mode;
- } sc_mac_t;
- #define MAC_CONTEXT_SIZE sizeof(sc_sha_context_t)
- typedef struct {
- uint8_t ctx[MAC_CONTEXT_SIZE];
- } sc_mac_context_t;
- /**
- \brief Initialize MAC Interface. Initializes the resources needed for the MAC interface
- \param[in] mac operate handle.
- \param[in] idx index of mac
- \return error code \ref uint32_t
- */
- uint32_t sc_mac_init(sc_mac_t *mac, uint32_t idx);
- /**
- \brief De-initialize MAC Interface. stops operation and releases the software resources used by the interface
- \param[in] mac mac handle to operate.
- \return none
- */
- void sc_mac_uninit(sc_mac_t *mac);
- /**
- \brief MAC set key function.
- \param[in] mac mac handle to operate.
- \param[in] key Pointer to the mac key.
- \param[in] key_len Length of key.
- \return error code
- */
- uint32_t sc_mac_set_key(sc_mac_t *mac, uint8_t *key, uint32_t key_len);
- /**
- \brief MAC operation function.
- \param[in] mac mac handle to operate.
- \param[in] mode sc_sha_mode_t.
- \param[in] msg Pointer to the mac input message.
- \param[in] msg_len Length of msg.
- \param[out] out mac buffer, malloc by caller.
- \param[out] out_len out mac length, should 32 bytes if HMAC_SHA256 mode.
- \return error code
- */
- uint32_t sc_mac_calc(sc_mac_t *mac, sc_sha_mode_t mode, uint8_t *msg,
- uint32_t msg_len, uint8_t *out, uint32_t *out_len);
- /**
- \brief MAC start operation function.
- \param[in] mac mac handle to operate.
- \param[in] context mac context pointer.
- \param[in] mode sc_sha_mode_t.
- \return error code
- */
- uint32_t sc_mac_start(sc_mac_t *mac, sc_mac_context_t *context, sc_sha_mode_t mode);
- /**
- \brief MAC start operation function.
- \param[in] mac mac handle to operate.
- \param[in] context mac context pointer.
- \param[in] msg Pointer to the mac input message.
- \param[in] msg_len Length of msg.
- \return error code
- */
- uint32_t sc_mac_update(sc_mac_t *mac, sc_mac_context_t *context, uint8_t *msg, uint32_t msg_len);
- /**
- \brief MAC start operation function.
- \param[in] mac mac handle to operate.
- \param[in] context mac context.
- \param[out] out mac buffer, malloc by caller.
- \param[out] out_len out mac length,
- \return error code
- */
- uint32_t sc_mac_finish(sc_mac_t *mac, sc_mac_context_t *context, uint8_t *out, uint32_t *out_len);
- #ifdef __cplusplus
- }
- #endif
- #endif /* _SC_MAC_H_ */
|