数据胶囊

步骤一：创建数据策略

用户在DSC界面创建数据策略，配置授权规则，下载策略内容或ID。

1. 登录DSC服务控制台。
2. 在左侧导航栏中，选择“数据安全屋”，进入“数据安全屋”控制台。
3. 在左侧导航栏中，选择“数据胶囊”，选择“策略”页签。
4. 单击“创建策略”，输入策略名称后，单击“下一步”。
5. （可选）访问控制配置，参数说明如表1所示，配置完成后，单击“下一步”。
   图1 访问控制配置

   

   表1 访问控制参数说明

   参数名称	参数说明
   授权访问用户	授权可以访问数据的用户。 支持选择IAM子账号，或直接输入用户ID；不配置则对所有租户内用户开放鉴权。
   访问时间	配置授权访问的时间范围。
   访问操作方式	选择访问操作方式：查看、下载、分析、预处理、训练、推理，或自定义操作方式。
   访问次数	配置可访问数据的次数，取值范围 0 - 1,000,000，0 表示不限制访问次数；次数统计所有拆封操作的总次数。

6. （可选）运行环境控制，参数说明如表2所示，配置完成后，单击“下一步”。
   图2 运行环境控制

   

   表2 运行环境控制参数说明

   参数名称	参数说明
   节点控制	限定数据胶囊只能在指定安全屋或接入点内拆封。 DSC 数据安全屋：DSC服务部署的专用安全网络区域，限定数据胶囊只能在指定的DSC安全屋内拆封。 DEW 密钥空间接入点：密码安全中心（DEW）的密钥访问代理节点，数据胶囊通过该节点间接获取KMS密钥，避免密钥直接暴露给应用。
   应用控制	限定数据胶囊仅允许在选择的应用环境中使用。 ModelArts：华为云AI开发平台，限定数据胶囊仅允许在ModelArts环境中使用，用于AI训练等场景的数据保护。 自定义：用户自行指定允许使用数据胶囊的目标应用，提供灵活的应用级访问控制。

7. （可选）网络与销毁策略配置。
   图3 网络与销毁策略
   
   • 网络控制：通过IP地址段（CIDR格式：无类别域间路由格式，表示一个IP地址段，如 192.168.1.0/24 表示 192.168.1.0 ~ 192.168.1.255 共256个IP）白名单限定允许访问数据胶囊的网络范围。

     限制数据胶囊仅能在指定网络环境中拆封访问的配置项；不配置则无网络限制。

   • 自动删除
     • 否：不启用自动删除功能。
     • 是：启用自动删除功能。

       触发条件：满足以下任意一个条件即触发数据胶囊销毁，多个条件之间为“或”关系。

       • 超期：数据胶囊超过设定的有效期后自动销毁。
       • 超过次数：数据胶囊被拆封访问次数超过设定阈值后自动销毁。
       • 非授权用户访问：当未授权用户尝试访问数据胶囊时自动销毁。
       • 非授权网络访问：当来自非授权网络（不在IP白名单内）的访问请求触发数据胶囊自动销毁。
       

       自动删除一旦触发，数据胶囊中的加密数据将被永久销毁，无法恢复，请谨慎配置！

8. 配置完成后，单击“立即创建”。
9. 策略创建成功后，在策略列表中，可查看策略ID，单击“操作”列的“查看”，可获取策略JSON文件。

   策略ID对应步骤三：胶囊封装中“dataPolicyId”；策略JSON文件对应步骤三：胶囊封装中“dataPolicy”。

步骤二：通过KMS服务生成主密钥

用户通过KMS服务生成或导入主密钥CMK，用于胶囊的封装和解封。

详细操作请参见创建密钥或导入密钥材料。

步骤三：胶囊封装

用户使用胶囊SDK在本地对需要保护的文件进行加密封装，输入策略内容/ID和主密钥ID，生成完整的胶囊 .dcap 文件。本指南面向开发者，指导如何使用 SDK 完成胶囊封装操作。

