Skip to content

Commit ef3d720

Browse files
Shuo ZhaoJonathan Corbet
authored andcommitted
docs/zh_CN: Add security IMA-templates Chinese translation
Translate .../security/IMA-templates.rst into Chinese. Update the translation through commit 398c42e ("ima: support fs-verity file digest based version 3 signatures"). Reviewed-by: Yanteng Si <[email protected]> Signed-off-by: Shuo Zhao <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]> Link: https://lore.kernel.org/r/[email protected]
1 parent d996d56 commit ef3d720

File tree

1 file changed

+97
-0
lines changed

1 file changed

+97
-0
lines changed
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
.. SPDX-License-Identifier: GPL-2.0
2+
.. include:: ../disclaimer-zh_CN.rst
3+
4+
:Original: Documentation/security/IMA-templates.rst
5+
6+
:翻译:
7+
赵硕 Shuo Zhao <[email protected]>
8+
9+
===============
10+
IMA模板管理机制
11+
===============
12+
13+
14+
介绍
15+
====
16+
17+
原始的 ``ima`` 模板是固定长度的,包含文件数据的哈希值和路径名。文件数据
18+
哈希值限制为20字节(md5/sha1)。路径名是一个以空字符终止的字符串,长度限
19+
制为255个字符内。
20+
为了克服这些限制并添加额外的文件元数据,通过定义额外的模板来扩展当前版本
21+
的IMA这是有必要的。例如,可能报告的信息包括索引节点的 UID/GID或索引节点
22+
及访问它进程的LSM标签。
23+
24+
然而,引入这个功能的主要问题是,每次定义一个新模板时,生成和显示度量列表
25+
的函数都需要包含处理新格式的代码,因此,这些函数的规模随着时间的推移会
26+
显著增长。
27+
28+
提出的解决方案通过将模板管理与其余IMA代码分离来解决这个问题。该解决方案
29+
的核心是定义两个新的数据结构:一个是模板描述符,用于确定度量列表中应包含
30+
哪些信息;另一个是模板字段,用于生成和显示给定类型的数据。
31+
32+
使用这些结构管理模板非常简单。为了支持一种新的数据类型,开发人员定义字段
33+
标识符,并实现两个函数,分别为init()和show(),用于生成和显示度量条目。
34+
定义一个新的模板描述符需要通过 ``ima_template_fmt`` 内核命令行参数指定
35+
模板格式(一个由 ``|`` 字符分隔的字段标识符字符串)。在启动时,IMA通过将格
36+
式转换从支持的模板字段集合中选取模板字段数组,来初始化所选的模板描述符。
37+
38+
在初始化步骤之后,IMA将调用 ``ima_alloc_init_template()`` (这是为新模板
39+
管理机制所打补丁中定义的新函数),通过使用在内核配置选择的模板描述符或者新引
40+
入的 ``ima_template`` 和 ``ima_template_fmt`` 内核命令行参数,生成一个新
41+
的度量条目。在这一阶段,新架构的优势得以清晰展示:后一个函数将不会包含处理给
42+
定模板的特定代码,而是简单地调用与所选模板描述符关联的模板字段的 ``init()``
43+
方法,并将结果(指向已分配数据的指针和数据长度)存储在度量条目结构中。
44+
45+
相同的机制也用于显示度量条目。函数 ``ima[_ascii]_measurements_show()`` 会为
46+
每个条目检索用于生成该条目的模板描述符,并为模板字段结构数组中的每一项调用show()
47+
方法。
48+
49+
50+
51+
支持的模板字段和描述符
52+
======================
53+
54+
下面是支持的模板字段列表 ``('<identifier>': description)`` ,可以通过将其标识符
55+
添加到格式字符串中用于定义新的模板描述符(后续将添加对更多数据类型的支持):
56+
57+
- 'd':事件的摘要(即测量文件的摘要),通过SHA1或MD5哈希算法计算;
58+
- 'n':事件的名称(即文件名),大小至多255字节;
59+
- 'd-ng':事件的摘要,通过任意哈希算法计算(字段格式:<hash algo>:digest);
60+
- 'd-ngv2':与d-ng相同,但以"ima"或"verity"摘要类型为前缀
61+
(字段格式:<digest type>:<hash algo>:digest);
62+
- 'd-modsig':不含附加modsig的事件摘要;
63+
- 'n-ng':事件的名称,没有大小限制;
64+
- 'sig':文件签名,基于文件的/文件系统验证的摘要[1],或EVM便携式签名,
65+
如果'security.ima'包含文件哈希;
66+
- 'modsig':附加的文件签名;
67+
- 'buf':用于生成哈希的缓冲区数据,没有大小限制;
68+
- 'evmsig':EVM便携式签名;
69+
- 'iuid':索引节点的UID;
70+
- 'igid':索引节点的GID;
71+
- 'imode':索引节点的模式;
72+
- 'xattrnames':xattr名称的列表(由``|``分隔),仅当xattr存在时;
73+
- 'xattrlengths':xattr长度的列表(u32),仅当xattr存在时;
74+
- 'xattrvalues':xattr值的列表;
75+
76+
77+
下面是已定义的模板描述符列表:
78+
79+
- "ima":其格式是 ``d|n`` ;
80+
- "ima-ng"(默认):其格式是 ``d-ng|n-ng`` ;
81+
- "ima-ngv2":其格式是 ``d-ngv2|n-ng`` ;
82+
- "ima-sig":其格式是 ``d-ng|n-ng|sig`` ;
83+
- "ima-sigv2":其格式是 ``d-ngv2|n-ng|sig`` ;
84+
- "ima-buf":其格式是 ``d-ng|n-ng|buf`` ;
85+
- "ima-modsig":其格式是 ``d-ng|n-ng|sig|d-modsig|modsig`` ;
86+
- "evm-sig":其格式是 ``d-ng|n-ng|evmsig|xattrnames|xattrlengths|xattrvalues|iuid|igid|imode`` ;
87+
88+
89+
90+
使用
91+
====
92+
93+
要指定用于生成度量条目的模板描述符,目前支持以下方法:
94+
95+
- 从内核配置所支持模板描述符中选择一个模板描述符( ``ima-ng`` 是默认选择);
96+
- 通过 ``ima_template=`` 参数从内核命令行指定模板描述符名称;
97+
- 通过内核命令行参数 ``ima_template_fmt=`` 注册一个具有自定义格式的新模板描述符。

0 commit comments

Comments
 (0)