密码库LibTomCrypt学习记录——(1.3)分组密码算法——AES算法的函数和使用流程介绍

LibTomCtypt中AES的描述子有两个,rijndael_desc和aes_desc,这二者除了name有区别外别的都一样,因此aes和rijndael是等效的。

注意:VC编译AES的时候记得将aes_table.c设置为“exclude file from build”,别的带_table的c文件类似。“exclude file from build”的设置方式为:右键点击aes_table.c,选择Settings → General → exclude file from build。

AES的测试例见aes.c的int ECB_TEST(void),记得在使用前需要先注册aes的描述子。

tomcrypt_cipher.h中对AES的描述为

//aes和rijndael是一个意思

#define aes_setup           rijndael_setup

#define aes_ecb_encrypt     rijndael_ecb_encrypt

#define aes_ecb_decrypt     rijndael_ecb_decrypt

#define aes_test            rijndael_test

#define aes_done            rijndael_done

#define aes_keysize         rijndael_keysize

 

#define aes_enc_setup           rijndael_enc_setup

#define aes_enc_ecb_encrypt     rijndael_enc_ecb_encrypt

#define aes_enc_keysize         rijndael_enc_keysize

 

// aes和rijndael的相关函数有以下这些

int rijndael_setup(const unsigned char *key, int keylen, int num_rounds, symmetric_key *skey);

int rijndael_ecb_encrypt(const unsigned char *pt, unsigned char *ct, symmetric_key *skey);

int rijndael_ecb_decrypt(const unsigned char *ct, unsigned char *pt, symmetric_key *skey);

int rijndael_test(void);

void rijndael_done(symmetric_key *skey);

int rijndael_keysize(int *keysize);

 

//带enc的这些函数是用于只需要加密而不需要解密的时候

int rijndael_enc_setup(const unsigned char *key, int keylen, int num_rounds, symmetric_key *skey);

int rijndael_enc_ecb_encrypt(const unsigned char *pt, unsigned char *ct, symmetric_key *skey);

void rijndael_enc_done(symmetric_key *skey);

int rijndael_enc_keysize(int *keysize);

 

// aes和rijndael的相关描述子以及仅用于加密的描述子

extern const struct ltc_cipher_descriptor rijndael_desc, aes_desc;

extern const struct ltc_cipher_descriptor rijndael_enc_desc, aes_enc_desc;

 

在aes.c里面对相关函数做了详细描述,以不使用单加密模式(即既需要加密又需要解密)为例

 

#define SETUP    rijndael_setup

#define ECB_ENC  rijndael_ecb_encrypt

#define ECB_DEC  rijndael_ecb_decrypt

#define ECB_DONE rijndael_done

#define ECB_TEST rijndael_test

#define ECB_KS   rijndael_keysize

 

rijndael_desc描述子的详情如下

const struct ltc_cipher_descriptor rijndael_desc =

{

    "rijndael",

     6,

     16, 32, 16, 10,

     SETUP, ECB_ENC, ECB_DEC, ECB_TEST, ECB_DONE, ECB_KS,

     NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL

};

 

aes_desc描述子的详情如下

const struct ltc_cipher_descriptor aes_desc =

{

    "aes",

     6,

     16, 32, 16, 10,

     SETUP, ECB_ENC, ECB_DEC, ECB_TEST, ECB_DONE, ECB_KS,

     NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL

};

 

aes涉及的函数如下:

──────────────────────────────────────

int SETUP(const unsigned char *key, int keylen, int num_rounds, symmetric_key *skey)

// [功能]   初始化,主要做密钥扩展

  1. key              // [输入] 密钥
  2. keylen     // [输入] 密钥长度
  3. num_rounds  // [输入] 轮数(建议设置为0以便让系统使用默认值)
  4. skey             // [输出] 扩展密钥

──────────────────────────────────────

 

──────────────────────────────────────

int ECB_ENC(const unsigned char *pt, unsigned char *ct, symmetric_key *skey)

// [功能]   加密 (明文密文长度为一个分组大小)

  1. pt            // [输入] 明文(一个分组大小)
  2. ct            // [输出] 密文(一个分组大小)
  3. skey             // [输入] 扩展密钥

──────────────────────────────────────

 

──────────────────────────────────────

int ECB_DEC(const unsigned char *ct, unsigned char *pt, symmetric_key *skey)

// [功能]   解密 (明文密文长度为一个分组大小)

  1. ct            // [输入] 密文(一个分组大小)
  2. pt           // [输出] 明文(一个分组大小)
  3. skey             // [输入] 扩展密钥

──────────────────────────────────────

 

──────────────────────────────────────

int ECB_TEST(void)

// [功能]   测试函数

──────────────────────────────────────

 

──────────────────────────────────────

void ECB_DONE(symmetric_key *skey)

// [功能]   反初始化

  1. skey             // [输入] 扩展密钥

//备注:建议将skey信息销毁

──────────────────────────────────────

 

──────────────────────────────────────

int ECB_KS(int *keysize)

// [功能]   根据输入的密钥大小,返回推荐的密钥大小

  1. keysize         // [输入/输出] 密钥大小

──────────────────────────────────────

猜你喜欢

转载自blog.csdn.net/samsho2/article/details/84820170