在 Ubuntu 22.04 系统上构建 mbed TLS 库及开发示例
环境准备与源码获取
在 Ubuntu 22.04 LTS 环境中部署 mbed TLS 安全库，建议直接从官方仓库拉取最新代码以确保兼容性。首先配置 Git 环境变量，随后克隆主项目并初始化子模块依赖。
cd ~/workspace
git clone https://github.com/Mbed-TLS/mbedtls.git
cd mbedtls
# 初始化子模块，若出现错误请重复执行直至成功
git submodule update --init
# 针对新版架构的 PSA 加密子系统同样需要初始化
cd tf-psa-crypto
git submodule update --init配置与编译流程
mbed TLS 支持动态或静态链接方式。以下演示构建共享对象（Shared Object）的过程。创建独立的构建目录以保持源码整洁，利用 CMake 进行跨平台构建配置。
# 创建并进入构建目录
mkdir build && cd build
# 配置 CMake，启用动态库选项
cmake -DUSE_SHARED_MBEDTLS_LIBRARY=On ..
# 开始编译，注意检查 Python 依赖项是否缺失
make
# 将生成的库文件安装至系统目录
sudo make install
# 更新动态链接缓存，防止运行时找不到库文件
sudo ldconfig功能验证程序
为了验证安装是否成功，可以编写一个简单的测试程序。该示例演示了如何使用 mbed TLS 提供的 Base64 编解码接口以及大数（MPI）初始化的基本操作。相比原始 API 调用，增加了返回值校验以增强健壮性。
源代码实现
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <mbedtls/base64.h>
#include <mbedtls/platform.h>
#include <mbedtls/bignum.h>
#define BUFFER_SIZE 256
int run_test(void) {
int result = 0;
// 定义待处理的数据
const char *source_data = "Test Data Payload for Encryption";
size_t src_len = strlen(source_data);
// 分配输出缓冲区
unsigned char encoded_buf[BUFFER_SIZE];
size_t encoded_len = 0;
unsigned char decoded_buf[BUFFER_SIZE];
size_t decoded_len = 0;
printf("Original String: %s\n", source_data);
// 执行 Base64 编码
result = mbedtls_base64_encode(encoded_buf, BUFFER_SIZE, &encoded_len,
(const unsigned char *)source_data, src_len);
if (result != 0) {
fprintf(stderr, "Base64 Encode failed: %d\n", result);
return 1;
}
printf("Encoded Result: %.*s\n", (int)encoded_len, encoded_buf);
// 执行 Base64 解码
result = mbedtls_base64_decode(decoded_buf, BUFFER_SIZE, &decoded_len,
encoded_buf, encoded_len);
if (result != 0) {
fprintf(stderr, "Base64 Decode failed: %d\n", result);
return 1;
}
decoded_buf[decoded_len] = '\0'; // 确保字符串终止
printf("Decoded Match: %s\n", decoded_buf);
// 测试大数结构体初始化
mbedtls_mpi mpi_val;
mbedtls_mpi_init(&mpi_val);
mbedtls_mpi_free(&mpi_val);
return 0;
}
int main(int argc, char *argv[]) {
printf("--- mbed TLS Integration Test ---\n");
int status = run_test();
if (status == 0) {
printf("All checks passed.\n");
} else {
printf("Check failed with error code: %d\n", status);
}
return status;
}编译与执行指令
编译时需链接核心的密码学库（mbedcrypto）以及最新的 TF-PSA-Crypto 组件库，具体名称取决于版本号。
# 编译生成可执行文件
gcc -Wall test_demo.c -o tls_runner -lmbedcrypto -ltfpsacrypto
# 运行程序验证输出
./tls_runner