胶囊封装前，请参考数据胶囊封装对环境有哪些要求？验证环境是否满足条件，满足条件后，执行以下步骤完成胶囊封装。

1. 创建SDK实例。

   // 1. 创建SDK实例
    DataCapsuleSDK sdk = new DataCapsuleSDK(); 

2. 初始化SDK。

   封装前必须先初始化 SDK，建立与 DSC/KMS 云服务的连接。初始化时传入华为云 AK/SK（获取地址：“控制台用户名 > 我的凭证 > 访问密钥”）、区域、项目 ID（获取地址：“控制台用户名 > 我的凭证 > 项目列表 > 项目ID”） 和服务端点（sdg.region.myhuaweicloud.com）。

   // 2.初始化SDK
   //    nodeType: 1=ECS / 2=Custom / 3=CCE / 4=ModelArts
   //    securityToken: 临时AK/SK时传入，永久AK/SK传null
    int ret = sdk.init(
        "HPUAND3T5GCKPNN78OQ3",           // ak
        "vPUWAxK0ujVJt1VQxDh3az...",        // sk
        null,                               // securityToken（永久AK/SK传null）
        "cn-xx-xx",                       // region
        "d4e559b49b3b403da5279723299ed4a6",  // projectId
        "sdg.cn-xx-xx.myhuaweicloud.com",  // endpoint
        1                                    // nodeType (1=ECS)
    );
    if (ret != 0) {
        throw new RuntimeException("SDK初始化失败, ret=" + ret);
    }
    System.out.println("SDK初始化成功");

   初始化成功后返回 retCode: 0，SDK 进入就绪状态。后续封装操作无需重复初始化。

3. 准备数据策略（二选一）。

   数据策略定义了胶囊的访问控制规则，创建数据策略的方式请参见创建数据策略。支持两种方式，二选一：

   表3 数据策略方式

   方式	字段	说明	适用场景
   策略 ID 模式	dataPolicyId	引用 DSC 控制台已注册的策略 ID。在策略列表中获取。	策略已创建，直接引用。
   策略体模式	dataPolicy	内联完整策略 JSON（需含 policy_id） 在策略列表的“操作”列，单击“查看”，可获取策略JSON文件。	从控制台复制策略 JSON 粘贴

   

   dataPolicyId 和 dataPolicy 不可同时填写，也不可同时为空。

4. 调用封装接口。

   填入主密钥 ID（通过KMS服务生成主密钥的ID）、源文件路径和策略，调用SDK函数完成封装。

   // 3. 创建数据胶囊（封装）
   // dataPolicyId 和 dataPolicy 二选一，不可同时填写
    CreateResult result = sdk.createCapsule(
        "c5400849-d0d3-4cdb-b607-f2102d9ae980",  // keyId（KMS主密钥ID）
        "/root/data/report.pdf",                  // inputFile（源文件路径）
        "/root/data/output",                      // outputPath（输出目录，null则同目录） 
       "05f626873302491084ac15aa1a7a0c81",      // dataPolicyId（策略ID）
        null,                                     // dataPolicy（完整策略JSON，与ID二选一）
        null                                       // ownerInfo（权属信息JSON，选填）
    );

5. 获取封装结果。

   封装成功后，SDK返回胶囊文件路径和大小。生成的 .dcap 文件包含加密数据和完整的策略控制信息。

   System.out.println("胶囊路径: " + result.capsulePath);
   System.out.println("胶囊大小: " + result.fileSize + " 字节");

数据胶囊操作审计

记录所有数据胶囊的封装、解封及管理操作，支持多维度筛选与详情追溯，满足合规审计要求。

