AES 开源项目使用教程

AES 开源项目使用教程

AES Advanced Encryption Standard，AES加解密算法C语言实现。 项目地址: https://gitcode.com/gh_mirrors/aes6/AES

1. 项目目录结构及介绍

AES/
├── README.md
├── LICENSE
├── src/
│   ├── aes.c
│   ├── aes.h
│   ├── main.c
│   └── utils.c
├── include/
│   └── aes.h
├── tests/
│   ├── test_aes.c
│   └── test_utils.c
├── docs/
│   └── usage.md
├── Makefile
└── config.ini

目录结构说明

• README.md: 项目介绍文件，包含项目的基本信息、使用说明和贡献指南。
• LICENSE: 项目许可证文件，说明项目的开源许可类型。
• src/: 源代码目录，包含项目的核心代码文件。
  • aes.c: AES 加密算法的实现文件。
  • aes.h: AES 加密算法的头文件。
  • main.c: 项目的主程序文件，包含程序的入口函数。
  • utils.c: 工具函数文件，包含一些辅助函数。
• include/: 头文件目录，包含项目中使用的头文件。
  • aes.h: AES 加密算法的头文件。
• tests/: 测试代码目录，包含项目的单元测试文件。
  • test_aes.c: AES 加密算法的测试文件。
  • test_utils.c: 工具函数的测试文件。
• docs/: 文档目录，包含项目的使用文档。
  • usage.md: 使用说明文档。
• Makefile: 项目的构建文件，用于编译和测试项目。
• config.ini: 项目的配置文件，包含项目的配置选项。

2. 项目启动文件介绍

main.c

main.c 是项目的启动文件，包含程序的入口函数 main()。该文件负责初始化配置、调用 AES 加密算法以及处理用户输入。

#include "aes.h"
#include "utils.h"

int main(int argc, char *argv[]) {
    // 初始化配置
    init_config();

    // 读取用户输入
    char *input = read_input();

    // 调用 AES 加密算法
    char *encrypted = aes_encrypt(input);

    // 输出加密结果
    printf("Encrypted: %s\n", encrypted);

    // 释放内存
    free(input);
    free(encrypted);

    return 0;
}

主要功能

• 初始化配置: 调用 init_config() 函数，从 config.ini 文件中读取配置选项。
• 读取用户输入: 调用 read_input() 函数，从标准输入或文件中读取待加密的数据。
• 调用 AES 加密算法: 调用 aes_encrypt() 函数，对输入数据进行加密。
• 输出加密结果: 将加密后的数据输出到标准输出。

3. 项目配置文件介绍

config.ini

config.ini 是项目的配置文件，包含项目的配置选项。该文件使用简单的键值对格式，每个配置项占一行。

[AES]
key_size = 128
mode = ECB
padding = PKCS7

配置项说明

• key_size: 指定 AES 加密算法的密钥长度，支持 128、192 和 256 位。
• mode: 指定 AES 加密算法的模式，支持 ECB、CBC、CFB、OFB 和 CTR 模式。
• padding: 指定填充方式，支持 PKCS7、ISO10126、ANSI X9.23 和 Zeros 填充方式。

配置文件的使用

在 main.c 中，通过 init_config() 函数读取 config.ini 文件中的配置项，并将其应用到 AES 加密算法中。

void init_config() {
    // 读取配置文件
    FILE *fp = fopen("config.ini", "r");
    if (fp == NULL) {
        printf("Error: Cannot open config file.\n");
        exit(1);
    }

    // 解析配置项
    char line[256];
    while (fgets(line, sizeof(line), fp)) {
        if (strstr(line, "key_size")) {
            sscanf(line, "key_size = %d", &key_size);
        } else if (strstr(line, "mode")) {
            sscanf(line, "mode = %s", mode);
        } else if (strstr(line, "padding")) {
            sscanf(line, "padding = %s", padding);
        }
    }

    // 关闭文件
    fclose(fp);
}

通过这种方式，用户可以在不修改代码的情况下，通过配置文件调整 AES 加密算法的参数。

AES Advanced Encryption Standard，AES加解密算法C语言实现。 项目地址: https://gitcode.com/gh_mirrors/aes6/AES