本文介绍如何在基于Intel® TDX技术的ECS实例（以下简称TDX实例）中检查并验证TDX功能，以及TDX实例存在的一些功能限制。 ## 概述 [安全增强通用型实例g3ilt](https://www.volcengine.com/docs/6396/68527#.5a6J5YWo5aKe5by66YCa55So5Z6LZzNpbHQ=)基于Intel® TDX技术提供机密计算能力，可以为实例和应用提供默认的安全保护。您可以将现有应用直接迁移至TDX实例上并获得TDX能力带来的安全保护，而无需重新开发现有的应用程序。 **Intel® TDX简介** Intel® TDX (Trust Domain Extensions) 是一种基于CPU硬件的云服务器ECS保护技术，TDX实例的CPU寄存器、内存数据以及中断处理等均受到CPU硬件的机密保护，云厂商和外部攻击者均无法对TDX实例的内部运行状态（诸如运行的进程、计算中的敏感数据等）进行监控或篡改。关于Intel® TDX技术的更多信息，请参见[Inte® Trust Domain Extensions (Intel® TDX)](https://www.intel.com/content/www/us/en/developer/tools/trust-domain-extensions/overview.html)。 **TDX的关键特性**： * 强隔离性：在处理器中建立了新的信任边界，即 “信任域”。每个虚拟机都被分配一个信任域，确保虚拟机之间以及虚拟机与宿主机之间的隔离更加坚固，防止恶意软件跨域攻击。 * 内存加密：对每个信任域的内存进行加密，这意味着即使在hypervisor层或物理主机上，数据也是以加密形式存在，从而降低了数据泄露的风险。 * 远程证明：TDX支持远程证明功能，允许信任域所有者验证其虚拟机是否在可信的硬件环境中启动，并且没有被篡改，增强了对基础设施的信任。 * 安全启动：确保虚拟机仅从经过签名和验证的引导加载程序启动，进一步加强了启动过程的安全性。 * 兼容性与透明性：尽管提供了高级别的安全性，Intel® TDX设计为对操作系统和应用程序尽可能透明，减少对现有工作负载的修改需求。 ## 前提条件已创建具备TDX特性的安全增强通用型g3ilt实例。如无可用，请先[创建实例](https://www.volcengine.com/docs/6396/67743)。 :::tip * 该实例正在华北2（北京）地域邀测中，如需试用，请联系客户经理申请。 * 平台提供如下公共镜像用于创建TDX实例，该类镜像提供开箱即用的TDX环境，默认使能TDX功能并内置TDX驱动，您无需手动操作即可使用并验证TDX功能。 * Ubuntu 24.04 * Rocky Linux 9.5 * veLinux 2.0 for TDX * veLinux 2.0 CentOS Compatible for TDX ::: ## 检查TDX使能状态在使用TDX机密计算环境前，建议您先检查对应实例的TDX使能状态，确保实例处于安全保护中。 1. [登录实例](https://www.volcengine.com/docs/6396/67747)。 2. 执行以下命令，检查TDX的使能状态。 ```Plain Text lscpu |grep -i tdx_guest ``` 回显如下，表示TDX被正确使能。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_59759c0ec498a357de84a5c69547aa4e.png =596x) 3. 执行以下命令，检查TDX驱动的安装情况。 ```Plain Text ls -l /dev/tdx_guest ``` 回显如下，表示已安装相关驱动。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_763f8aec7a37db74b6a06e2bc80b816a.png =600x) ## 验证TDX远程证明您可以通过在TDX实例中生成远程证明报告（TD Quote），并通过验证工具度量其可信性，证明TDX实例处于可信安全的TDX环境。 :::tip 远程证明报告（TD Quote）用于证明您所购买的TDX实例开启了Intel® TDX保护，确保其运行环境具有数据完整性、机密性和真实性。其中Quote内容包含TD Report与Attestation key签名等关键信息。TD Report是由CPU硬件生成的代表该TDX实例身份的数据，其中包含了TDX实例的属性（attributes）、初始度量值（MRTD）、动态度量值（RTMR）、TCB SVN等关键信息，并以密码学方法保护其完整性。 ::: ### 步骤一：生成远程证明报告 :::tip 通常情况下您所购买的TDX实例已经安装并编译了远程证明所需的工具，可参考第4步查看。若没有安装请参考以下步骤进行安装与编译。 ::: 1. （可选）依次执行以下命令，安装远程证明所需的工具。 ```Plain Text # velinux/ubuntu版本 sudo apt-get update sudo apt-get install -y libtdx-attest-dev # velinux(centos compatible)/rocky linux 9.5版本 sudo yum makecache sudo yum install -y libtdx-attest-devel ``` 2. （可选）编译生成远程证明报告的工具。 1. 进入对应tdx\-quote\-generation\-sample的工作路径。 ```Plain Text cd /opt/intel/tdx-quote-generation-sample/ ``` 2. 依次执行以下命令，编译生成远程证明报告的工具。 ```Plain Text sudo sed '/rtmr_event.version = 1;/,/tdx_att_free_quote(p_quote_buf);/{/tdx_att_free_quote(p_quote_buf);/!d;}' -i test_tdx_attest.c sudo make ``` 3. 运行编译出的可执行文件。 ```Plain Text sudo ./test_tdx_attest ``` 回显如下，“Successfully get the TD Quote”表明已成功生成远程证明报告（TD Quote）。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e0731743148edb6d6cf67d31afc6acb0.png =600x) 4. 执行以下命令，查看生成的文件。 ```Plain Text ls -al /opt/intel/tdx-quote-generation-sample/ ``` ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3ee3da14d63c3773a762d89d7aa7d7ba.png =600x) 回显如上图，在tdx\-quote\-generation\-sample的工作路径下，新增了quote.dat与report.dat文件。其中，quote.dat即为远程证明报告（TD Quote）；report.dat为TD report，生成TD report需要提供16进制、长度为64字节的字符串（本文选择随机生成），该字符串会作为生成的TD report的一部分，在实践中通常作为一个哈希值。例如，它可以是一个公钥的哈希值，验证方在验证该远程证明报告成功后，可以提取这段哈希值用于后续的密钥协商流程使用。 :::tip 如需自行设置report.dat，您可以参考下方提供的文件，手动修改test_tdx_attest.c文件，并重新执行`sudo make`命令进行编译，然后通过`sudo ./test_tdx_attest -d `运行。其中``为您指定的16进制、64字节的字符串，例如`sudo ./test_tdx_attest -d 1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef`。 ::: ### 步骤二：验证远程证明报告为了验证您所购买的TDX实例的环境可信，您可以使用远程证明验证工具，验证TD Quote中内容。 1. 执行以下命令，安装远程证明验证工具及其所依赖的软件包。 ```Plain Text # velinux版本 sudo apt-get install -y tee-appraisal-tool libsgx-dcap-ql-dev libsgx-dcap-quote-verify-dev libsgx-dcap-default-qpl-dev libssl-dev libtdx-appraisal-sample # velinux(centos兼容)版本 yum install -y tee-appraisal-tool libsgx-dcap-ql-devel libsgx-dcap-quote-verify-devel libsgx-dcap-default-qpl-devel libtdx-appraisal-sample # rocky linux 9.5 yum install -y tee-appraisal-tool libsgx-dcap-quote-verify-devel libsgx-dcap-default-qpl-devel libtdx-appraisal-sample ``` 2. 配置TDX远程证明服务。配置/etc/sgx_default_qcnl.conf文件中的PCCS_URL。例如，将PCCS_URL设置为华北2（北京）的PCCS（Provisioning Certificate Cache Service）服务。 ```Plain Text sudo sed "s|\"pccs_url\": \"https:\/\/localhost:8081\/sgx\/certification\/v4/\"|\"pccs_url\": \"https:\/\/tdx-dcap-server-cn-beijing.ecs.volces.com\/sgx\/certification\/v4\/\"|" -i /etc/sgx_default_qcnl.conf ``` 3. 进入tdx\-quote\-appraisal\-sample目录，编译对应的证明工具。 ```Plain Text cd /opt/intel/tdx-quote-appraisal-sample/ sudo make ``` 回显如下图所示。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8682c8723cf45798a9d09312a484680e.png =600x) 4. 生成安全评估策略（JSON格式）。 * 方式一：使用验证工具自带的默认策略（位于/opt/intel/tdx\-quote\-appraisal\-sample/Policies/default_enclave.json）。 ```Plain Text { "policy_array": [ { "environment": { "class_id": "45b734fc-aa4e-4c3d-ad28-e43d08880e68"， }, "reference":{ "tdx_attributes":"8000000010000000", "tdx_attributes_mask": "7FFFFFFFFFFFFFFF" } } ] } ``` * 方式二：编写您的自定义策略。关于安全评估策略（Appraisal Policy）的详细介绍，请参见[Intel DCAP Appraisal Engine Developer Guide](https://download.01.org/intel-sgx/latest/dcap-latest/linux/docs/Intel_DCAP_Appraisal_Engine_Developer_Guide_for_Linux.pdf)。 * 方式三：通过[步骤一](https://www.volcengine.com/docs/6396/1339011#.5q2l6aqk5LiA77ya55Sf5oiQ6L-c56iL6K-B5piO5oql5ZGK)中生成的TD Report，来生成对应的安全评估策略。 ```Plain Text sudo tee_appraisal_tool gen_payload -in -out ``` :::tip * ``请替换为真实的TD Report路径，本文使用/opt/intel/tdx\-quote\-generation\-sample/report.dat。 * ``请替换为要生成的策略名，本文使用payload.json。 ::: 5. 对安全评估策略进行签名。生成安全评估策略后，还需要将策略进行签名并转换成对应的JWT（JSON Web Token）格式。生成的JWT文件可以被传输至任何需要验证远程证明报告的环境中，用作远程评估的安全策略以进行后续的检验流程。 * 方式一：使用默认的安全评估策略。在编译阶段就已经生成对应的签名策略，您无需操作，具体的文件存放在/opt/intel/tdx\-quote\-appraisal\-sample/Policies/default_enclave.jwt。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_aab42790dcb2e95b84382b77d140f654.png =600x) * 方式二：对自定义策略进行签名（包括通过TD Report生成的安全评估策略）。 ```Plain Text sudo tee_appraisal_tool sign_policy -in -key ec_priv.pem -out ``` :::tip * ``请替换为待签名的策略文件路径（.json文件），本文使用/opt/intel/tdx\-quote\-appraisal\-sample/payload.json。 * ``请替换为签名的策略名（以.jwt后缀命名），本文使用/opt/intel/tdx\-quote\-appraisal\-sample/payload.jwt。 ::: 回显如下，表示已生成JWT格式的安全策略。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b503fe204c4cb256afb3e268fac7e1ed.png =600x) 6. 验证远程证明报告。 * 方式一：使用验证工具自带的默认安全评估策略，验证远程证明生成的Quote。 ```Plain Text sudo ./verifier -quote ``` > 请替换为待验证的Quote路径，本文使用/opt/intel/tdx\-quote\-generation\-sample/quote.dat。回显如下图所示。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b5cdf91b782fdfac87335cbaa7c11c3f.png =600x) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e8d662ad3e20b7aea4aae0aaefdc3b96.png =600x) * 方式二：使用您签名后的自定义策略进行验证（包括通过TD Report生成的安全评估策略）。 ```Plain Text sudo ./verifier -quote -td_identity_policy ``` :::tip * ``请替换为待验证的Quote路径，本文使用/opt/intel/tdx\-quote\-generation\-sample/quote.dat。 * ``请替换为您生成的策略路径，本文使用/opt/intel/tdx\-quote\-appraisal\-sample/payload.jwt。 ::: 回显如下图所示。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_297961831b20379116c86355198f6a63.png =600x) ## TDX实例限制说明 * TDX实例暂不支持VNC登录。 * TDX实例的CPU寄存器和内存中的数据会通过CPU硬件进行加密保护，因此其性能相较常规ECS实例存在一定损失。 * 当前仅支持使用 Ubuntu 24.04、Rocky Linux 9.5 通用公共镜像和 veLinux 2.0 for TDX、veLinux 2.0 CentOS Compatible for TDX 定制版公共镜像，若您使用自定义镜像创建TDX实例可能会导致实例无法使用。 * Linux guest kernel SWIOTLB buffer已知问题： > SWIOTLB： Software Input Output Translation Lookaside Buffer，软件实现的 I/O 传输后备缓冲区。 * 可见内存较常规实例较小，开启了TDX特性的ECS实例内部将使用特定的非加密内存（SWIOTLB）用于外设通信，该内存区域的大小默认情况下为ECS实例可用内存的6%（但不大于1 GiB）。 * 大规格实例插入多张弹性网卡可能导致ECS实例夯机，原因是网卡多队列情况下SWIOTLB内存可能不足导致内存分配失败，您可以在控制台将对应ECS实例关机并卸载对应弹性网卡以从启动失败中恢复。 * 如果您的实例负载涉及大量的I/O通信，则可能遭遇由SWIOTLB不足导致的性能下降。您可以执行以下命令检查该问题是否存在： ```Plain Text dmesg| grep 'swiotlb buffer is full' ``` :::warning 错误配置SWIOTLB参数可能导致您的实例启动失败，建议您在操作前创建磁盘快照以方便在任何错误情况下可以安全回滚。具体操作，请参见[创建快照](https://www.volcengine.com/docs/6396/91535)。 ::: 若存在该问题，您可以尝试调大SWIOTLB的值以改善ECS的性能，具体操作如下： 1. 打开/etc/default/grub文件。 ```Plain Text vim /etc/default/grub ``` 2. 在GRUB_CMDLINE_LINUX字段后加入SWIOTLB相关参数。例如将GRUB_CMDLINE_LINUX修改为`GRUB_CMDLINE_LINUX=".... swiotlb=524288"`以将SWIOTLB的大小修改为1 GiB。 > SWIOTLB参数取值的计算方法为：目标大小（以MiB为单位）\* 512。更多信息，请参见[The kernel's command-line parameters](https://docs.kernel.org/admin-guide/kernel-parameters.html)。 3. 执行以下命令，更新grub.cfg配置文件使修改生效。 ```Plain Text # velinux/ubuntu版本 sudo update-grub # velinux(centos compatible)版本 sudo grub2-mkconfig -o /boot/efi/EFI/centos/grub.cfg --update-bls-cmdline # rocky linux 9.5 sudo grub2-mkconfig -o /boot/grub2/grub.cfg --update-bls-cmdline ```