1. 登录DSC服务控制台。
2. 在左侧导航栏中，选择“数据安全屋”，进入“数据安全屋”控制台。
3. 在左侧导航栏中，选择“数据胶囊”，选择“审计与监控 > 数据胶囊操作审计”页签。
4. 统计概览，在审计列表上方，为您展示了使用数据胶囊的总操作次数、封装成功、解封成功和解封失败的次数。
5. 查看数据胶囊操作审计日志列表。
   图4 操作审计日志列表
   

   表5 操作审计日志列表参数说明

   参数名称	参数说明
   日志ID	每条审计日志的唯一标识。
   胶囊名称 /ID	操作的数据胶囊文件名称及ID。
   操作类型	操作类别，如“拆封”、“封装”。
   操作人ID	执行操作的用户标识。
   客户端IP	发起操作的客户端IP地址。
   操作结果	操作状态，如“成功”、“失败”。
   操作数据量	本次操作涉及的数据大小。
   操作时间	操作发生的精确时间戳。

6. 在“操作”列单击“详情”，可查看该日志的详细信息。

数据胶囊异常事件审计

集中展示数据胶囊全生命周期的异常告警事件，支持分级处置、溯源追踪与闭环管理。

1. 登录DSC服务控制台。
2. 在左侧导航栏中，选择“数据安全屋”，进入“数据安全屋”控制台。
3. 在左侧导航栏中，选择“数据胶囊”，选择“审计与监控 > 胶囊异常事件”页签。
4. 统计概览，在审计列表上方，为您展示了数据胶囊的异常事件总数、严重（完整性校验失败）、警告（未授权访问）和提示（超期/次数预警）的总次数。
5. 查看数据胶囊异常事件列表。
   图5 数据胶囊异常事件列表
   

   表6 数据胶囊异常事件列表参数说明

   参数名称	参数说明
   关联对象/ID	触发异常事件的数据胶囊文件名及胶囊唯一标识。
   事件类型	异常事件分类标签，如“次数限制”表示因拆封次数超限触发。
   级别	事件严重等级，如“警告(未授权访问)”表示检测到非授权访问行为。
   事件描述	异常事件的详细说明，如“数据策略校验不通过”，即拆封时策略核验未通过。
   触发用户/ID	触发该异常事件的用户标识（用户名和用户ID）。
   触发IP	发起异常操作的客户端IP地址。
   触发时间	异常事件发生的精确时间戳。
   状态	事件处理状态，“未处理”表示尚未处理。
   处理人/时间	处理该异常事件的操作人及处理时间，未处理时为空

6. 在“操作”列单击“详情”，可查看该日志的详细信息。
7. 已处理该事件后，在“操作”列单击“标记已处理”，在弹框中，输入CONFIRM后单击“确定”。
   

   标记为已处理后，该事件将不再在异常事件列表中显示，请谨慎操作！

编辑/删除策略

• 查看策略绑定的胶囊：在策略列表的“操作”列，单击“查看绑定胶囊”。
• 编辑策略：在策略列表的“操作”列，单击“编辑”。
• 删除策略：在策略列表的“操作”列，单击“删除”。

• 绑定胶囊的策略，不支持删除。
• 通过策略内容绑定胶囊的策略，不支持编辑。
• 策略删除后，不可恢复，请谨慎操作！

查看胶囊关联的策略/删除胶囊

• 查看胶囊关联的策略：在数据胶囊列表的“操作”列，单击“查看策略”。
• 删除数据胶囊：
  1. 在数据胶囊列表的“操作”列，单击“删除”。
  2. 在弹框中，确定是否勾选“同步删除终端侧胶囊文件”后，单击“确定”。
     

     • 勾选“同步删除终端侧胶囊文件”后，当应用端通过胶囊SDK下次请求解封该胶囊时，服务端将下发销毁指令，触发SDK自动删除本地胶囊文件；不勾选则仅删除平台侧管理记录，本地已存在的胶囊文件不受影响。
     • 删除平台侧胶囊记录后，将不再支持该胶囊的鉴权解封操作，请谨慎操作！