MIP SDK Java Wrapper如何获取标签的加密、内容标记等保护设置

安全阿岳

2026-10-6

解决方案

MIP SDK的标签保护、标记类配置不会直接存储在Label类的字段中，你可以通过以下两种方式获取对应属性：

方式1：解析Label类的`customSettings`字段

标签的所有额外配置都会以键值对形式存储在Label类的customSettings列表中，你可以通过匹配键名过滤需要的配置：

加密相关配置：键前缀通常为Encryption，例如EncryptionEnabled对应是否启用加密文件和电子邮件能力，ProtectionTemplateId对应绑定的权限模板ID
内容标记相关配置：键前缀通常为Marking，例如WatermarkEnabled/HeaderEnabled/FooterEnabled分别对应是否启用水印、页眉、页脚类的标记文件内容能力，对应键还包含标记文本、字体、字号等配置

方式2：通过PolicyEngine接口拉取标签动作配置

MIP SDK将标签关联的执行逻辑封装为动作（Action）对象，你可以调用PolicyEngine的getLabelActions()方法传入标签ID，直接获取结构化的动作配置，示例代码如下：

// 获取指定标签关联的所有动作配置
List<Action> labelActions = policyEngine.getLabelActions(targetLabel.getId(), null);
for (Action action : labelActions) {
    // 提取加密配置
    if (action instanceof ProtectionAction) {
        ProtectionAction protectAction = (ProtectionAction) action;
        boolean encryptEnabled = protectAction.isEnabled();
        // 可继续提取权限规则、加密范围等属性
    }
    // 提取水印配置
    if (action instanceof WatermarkAction) {
        WatermarkAction watermarkAction = (WatermarkAction) action;
        String watermarkText = watermarkAction.getText();
        // 可继续提取字体、颜色、透明度等属性
    }
    // 同理提取HeaderAction、FooterAction获取其他内容标记配置
}