tiny-AES-c 项目常见问题解决方案

1. 项目基础介绍和主要的编程语言

项目名称: tiny-AES-c
项目地址: https://github.com/kokke/tiny-AES-c
主要编程语言: C
项目简介: tiny-AES-c 是一个小型且便携的 AES 加密算法实现，支持 AES128、AES192 和 AES256 三种密钥长度。该项目提供了 ECB、CTR 和 CBC 三种加密模式，适用于需要小代码尺寸、低内存占用和高可移植性的场景。

2. 新手在使用这个项目时需要特别注意的3个问题和详细的解决步骤

问题1: 如何选择合适的加密模式？

详细描述: 项目支持 ECB、CTR 和 CBC 三种加密模式，但 ECB 模式被认为是不安全的，通常不推荐使用。新手可能会困惑于选择哪种模式。

解决步骤:

1. 了解每种模式的特点:
   • ECB (Electronic Codebook): 每个块独立加密，安全性较低，不推荐使用。
   • CBC (Cipher Block Chaining): 每个块加密依赖于前一个块，需要初始向量 (IV)，安全性较高。
   • CTR (Counter): 使用计数器模式，不需要填充，适合流式加密。
2. 根据需求选择模式:
   • 如果需要高安全性，选择 CBC 模式。
   • 如果需要流式加密，选择 CTR 模式。
   • 避免使用 ECB 模式。

问题2: 如何处理填充问题？

详细描述: 项目不提供内置的填充机制，因此在使用 CBC 和 ECB 模式时，输入数据必须是 16 字节的倍数。新手可能会遇到填充错误。

解决步骤:

1. 了解填充需求:
   • CBC 和 ECB 模式要求输入数据长度必须是 16 字节的倍数。
   • 如果数据长度不符合要求，需要手动填充。
2. 使用 PKCS7 填充:
   • 计算需要填充的字节数 padding_length。
   • 在数据末尾添加 padding_length 个字节，每个字节的值为 padding_length。
3. 示例代码:

   void add_pkcs7_padding(uint8_t* data, size_t data_length, size_t block_size) {
       size_t padding_length = block_size - (data_length % block_size);
       for (size_t i = 0; i < padding_length; i++) {
           data[data_length + i] = padding_length;
       }
   }
   

问题3: 如何初始化 AES 上下文？

详细描述: 新手可能会对如何正确初始化 AES 上下文感到困惑，特别是如何设置密钥和初始向量 (IV)。

解决步骤:

1. 初始化上下文:
   • 使用 AES_init_ctx 函数初始化上下文，传入密钥。
   • 如果使用 CBC 或 CTR 模式，还需要使用 AES_init_ctx_iv 函数设置初始向量 (IV)。
2. 示例代码:

   #include "aes.h"
   
   void init_aes_context(struct AES_ctx* ctx, const uint8_t* key, const uint8_t* iv) {
       AES_init_ctx_iv(ctx, key, iv);
   }
   

3. 注意事项:
   • 确保密钥和 IV 的长度符合 AES 标准（16、24 或 32 字节）。
   • 如果使用 CTR 模式，IV 的长度应为 16 字节。

通过以上步骤，新手可以更好地理解和使用 tiny-AES-c 项目，避免常见的问题。