MIP SDK 设置意外的 ContentBits 元数据

MIP SDK setting unexpected ContentBits metadata

我们正在使用 MIP SDK 将敏感度标签应用于文件(使用 c# Microsoft.InformationProtection.File nuget 包)。为此,我们使用 IFileHandler.SetLabel 方法。这似乎可以保护文件并按预期应用大部分元数据,ContentBits 元数据除外。

基于MIP SDK metadata documentation:

根据回答 and here,我不希望 MIP SDK 给内容加水印,而是添加告诉 AIP 客户端给文档加水印的 ContentBits 元数据。

如果我们有一个既加密又带有水印的标签,并且我们使用 MIP SDK 将该标签应用于文件,则该文件会受到保护并添加元数据,但是 ContentBits 属性设置为“8”。如果它是一个 Word 文档,然后我们打开它,则不会应用水印。如果我们手动将 ContentBits 属性 更改为“12”,则会在保存时添加水印。

如果我们使用 Word 手动 select 功能区中相同的加密/水印敏感度标签,文档将被加水印并受到保护。 ContentBits 元数据设置为“12”。

这种行为是预期的吗?我们尝试使用 AzureInformationProtection powershell 模块的 Set-AIPFileLabel 应用标签,它还将 ContentBits 属性 设置为“8”。我本来希望 MIP SDK 和 powershell 都将 ContentBits 设置为“12”。如果这不是设计使然,是否有建议的解决方法?

我已经能够在 1.7 上重现这个,我们正在内部调查。我会尽快在这里更新。

好的,我与工程部联系后发现这是设计使然。我会努力在文档中澄清这一点。

ContentBits 设置为反映设置标签的应用程序已采取的操作。对于 File SDK,它不支持内容标记。因此,ContentBits 值将始终为 0 或 8 - 它唯一能做的就是保护。

当支持内容标记 的应用程序保存 文档时,它应该使用它支持的操作评估当前的 ContentBits 值。在您的示例中,SDK 会看到 ContentBits 为 8,但 AIP add-in 支持所有三种形式的标记,因此预期值为 15。客户端将应用内容标记,然后将值设置为 15。

我在最初的评论中没有重现这个,我只看到 SDK 正在应用 8。我现在已经端到端地测试了这个,AIP 客户端打开了一个受 MIP SDK 保护的文件,它似乎按预期工作。也就是说,内容标记在保存时应用并且 ContentBits 更新为 15。

我用以下方法进行了测试:

  • Office 专业增强版 2009 - 13231.20262 C2R
  • AIP 客户端版本 2.8.85.0
  • MIP SDK 1.7.133 使用 this sample

能否分享一下版本详情?我希望这适用于任何 AIP UL 客户端。