ARM mbedtls使开发人员可以非常轻松地在(嵌入式产品中加入加密和 SSL/TLS 功能。它提供了具有直观的 API 和可读源代码的 SSL 库。该工具即开即用,可以在大部分系统上直接构建它,也可以手动选择和配置各项功能。
mbedtls 库提供了一组可单独使用和编译的加密组件,还可以使用单个配置头文件加入或排除这些组件。
从功能角度来看,该mbedtls分为三个主要部分:
下面介绍如何在 Ubuntu/Debian/raspbian环境下正确安装mbedtls。
前往github克隆最新版的mbedtls源代码。获取最新版源代码之前需要在Ubuntu/Debian中正确安装git工具
git clone https://github.com/ARMmbed/mbedtls.git
切换到某个release分支,此处选择mbedtls-2.4。
git checkout -b mbedtls-2.4 origin/mbedtls-2.4
通过git checkout可检出具体分支
通过git branch查看分支,确认已经切换到mbedtls-2.4分支
git branch
development
* mbedtls-2.4
mbedtls支持make、cmake等多种安装方式。下面介绍make方式和cmake方式编译源代码,并在目标主机中安装mbedtls动态链接库和头文件。本文推荐使用cmake工具安装mbedtls。
make方式
make SHARED=1
sudo make install
cmake方式(推荐)
cmake方式比make方式的步骤要多一些,如果目标主机并没有安装cmake工具,可通过apt-get工具安装cmake
1.# 更新软件源
2.sudo apt-get update
3.# 通过软件源安装cmake
4.sudo apt-get install cmake
5.# 生成makefile文件,启用生成动态链接库选项
6.cmake -DUSE_SHARED_MBEDTLS_LIBRARY=On .
7.# 以下步骤和make方式相同
8.make
9.sudo make install
mbedtls也可以通过修改配置文件的方式进行裁剪,mbedtls提供了几个参考模板,具体的config.h文件可参考mbedtls/configs目录,该目录中包括config-ccm-psk-tls1_2.h, config-mini-tls1_1.h等文件。和mbedtls安装方法相似,可通过make方法和cmake方法修改具体配置。
make方法
1.# 设置MBEDTLS_CONFIG_FILE宏,指向config-ccm-psk-tls1_2.h
2.CFLAGS="-I$PWD/configs -DMBEDTLS_CONFIG_FILE='<config-ccm-psk-tls1_2.h>'"
3.# 重新编译
4.make
cmake方法
1.# 删除之前cmake相关中间文件,但是不包括CMakeLists.txt文件
2.find . -iname '*cmake*' -not -name CMakeLists.txt -exec rm -rf {} +
3.# 指定配置文件为 config-ccm-psk-tls1_2.h,重新编译
4.CFLAGS="-I$PWD/configs -DMBEDTLS_CONFIG_FILE='<config-ccm-psk-tls1_2.h>'" cmake .
2.6安装总结
示例代码
下面我们通过一个示例来说明如何使用mbedtls。这个示例通过介绍如何使用HMAC算法生成一个消息认证码。hmac-test.c代码如下:
#include <string.h>
#include <stdio.h>
#include "mbedtls/md.h"
#define mbedtls_printf printf
int main(void)
{
int ret;
unsigned char secret[] = "a secret";
unsigned char buffer[] = "some data to hash";
unsigned char digest[32];
mbedtls_md_context_t sha_ctx;
mbedtls_md_init(&sha_ctx);
memset(digest, 0x00, sizeof(digest));
ret = mbedtls_md_setup(&sha_ctx, mbedtls_md_info_from_type(MBEDTLS_MD_SHA256), 1);
if (ret != 0)
{
mbedtls_printf(" ! mbedtls_md_setup() returned -0x%04x\n", -ret);
goto exit;
}
mbedtls_md_hmac_starts(&sha_ctx, secret, sizeof(secret) - 1);
mbedtls_md_hmac_update(&sha_ctx, buffer, sizeof(buffer) - 1);
mbedtls_md_hmac_finish(&sha_ctx, digest );
mbedtls_printf("HMAC: ");
for (int i = 0; i < sizeof(digest); i++)
mbedtls_printf("%02X", digest[i]);
mbedtls_printf("\n");
exit:
mbedtls_md_free( &sha_ctx );
return ret;
}
cmake
在hmac-test.c同目录中新建一个名为Cmakelists.txt的文件,文件内容如下
cmake_minimum_required(VERSION 2.6)
# 定义工程名称
project("hmac-test")
# 定义依赖动态链接库
set(libs
mbedtls
mbedcrypto
mbedx509
)
set(targets
hmac-test
)
add_executable(hmac-test hmac-test.c)
target_link_libraries(hmac-test ${libs})
# 生成makefile文件
cmake .
# 执行makefile,生成可执行文件hmac-test
make
# 运行可执行文件hmac-test
./hmac-test
# 控制台输出运行结果
HMAC: 7FD04DF92F636FD450BC841C9418E5825C17F33AD9C87C518115A45971F7F77E
如果不确定mbedtls的运算结果,也可以编写一个node.js脚本,使用相同参数的情况下两者的计算结果应该完全相同。
const crypto = require('crypto');
const hmac = crypto.createHmac('sha256', 'a secret');
hmac.update('some data to hash');
console.log(hmac.digest('hex'));
// Prints:
// 7fd04df92f636fd450bc841c9418e5825c17f33ad9c87c518115a45971f7f77e
总结
---------------------
作者:xukai871105
来源:CSDN
原文:https://blog.csdn.net/xukai871105/article/details/72795126
版权声明:本文为博主原创文章,转载请附上博文链接!