2021SC@SUDSC
目录
为了更深一步了解cryptsetup加密的工作原理,找到了cryptsetup LUCK设备使用的相关代码——crypt_luks_usage.c。主要包含以下几个函数:
- crypt_init()
- crypt_format()
- crypt_keyslot_add_by_volume_key()
- crypt_keyslot_add_by_passphrase()
- crypt_load()
- crypt_activate_by_passphrase()
- crypt_get_active_device()
- crypt_init_by_name()
- crypt_deactivate()
下面先一一给出简单介绍
一、函数介绍
1. crypt_init()
每次需要使用 cryptsetup 或 dmcrypt device 执行某些操作时,都需要一个有效的上下文。开始工作的第一步是 crypt_init() 调用。一般使用块设备的路径或常规文件的路径来调用它。如果不提供路径,则初始化空上下文。
2. crypt_format()
相互设备上的标头和有效载荷,由于下面的函数是基于LUKS设备进行的,所以使用格式操作在上下文中设置设备类型,以防LUKS标头写入块设备的开头。下面代码的具体使用是LUKS标头和数据都存储在同一设备上的场景。除此之外,还可以单独存储标题和数据。
但是,有一点需要注意,crypt_format()是破坏性操作,它会覆盖部分支持块设备。
3. crypt_keyslot_add_by_volume_key()
在成功对LUKS设备进行crypt_format() 操作后,密钥不会以持久方式存储在设备上,密钥槽区域是一个超出 LUKS 标头的数组,其中密钥使用用户输入密码以加密形式存储。创建新的密钥槽有两种基本方法,除了这一种外,下面也是一种。
这一种通过加密存储在设备上下文中的 volume_key 直接创建一个新的密钥槽。如果密码短语参数为 NULL,则应提供密码短语或提示用户。
4. crypt_keyslot_add_by_passphrase()
通过打开现有的活动密钥槽,从中提取密钥并将其存储到由新密码保护的新密钥槽中,为密钥创建新的密钥槽。
5. crypt_load()
函数将标头从支持块设备加载到设备上下文中。
6. crypt_activate_by_passphrase()
通过用户为包含 volume_key 的密钥槽提供的密码激活加密设备。如果keyslot参数设置为CRYPT_ANY_SLOT,那么。就会查找密钥槽都试图直到volume key被找到。
7. crypt_get_active_device()
此调用返回包含活动设备的运行时属性的结构。
8. crypt_init_by_name()
如果需要对活动设备(已经具有其相应映射的设备)进行操作并且错过了存储在 *crypt_device 引用中的有效设备上下文,那么,可以使用此调用。函数尝试从 DM 获取后备设备的路径,为其初始化上下文并加载 LUKS 标头。
9. crypt_deactivate()
停用加密设备(删除 DM 映射并从内核安全地擦除卷密钥)。
二、具体代码及分析
为了便于书写,分析直接以注释的方式写到了代码中间。
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <inttypes.h>
#include <sys/types.h>
#include <libcryptsetup.h>
static int format_and_add_keyslots(const char *path)
{
struct crypt_device *cd;
int r;
/*
crypt_init() 调用用于初始化 crypt_device 上下文
path 参数指定设备路径
对于路径,可以使用指向文件或块设备的链接。
如果设备之间存在环路,那么将自动分离。
*/
r = crypt_init(&cd, path);
if (r < 0) {
printf("crypt_init() failed for %s.\n", path);
return r;
}
printf("Context is attached to block device %s.\n", crypt_get_device_name(cd));
/*
到目前为止,还没有数据写入设备。
*/
printf("Device %s will be formatted as a LUKS device after 5 seconds.\n"
"Press CTRL+C now if you want to cancel this operation.\n", path);
sleep(5);
/*
uuid 和 volume_key 为 null,这就意味着它们是在 crypt_format() 调用后生成的。
*/
r = crypt_format(cd, //crypt 上下文
CRYPT_LUKS2,