使用策略保护文档

撤销对文档的访问

使用Java API将策略应用于PDF文档

使用文档安全API(Java)将策略应用于PDF文档:

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档安全客户端API对象。
- 创建包 ServiceClientFactory 含连接属性的对象。
- 使用对 RightsManagementClient 象的构造函数并传递该对 ServiceClientFactory 象。
检索PDF文档。
- 使用 java.io.FileInputStream 其构造函数创建一个表示PDF文档的对象。传递一个指定PDF文档位置的字符串值。
- 使用对 com.adobe.idp.Document 象的构造函数并传递该对 java.io.FileInputStream 象。
将现有策略应用于PDF文档。
- 通过 DocumentManager 调用对象的 RightsManagementClient 方法创建 getDocumentManager 对象。
- 通过调用对象的方法并传递以 DocumentManager 下值，将 protectDocument 策略应用于PDF文档:
  - 包 com.adobe.idp.Document 含应用策略的PDF文档的对象。
  - 一个字符串值，它指定文档的名称。
  - 一个字符串值，它指定策略所属的策略集的名称。您可以指定 null 导致使用策 MyPolicies 略集的值。
  - 指定策略名称的字符串值。
  - 一个字符串值，它表示作为文档发布者的用户的用户管理器域的名称。此参数值是可选的，可以为null（如果此参数为null，则下一个参数值必须为null）。
  - 一个字符串值，它表示作为文档发布者的用户管理器用户的规范名称。此参数值是可选的，可 null 以是(如果此参数为null，则前一个参数值必须 null是)。
  - 表 com.adobe.livecycle.rightsmanagement.Locale 示用于选择MS Office模板的区域设置。此参数值是可选的，不用于PDF文档。要保护PDF文档，请指定 null。
  该方 protectDocument 法返回 RMSecureDocumentResult 一个包含受策略保护的PDF文档的对象。
保存PDF文档。
- 调用对 RMSecureDocumentResult 象的方 getProtectedDoc 法以获取受策略保护的PDF文档。此方法返回一个 com.adobe.idp.Document 对象。
- 创建对 java.io.File 象并确保文件扩展名为PDF。
- 调用 com.adobe.idp.Document 对象的方 copyToFile 法，将对象的内容复制到文件 Document 中(确保使用该方 Document 法返回的 getProtectedDoc 对象)。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始（EJB模式）: 使用Java API将策略应用于PDF文档”
"快速开始（SOAP模式）: 使用Java API将策略应用于PDF文档”

另请参阅

使用Web服务API将策略应用于PDF文档

使用文档安全API（Web服务）将策略应用于PDF文档:

包括项目文件。

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象。
- 使用对象 RightsManagementServiceClient 的默认构造函数创建对象。
- 使用构 RightsManagementServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给Forms服务(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 RightsManagementServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 RightsManagementServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 RightsManagementServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
检索PDF文档。
- 使用对 BLOB 象的构造函数创建对象。对 BLOB 象用于存储应用策略的PDF文档。
- 通过调 System.IO.FileStream 用对象的构造函数并传递一个字符串值来创建对象，该字符串值表示PDF文档的文件位置以及打开文件的模式。
- 创建存储对象内容的字节数 System.IO.FileStream 组。通过获取对象的属性来确 System.IO.FileStream 定字节数组 Length 大小。
- 通过调用对象的方法，用流数 System.IO.FileStream 据填充字节 Read 数组。传递要读取的字节数组、开始位置和流长度。
- 通过 BLOB 为对象的字段 MTOM 指定字节数组的内容来填充对象。
将现有策略应用于PDF文档。

通过调用对象的方法并传递以 RightsManagementServiceClient 下值，将 protectDocument 策略应用于PDF文档:
- 包 BLOB 含应用策略的PDF文档的对象。
- 一个字符串值，它指定文档的名称。
- 一个字符串值，它指定策略所属的策略集的名称。您可以指定 null 导致使用策 MyPolicies 略集的值。
- 指定策略名称的字符串值。
- 一个字符串值，它表示作为文档发布者的用户的用户管理器域的名称。此参数值是可选的，可以为null(如果此参数为null，则下一个参数值必须 null为)。
- 一个字符串值，它表示作为文档发布者的用户管理器用户的规范名称。此参数值是可选的，可以为null(如果此参数为null，则前一个参数值必须 null为)。
- 一 RMLocale 个值，它指定区域设置值(例如 RMLocale.en)。
- 用于存储策略标识符值的字符串输出参数。
- 用于存储受策略保护的标识符值的字符串输出参数。
- 用于存储mime类型的字符串输出参数(例如 application/pdf)。
该方 protectDocument 法返回 BLOB 一个包含受策略保护的PDF文档的对象。
保存PDF文档。
- 通过调 System.IO.FileStream 用其构造函数并传递一个字符串值来创建对象，该字符串值表示受策略保护的PDF文档的文件位置。
- 创建一个字节数组，它存储由方 BLOB 法返回的对象的数据 protectDocument 内容。通过获取对象数据成员的 BLOB 值填充字 MTOM 节数组。
- 通过调 System.IO.BinaryWriter 用对象的构造函数并传递该对 System.IO.FileStream 象来创建。
- 通过调用对象的方法并传递字节数组，将字 System.IO.BinaryWriter 节数组的 Write 内容写入PDF文件。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API将策略应用于PDF文档”
“快速开始(SwaRef): 使用Web服务API将策略应用于PDF文档”

从PDF删除策略文档

您可以从受策略保护的文档中删除策略，以便从文档中删除安全性。也就是说，如果您不再希望文档受策略保护。如果要使用较新的策略更新受策略保护的文档，则切换策略比删除策略和添加更新的策略更有效。

注意

有关文档安全服务的详细信息，请参阅AEM Forms服务参考。

步骤摘要

要从受策略保护的PDF文档中删除策略，请执行以下步骤：

包括项目文件
创建文档安全客户端API对象。
检索受策略保护的PDF文档。
从PDF文档中删除策略。
保存不安全的PDF文档。

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建文档安全客户端API对象

在以编程方式执行文档安全服务操作之前，请创建文档安全服务客户端对象。

检索受策略保护的PDF文档

您可以检索受策略保护的PDF文档以删除策略。如果尝试从未受策略保护的PDF文档中删除策略，将引起异常。

从PDF文档中删除策略

如果在连接设置中指定了管理员，则可以从受策略保护的PDF文档中删除策略。否则，用于保护文档的策略必须包含该权 SWITCH_POLICY 限，才能从PDF文档中删除策略。此外，在AEM Forms连接设置中指定的用户也必须具有该权限。否则，将引发异常。

保存不安全的PDF文档

在文档安全服务从PDF文档中删除策略后，您可以将不安全的PDF文档另存为PDF文件。

另请参阅

将策略应用于PDF文档

使用Java API从PDF文档中删除策略

使用文档安全API(Java)从受策略保护的PDF文档中删除策略：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档安全客户端API对象。
- 创建包 ServiceClientFactory 含连接属性的对象。
- 使用对 DocumentSecurityClient 象的构造函数并传递该对 ServiceClientFactory 象。
检索受策略保护的PDF文档。
- 使用 java.io.FileInputStream 其构造函数并传递一个指定PDF文档位置的字符串值，创建一个表示受策略保护的PDF文档的对象。
- 使用对 com.adobe.idp.Document 象的构造函数并传递该对 java.io.FileInputStream 象。
从PDF文档中删除策略。
- 通过 DocumentManager 调用对象的 DocumentSecurityClient 方法创建 getDocumentManager 对象。
- 通过调用对象的方法并传递包含受策 DocumentManager 略保护的PDF文档 removeSecurity 的对象， com.adobe.idp.Document 从PDF文档中删除策略。此方法返回一 com.adobe.idp.Document 个对象，它包含一个不安全的PDF文档。
保存不安全的PDF文档。
- 创建对 java.io.File 象并确保文件扩展名为PDF。
- 调用 Document 对象的方 copyToFile 法，将对象的内容复制到文件 Document 中(确保使用该方 Document 法返回的 removeSecurity 对象)。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

"快速开始（SOAP模式）: 使用Java API从PDF文档删除策略”

使用Web服务API删除策略

使用文档安全API（Web服务）从受策略保护的PDF文档中删除策略：

包括项目文件。

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象。
- 使用对象 DocumentSecurityServiceClient 的默认构造函数创建对象。
- 使用构 DocumentSecurityServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 DocumentSecurityServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
检索受策略保护的PDF文档。
- 使用对 BLOB 象的构造函数创建对象。该 BLOB 对象用于存储从中删除策略的受策略保护的PDF文档。
- 通过调 System.IO.FileStream 用对象的构造函数并传递一个字符串值来创建对象，该字符串值表示PDF文档的文件位置以及打开文件的模式。
- 创建存储对象内容的字节数 System.IO.FileStream 组。您可以通过获取对象的属性来确定字 System.IO.FileStream 节数组的大 Length 小。
- 通过调用对象的方法并传递要读取 System.IO.FileStream 的字节数 Read 组、开始位置和流长度，用流数据填充字节数组。
- 通过 BLOB 为对象的字段 MTOM 指定字节数组的内容来填充对象。
从PDF文档中删除策略。

通过调用对象的方法并传递包含受策 DocumentSecurityServiceClient 略保护的PDF文档 removePolicySecurity 的对象， BLOB 从PDF文档中删除策略。此方法返回一 BLOB 个对象，它包含一个不安全的PDF文档。
保存不安全的PDF文档。
- 通过调 System.IO.FileStream 用对象的构造函数并传递一个字符串值来创建对象，该字符串值表示不安全PDF文档的文件位置。
- 创建一个字节数组，它存储由方 BLOB 法返回的对象的数据 removePolicySecurity 内容。通过获取对象字段的值 BLOB 填充字节数 MTOM 组。
- 通过调 System.IO.BinaryWriter 用对象的构造函数并传递该对 System.IO.FileStream 象来创建。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API从PDF文档删除策略”
“快速开始(SwaRef): 使用Web服务API从PDF文档删除策略”

另请参阅

撤销对文档的访问

您可以撤销对受策略保护的PDF文档的访问权，导致用户无法访问该文档的所有副本。当用户尝试打开已撤销的PDF文档时，会将其重定向到可查看修改的文档的指定URL。必须以编程方式指定用户被重定向到的URL。当您撤销对文档的访问权时，更改将在用户下次通过联机打开受策略保护的文档与文档安全服务同步时生效。

撤销对文档的访问权限的能力提供了额外的安全性。例如，假定文档有较新版本可用，并且您不再希望任何人查看过时的版本。在这种情况下，可以撤销对旧文档的访问权，除非恢复访问权，否则任何人都无法视图文档。

注意

有关文档安全服务的详细信息，请参阅AEM Forms服务参考。

步骤摘要

要撤销受策略保护的文档，请执行以下步骤：

包括项目文件。
创建文档安全客户端API对象。
检索受策略保护的PDF文档。
撤销受策略保护的文档。

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建文档安全客户端API对象

在以编程方式执行文档安全服务操作之前，必须创建文档安全服务客户端对象。

检索受策略保护的PDF文档

您必须检索受策略保护的PDF文档才能撤销它。您不能撤销已撤销或不是受策略保护的文档的文档。

如果您知道受策略保护的文档的许可证标识符值，则无需检索受策略保护的PDF文档。但是，在大多数情况下，您需要检索PDF文档才能获得许可证标识符值。

撤销受策略保护的文档

要撤销受策略保护的文档，请指定受策略保护的文档的许可证标识符。此外，还可以指定用户在尝试打开已吊销文档时可以视图的文档的URL。即假设已过时的文档被吊销。当用户尝试打开已撤销的文档时，他们将看到更新的文档而不是已撤销的文档。

注意

如果尝试撤销已撤销的文档，则会引发异常。

另请参阅

使用Java API撤销对文档的访问权

使用文档安全API(Java)撤销对受策略保护的PDF文档的访问权：

包括项目文件

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档安全客户端API对象
- 创建包 ServiceClientFactory 含连接属性的对象。
- 使用对 DocumentSecurityClient 象的构造函数并传递该对 ServiceClientFactory 象。
检索受策略保护的PDF文档
- 使用 java.io.FileInputStream 其构造函数并传递一个指定PDF文档位置的字符串值，创建一个表示受策略保护的PDF文档的对象。
- 使用对 com.adobe.idp.Document 象的构造函数并传递该对 java.io.FileInputStream 象。
撤销受策略保护的文档
- 通过 DocumentManager 调用对象的 DocumentSecurityClient 方法创建 getDocumentManager 对象。
- 通过调用对象的方法检索受策略保护的文档的 DocumentManager 许可证标识符 getLicenseId 值。传递 com.adobe.idp.Document 表示受策略保护的文档的对象。此方法返回表示许可证标识符值的字符串值。
- 通过 LicenseManager 调用对象的 DocumentSecurityClient 方法创建 getLicenseManager 对象。
- 通过调用对象的方法并传递以 LicenseManager 下值来撤 revokeLicense 销受策略保护的文档:
  - 一个字符串值，它指定受策略保护的文档的许可证标识符值(指定对象方 DocumentManager 法的返回 getLicenseId 值)。
  - 接口的静态数 License 据成员，指定撤销文档的原因。 For example, you can specify License.DOCUMENT_REVISED.
  - 一个 java.net.URL 值，它指定修订文档所在的位置。如果您不想将用户重定向到其他URL，则可以通过 null。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

"快速开始（SOAP模式）: 使用Java API撤销文档”

使用Web服务API撤销对文档的访问权

使用文档安全API（Web服务）撤销对受策略保护的PDF文档的访问权：

包括项目文件

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象
- 使用对象 DocumentSecurityServiceClient 的默认构造函数创建对象。
- 使用构 DocumentSecurityServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 DocumentSecurityServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
检索受策略保护的PDF文档
- 使用对 BLOB 象的构造函数创建对象。该对 BLOB 象用于存储被撤销的受策略保护的PDF文档。
- 通过调 System.IO.FileStream 用其构造函数并传递一个字符串值来创建对象，该字符串值表示要撤销的受策略保护的PDF文档的文件位置以及打开文件的模式。
- 创建存储对象内容的字节数 System.IO.FileStream 组。您可以通过获取对象的属性来确定字 System.IO.FileStream 节数组的大 Length 小。
- 通过调用对象的方法并传递要读取的 System.IO.FileStream 字节数 Read 组、开始位置和流长度，用流数据填充字节数组。
- 通过 BLOB 为对象的字段 MTOM 指定字节数组的内容来填充对象。
撤销受策略保护的文档
- 通过调用对象的方法并传递表示受策略保护的文档的 DocumentSecurityServiceClient 对象， getLicenseID 检索受策 BLOB 略保护的文档的许可证标识符值。此方法返回表示许可证标识符的字符串值。
- 通过调用对象的方法并传递以 DocumentSecurityServiceClient 下值来撤 revokeLicense 销受策略保护的文档:
  - 一个字符串值，它指定受策略保护的文档的许可证标识符值(指定对象方 DocumentSecurityServiceService 法的返回 getLicenseId 值)。
  - 枚举的静态数 Reason 据成员，指定撤销文档的原因。 For example, you can specify Reason.DOCUMENT_REVISED.
  - 一个 string 值，它指定修订文档所在的URL位置。如果您不想将用户重定向到其他URL，则可以通过 null。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API撤销文档”
“快速开始(SwaRef): 使用Web服务API撤销文档”

另请参阅

从Word文档删除策略

恢复对已吊销文档的访问

您可以恢复对已撤销PDF文档的访问权，使用户可以访问已撤销文档的所有副本。当用户打开被撤销的恢复文档时，用户能够视图文档。

注意

有关文档安全服务的详细信息，请参阅AEM Forms服务参考。

步骤摘要

要恢复对已吊销的PDF文档的访问权限，请执行以下步骤：

包括项目文件。
创建文档安全客户端API对象。
检索已吊销的PDF文档的许可证标识符。
恢复对已吊销的PDF文档的访问权限。

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建文档安全客户端API对象

在以编程方式执行文档安全服务操作之前，必须创建文档安全服务客户端对象。如果您使用Java API，请创建一个 DocumentSecurityClient 对象。如果您使用文档安全Web服务API，请创建一个 DocumentSecurityServiceService 对象。

检索已吊销的PDF文档的许可证标识符

您必须检索已吊销的PDF文档的许可证标识符，才能恢复已吊销的PDF文档。获取许可证标识符值后，可恢复已吊销的文档。如果尝试恢复未撤销的文档，将导致异常。

恢复对已吊销的PDF文档的访问权限

要恢复对已吊销的PDF文档的访问权，必须指定已吊销的文档的许可证标识符。如果尝试恢复未撤销的PDF文档的访问权限，将引起异常。

另请参阅

使用Java API恢复对已吊销文档的访问

使用文档安全API(Java)恢复对已吊销文档的访问：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档安全客户端API对象。
- 创建包 ServiceClientFactory 含连接属性的对象。
- 使用对 DocumentSecurityClient 象的构造函数并传递该对 ServiceClientFactory 象。
检索已吊销的PDF文档的许可证标识符。
- 通过使 java.io.FileInputStream 用其构造函数并传递指定PDF文档位置的字符串值，创建一个表示已吊销的PDF文档的对象。
- 使用对 com.adobe.idp.Document 象的构造函数并传递该对 java.io.FileInputStream 象。
- 通过 DocumentManager 调用对象的 DocumentSecurityClient 方法创建 getDocumentManager 对象。
- 通过调用对象的方法并传递表示已撤销文档的 DocumentManager 对象， getLicenseId 检索已撤 com.adobe.idp.Document 销文档的许可证标识符值。此方法返回表示许可证标识符的字符串值。
恢复对已吊销的PDF文档的访问权限。
- 通过 LicenseManager 调用对象的 DocumentSecurityClient 方法创建 getLicenseManager 对象。
- 通过调用对象的方法并传递已撤销文档的 LicenseManager 许可证标识符 unrevokeLicense 值，恢复对已撤销PDF文档的访问。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

"快速开始（SOAP模式）: 使用Web服务API恢复对已吊销文档的访问权”

使用Web服务API恢复对已吊销文档的访问

使用文档安全API（Web服务）恢复对已吊销文档的访问：

包括项目文件。

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象。
- 使用对象 DocumentSecurityServiceClient 的默认构造函数创建对象。
- 使用构 DocumentSecurityServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 DocumentSecurityServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
检索已吊销的PDF文档的许可证标识符。
- 使用对 BLOB 象的构造函数创建对象。该对 BLOB 象用于存储已撤销的PDF文档，恢复对其的访问。
- 通过调 System.IO.FileStream 用对象的构造函数并传递一个字符串值来创建对象，该字符串值表示已撤销的PDF文档的文件位置以及打开文件的模式。
- 创建存储对象内容的字节数 System.IO.FileStream 组。您可以通过获取对象的属性来确定字 System.IO.FileStream 节数组的大 Length 小。
- 通过调用对象的方法并传递要读取 System.IO.FileStream 的字节数 Read 组、开始位置和流长度，用流数据填充字节数组。
- 通过 BLOB 为对象的字段 MTOM 指定字节数组的内容来填充对象。
恢复对已吊销的PDF文档的访问权限。
- 通过调用对象的方法并传递表示已撤销文档的 DocumentSecurityServiceClient 对象， getLicenseID 检索已撤 BLOB 销文档的许可证标识符值。此方法返回表示许可证标识符的字符串值。
- 通过调用对象的方法并传递指定已撤销PDF文档的 DocumentSecurityServiceClient 许可证标识符值的字符串值( unrevokeLicense 传递对象方法的返回值)，恢复对已撤 DocumentSecurityServiceClient 销PDF文档的访 getLicenseId 问权。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API恢复对已吊销文档的访问权”
“快速开始(SwaRef): 使用Web服务API恢复对已吊销文档的访问权”

另请参阅

检查受策略保护的PDF文档

您可以使用文档安全服务API（Java和Web服务）检查受策略保护的PDF文档。检查受策略保护的PDF文档会返回有关受策略保护的PDF文档的信息。例如，您可以确定用于保护文档的策略以及保护文档的日期。

如果您的LiveCycle版本是8.x或更早版本，则无法执行此任务。在AEM Forms中添加了对检查受策略保护的文档的支持。如果尝试使用LiveCycle 8.x（或更早版本）检查受策略保护的文档，将引发异常。

注意

有关文档安全服务的详细信息，请参阅AEM Forms服务参考。

步骤摘要

要检查受策略保护的PDF文档，请执行以下步骤：

包括项目文件。
创建文档安全客户端API对象。
检索受策略保护的文档进行检查。
获取有关受策略保护的文档的信息。

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建文档安全客户端API对象

在以编程方式执行文档安全服务操作之前，请创建文档安全服务客户端对象。如果您使用Java API，请创建一个 RightsManagementClient 对象。如果您使用文档安全Web服务API，请创建一个 RightsManagementServiceService 对象。

检索受策略保护的文档以进行检查

要检查受策略保护的文档，请检索它。如果尝试检查未通过策略保护或被吊销的文档，将引发异常。

检查文档

检索受策略保护的文档后，可以检查它。

获取有关受策略保护的文档的信息

检查受策略保护的PDF文档后，可以获取其相关信息。例如，您可以确定用于保护文档的策略。

如果使用属于“我的策略”的策略保护文档，然后调用或 RMInspectResult.getPolicysetName , RMInspectResult.getPolicysetId则返回null。

如果文档是使用包含在策略集（“我的策略”除外）中的策略进行保护的，则返回 RMInspectResult.getPolicysetName 有效 RMInspectResult.getPolicysetId 的字符串。

另请参阅

使用Java API检查受策略保护的PDF文档

使用文档安全服务API(Java)检查受策略保护的PDF文档:

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。有关这些文件的位置的信息，请参阅包括AEM FormsJava库文件。
创建文档安全客户端API对象。
- 创建包 ServiceClientFactory 含连接属性的对象。 (请参阅设置连接属性。)
- 使用对 RightsManagementClient 象的构造函数并传递该对 ServiceClientFactory 象。
检索受策略保护的文档进行检查。
- 使用 java.io.FileInputStream 其构造函数创建一个表示受策略保护的PDF文档的对象。传递一个指定PDF文档位置的字符串值。
- 使用对 com.adobe.idp.Document 象的构造函数并传递该对 java.io.FileInputStream 象。
检查文档。
- 通过 DocumentManager 调用对象的 RightsManagementClient 方法创建 getDocumentManager 对象。
- 通过调用对象的方法检查受策 LicenseManager 略保护的文档 inspectDocument 符。传递 com.adobe.idp.Document 包含受策略保护的PDF文档的对象。此方法返回一 RMInspectResult 个对象，其中包含有关受策略保护的文档的信息。
获取有关受策略保护的文档的信息。

要获取有关受策略保护的文档的信息，请调用属于对象的相应 RMInspectResult 方法。例如，要检索策略名称，请调 RMInspectResult 用对象的方 getPolicyName 法。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

"快速开始（SOAP模式）: 使用Java API检查受策略保护的PDF文档"

使用Web服务API检查受策略保护的PDF文档

使用文档安全服务API（Web服务）检查受策略保护的PDF文档:

包括项目文件。

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象。
- 使用对象 RightsManagementServiceClient 的默认构造函数创建对象。
- 使用构 RightsManagementServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 RightsManagementServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 RightsManagementServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 RightsManagementServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
检索受策略保护的文档进行检查。
- 使用对 BLOB 象的构造函数创建对象。该 BLOB 对象用于存储要检查的PDF文档。
- 通过调 System.IO.FileStream 用对象的构造函数创建对象。传递一个字符串值，它表示PDF文档的文件位置以及在中打开文件的模式。
- 创建存储对象内容的字节数 System.IO.FileStream 组。您可以通过获取对象的属性来确定字 System.IO.FileStream 节数组的大 Length 小。
- 通过调用对象的方法，用流数 System.IO.FileStream 据填充字节 Read 数组。传递要读取的字节数组、开始位置和流长度。
- 通过 BLOB 为对象的字段 MTOM 指定字节数组的内容来填充对象。
检查文档。

通过调用对象的方法检查受策 RightsManagementServiceClient 略保护的文档 inspectDocument 符。传递 BLOB 包含受策略保护的PDF文档的对象。此方法返回一 RMInspectResult 个对象，其中包含有关受策略保护的文档的信息。
获取有关受策略保护的文档的信息。

要获取有关受策略保护的文档的信息，请获取属于该对象的相应字段的 RMInspectResult 值。例如，要检索策略名称，请获取对 RMInspectResult 象字段的 policyName 值。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API检查受策略保护的PDF文档"
“快速开始(SwaRef): 使用Web服务API检查受策略保护的PDF文档"

另请参阅

创建水印

水印通过唯一识别文档并控制版权侵权来帮助确保文档的安全。例如，您可以创建水印并将其放置在文档的所有页面上，该水印将声明机密性。创建水印后，您可以将其作为策略的一部分包含。也就是说，您可以使用新创建的水印设置策略的水印属性。在将包含水印的策略应用到文档后，该水印会显示在受策略保护的文档中。

注意

只有具有文档安全管理权限的用户才能创建水印。即，在定义创建文档安全服务客户端对象所需的连接设置时，必须指定此类用户。

注意

有关文档安全服务的详细信息，请参阅AEM Forms服务参考。

步骤摘要

要创建水印，请执行以下步骤：

包括项目文件。
创建文档安全客户端API对象。
设置水印属性。
向文档安全服务注册水印。

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建文档安全客户端API对象

设置水印属性

要创建新水印，必须设置水印属性。必须始终定义名称属性。除了name属性之外，您还必须至少设置以下属性之一：

自定义文本
包含日期
包含的用户ID
包含的用户名

下表列表了使用Web服务创建水印时所需的键和值对。

密钥名称	描述	值
`WaterBackCmd:IS_USERNAME_ENABLED`	指定打开文档的用户的用户名是否属于水印的一部分。	True或False
`WaterBackCmd:IS_USERID_ENABLED`	指定打开文档的用户的标识是否是水印的一部分。	True或False
`WaterBackCmd:IS_CURRENTDATE_ENABLED`	指定当前日期是否是水印的一部分。	True或False
`WaterBackCmd:IS_CUSTOMTEXT_ENABLED`	如果此值为true，则必须使用指定自定义文本的值 `WaterBackCmd:SRCTEXT`。	True或False
`WaterBackCmd:OPACITY`	指定水印的不透明度。如果未指定默认值，则默认值为0.5。	介于0.0和1.0之间的值。
`WaterBackCmd:ROTATION`	指定水印的旋转。默认值为0度。	介于0和359之间的值。
`WaterBackCmd:SCALE`	如果指定了此值， `WaterBackCmd:IS_SIZE_ENABLED` 则必须存在，且该值必须为true。如果未指定此属性，则默认行为适合页面。	大于0.0且小于或等于1.0的值。
`WaterBackCmd:HORIZ_ALIGN`	指定水印的水平对齐方式。默认值为中心。	左、中或右
`WaterBackCmd:VERT_ALIGN`	指定水印的垂直对齐方式。默认值为中心。	顶部、中心或底部
`WaterBackCmd:IS_USE_BACKGROUND`	指定水印是否为背景。默认值为false。	True或False
`WaterBackCmd:IS_SIZE_ENABLED`	如果指定了自定义比例，则为True。如果此值为true，则还必须指定SCALE。如果此值为false，则默认值将适合页面大小。	True或False
`WaterBackCmd:SRCTEXT`	指定水印的自定义文本。如果此值存在，则 `WaterBackCmd:IS_CUSTOMTEXT_ENABLED` 也必须存在并设置为true。	True或False

所有水印都必须定义以下属性之一：

WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED

所有其他属性都是可选的。

注册水印

必须先在文档安全服务中注册新水印，然后才能使用。注册水印后，您可以在策略中使用它。

另请参阅

将策略应用于PDF文档

使用Java API创建水印

使用文档安全API(Java)创建水印：

包括项目文件。

在Java项目的类路 adobe-rightsmanagement-client.jar径中包含客户端JAR文件。
创建文档安全客户端API对象。
- 创建包 ServiceClientFactory 含连接属性的对象。
- 使用对 RightsManagementClient 象的构造函数并传递该对 ServiceClientFactory 象。
设置水印属性
- 通过 Watermark 调用对象的 InfomodelObjectFactory 静态方法创建 createWatermark 对象。此方法返回一个 Watermark 对象。
- 通过调用对象的方法并传递指定策 Watermark 略名称的 setName 字符串值，设置水印的名称属性。
- 通过调用对象的方法并传递来设 Watermark 置水印的 setBackground 背景属性 true。通过设置此属性，水印会显示在文档的背景中。
- 通过调用对象的方法并传递表示水 Watermark 印文本的 setCustomText 字符串值，设置水印的自定义文本属性。
- 通过调用对象的方法并传递指定不 Watermark 透明度级 setOpacity 别的整数值，设置水印的不透明度属性。值100表示水印完全不透明，值0表示水印完全透明。
注册水印。
- 通过 WatermarkManager 调用对象的 RightsManagementClient 方法创建 getWatermarkManager 对象。此方法返回一个 WatermarkManager 对象。
- 通过调用对象的方 WatermarkManager 法并传 registerWatermark 递表示要注 Watermark 册的水印的对象来注册水印。此方法返回一个表示水印标识值的字符串值。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

"快速开始（SOAP模式）: 使用Java API创建水印”

使用Web服务API创建水印

使用文档安全API（Web服务）创建水印：

创建文档安全客户端API对象。

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象。
- 使用对象 RightsManagementServiceClient 的默认构造函数创建对象。
- 使用构 RightsManagementServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 RightsManagementServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 RightsManagementServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 RightsManagementServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
设置水印属性。
- 通过调 WatermarkSpec 用构造函数创建 WatermarkSpec 对象。
- 通过为对象的数据成员分配字符串值 WatermarkSpec 来设置水 name 印名称。
- 通过为对象的 id 数据成员分配字符串值来 WatermarkSpec 设置水印 id 的属性。
- 对于要设置的每个水印属性，创建一个单独的 MyMapOf_xsd_string_To_xsd_anyType_Item 对象。
- 通过为对象的数据成员 MyMapOf_xsd_string_To_xsd_anyType_Item 分配值 key 来设置键值(例如 WaterBackCmd:OPACITY)。
- 通过为对象的数据成员 MyMapOf_xsd_string_To_xsd_anyType_Item 分配值 value 来设置值(例如 .25)。
- 创建对 MyArrayOf_xsd_anyType 象。对于每 MyMapOf_xsd_string_To_xsd_anyType_Item 个对象，调 MyArrayOf_xsd_anyType 用对象的方 Add 法。传递对 MyMapOf_xsd_string_To_xsd_anyType_Item 象。
- 将对 MyArrayOf_xsd_anyType 象指定 WatermarkSpec 给对象的数 values 据成员。
注册水印。

通过调用对象的方 RightsManagementServiceClient 法并传 registerWatermark 递表示要注 WatermarkSpec 册的水印的对象来注册水印。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API创建水印”
“快速开始(SwaRef): 使用Web服务API创建水印”

另请参阅

修改水印

您可以使用文档安全Java API或Web服务API修改现有水印。要更改现有水印，请检索它，修改它的属性，然后在服务器上更新它。例如，假定您检索水印并修改其不透明度属性。在更改生效之前，您必须更新水印。

当您修改水印时，更改会影响应用了水印的未来文档。即，包含水印的现有PDF文档不受影响。

注意

只有具有文档安全管理权限的用户才能修改水印。即，在定义创建文档安全服务客户端对象所需的连接设置时，必须指定此类用户。

注意

有关文档安全服务的详细信息，请参阅AEM Forms服务参考。

步骤摘要

要修改水印，请执行以下步骤：

包括项目文件。
创建文档安全客户端API对象。
检索要修改的水印。
设置水印属性。
更新水印。

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建文档安全客户端API对象

检索要修改的水印

要修改水印，必须检索现有水印。您可以通过指定水印名称或指定水印的标识符值来检索水印。

设置水印属性

要修改现有水印，请更改一个或多个水印属性的值。当使用Web服务以编程方式更新水印时，必须设置最初设置的所有属性，即使该值没有更改也是如此。例如，假定设置了以下水印属性： WaterBackCmd:IS_USERID_ENABLED、 WaterBackCmd:IS_CUSTOMTEXT_ENABLED、 WaterBackCmd:OPACITY和 WaterBackCmd:SRCTEXT。尽管您要修改的唯一属性 WaterBackCmd:OPACITY是，但必须设置其他值。

注意

使用Java API修改水印时，无需指定所有属性。设置要修改的水印属性。

注意

有关水印属性名称的信息，请参阅创建水印。

更新水印

修改水印属性后，必须更新水印。

另请参阅

创建水印

使用Java API修改水印

使用文档安全API(Java)修改水印：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档安全客户端API对象。
- 创建包 ServiceClientFactory 含连接属性的对象。
- 使用对 DocumentSecurityClient 象的构造函数并传递该对 ServiceClientFactory 象。
检索要修改的水印。

通过调 WatermarkManager 用对象的方 DocumentSecurityClient 法创建对 getWatermarkManager 象，并传递指定水印名称的字符串值。此方法返回 Watermark 表示要修改的水印的对象。
设置水印属性。

通过调用对象的方法并传递指定不 Watermark 透明度级 setOpacity 别的整数值，设置水印的不透明度属性。值100表示水印完全不透明，值0表示水印完全透明。

注意

此示例仅修改不透明度属性。
更新水印。
- 通过调用对象的方 WatermarkManager 法更新水 updateWatermark 印，并传递 Watermark 其属性已修改的对象。

代码示例

有关使用文档安全服务的代码示例，请参阅快速开始（SOAP模式）: 使用Java API部分修改水印。

使用Web服务API修改水印

使用文档安全API（Web服务）修改水印：

包括项目文件。

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象。
- 使用对象 DocumentSecurityServiceClient 的默认构造函数创建对象。
- 使用构 RightsManagementServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/DocumentSecurityService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 DocumentSecurityServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
检索要修改的水印。

通过调用对象的方法检索要 DocumentSecurityServiceClient 修改的水 getWatermarkByName 印。传递指定水印名称的字符串值。此方法返回 WatermarkSpec 表示要修改的水印的对象。
设置水印属性。
- 对于要更新的每个水印属性，创建一个单独的 MyMapOf_xsd_string_To_xsd_anyType_Item 对象。
- 通过为对象的数据成员 MyMapOf_xsd_string_To_xsd_anyType_Item 分配值 key 来设置键值(例如 WaterBackCmd:OPACITY)。
- 通过为对象的数据成员 MyMapOf_xsd_string_To_xsd_anyType_Item 分配值 value 来设置值(例如 .50)。
- 创建对 MyArrayOf_xsd_anyType 象。对于每 MyMapOf_xsd_string_To_xsd_anyType_Item 个对象，调 MyArrayOf_xsd_anyType 用对象的方 Add 法。传递对 MyMapOf_xsd_string_To_xsd_anyType_Item 象。
- 将对 MyArrayOf_xsd_anyType 象指定 WatermarkSpec 给对象的数 values 据成员。
更新水印。

通过调用对象的方 DocumentSecurityServiceClient 法并传 updateWatermark 递表示要修改 WatermarkSpec 的水印的对象来更新水印。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API修改水印»

搜索事件

Rights Management服务会在特定操作发生时跟踪这些操作，如将策略应用于文档、打开受策略保护的文档以及撤销对文档的访问。必须为Rights Management服务启用事件审核，否则不跟踪事件。

事件属于以下类别之一：

管理员事件是与管理员相关的操作，如创建新的管理员帐户。
文档事件是与文档相关的操作，如关闭受策略保护的文档。
策略事件是与策略相关的操作，如创建新策略。
服务事件是与Rights Management服务相关的操作，如与用户目录同步。

您可以使用Rights Management Java API或Web服务API搜索指定事件。通过搜索事件，您可以执行任务，如创建某些事件的日志文件。

注意

有关Rights Management服务的详细信息，请参阅服务参考以了解AEM Forms。

步骤摘要

要搜索Rights Management事件，请执行以下步骤：

包括项目文件。
创建Rights Management Client API对象。
指定要搜索的事件。
搜索事件。

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建Rights Management客户端API对象

在以编程方式执行Rights Management服务操作之前，必须创建Rights Management服务客户端对象。如果您使用Java API，请创建一个 DocumentSecurityClient 对象。如果您使用Rights Management Web服务API，请创建一个对 DocumentSecurityServiceService 象。

指定要搜索的事件

必须指定要搜索的事件。例如，您可以搜索策略创建事件，创建新策略时即发生此情况。

搜索事件

在指定要搜索的事件后，可以使用Rights Management Java API或Rights Management Web服务API搜索事件。

另请参阅

使用Java API搜索事件

使用Rights Management API(Java)搜索事件:

包括项目文件

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建Rights Management客户端API对象

使用对 DocumentSecurityClient 象的构造函数并传递包含连接属 ServiceClientFactory 性的对象，创建对象。
指定要搜索的事件
- 通过调 EventManager 用对象的方 DocumentSecurityClient 法创建 getEventManager 对象。此方法返回一个 EventManager 对象。
- 通过调 EventSearchFilter 用对象的构造函数创建对象。
- 通过调用对象的方法并传递属 EventSearchFilter 于表示要搜 setEventCode 索的事件的类的静态数据成员，指 EventManager 定要搜索的事件。例如，要搜索策略创建事件，请传递 EventManager.POLICY_CREATE_EVENT。
注意

可以通过调用对象方法来定义其 EventSearchFilter 他搜索条件。例如，调用方 setUserName 法以指定与事件关联的用户。
搜索事件

通过调用对象的方 EventManager 法并传 searchForEvents 递定义事件 EventSearchFilter 搜索条件的对象来搜索事件。此方法返回一组对 Event 象。

代码示例

有关使用Rights Management服务的代码示例，请参阅以下快速开始:

“快速开始(SOAP): 使用Java API搜索事件”

使用Web服务API搜索事件

使用Rights Management API（Web服务）搜索事件:

包括项目文件

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建Rights Management客户端API对象
- 使用对象 DocumentSecurityServiceClient 的默认构造函数创建对象。
- 使用构 DocumentSecurityServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 DocumentSecurityServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。

指定要搜索的事件

使用对 EventSpec 象的构造函数创建对象。
通过设置对象的数据成员实例，指定发生开始 EventSpec 的时间 firstTime.date 段的事件，该 DataTime 实例表示发生事件的日期范围的开始。
为对象 true 的数 EventSpec 据成员指 firstTime.dateSpecified 定值。
通过设置对象的事件成员实例，指 EventSpec 定发生 lastTime.date 的时 DataTime 间段的结束时间，该实例表示发生事件的日期范围的结束时间。
为对象 true 的数 EventSpec 据成员指 lastTime.dateSpecified 定值。
通过为对象的事件成员分配字符串值来 EventSpec 设置要搜 eventCode 索的。下表列表了可分配给此属性的数值：

事件类型	值
`ALL_EVENTS`	999
`USER_CHANGE_PASSWORD_EVENT`	1000
`USER_REGISTER_EVENT`	1001
`USER_PREREGISTER_EVENT`	1002
`USER_ACTIVATE_EVENT`	1003
`USER_DEACTIVATE_EVENT`	1004
`USER_AUTHENTICATE_EVENT`	1005
`USER_AUTHENTICATE_DENY_EVENT`	1006
`USER_ACCOUNT_LOCK_EVENT`	1007
`USER_DELETE_EVENT`	1008
`USER_UPDATE_PROFILE_EVENT`	1009
`DOCUMENT_VIEW_EVENT`	2000
`DOCUMENT_PRINT_LOW_EVENT`	2001
`DOCUMENT_PRINT_HIGH_EVENT`	2002
`DOCUMENT_SIGN_EVENT`	2003
`DOCUMENT_ADD_ANNOTATION_EVENT`	2004
`DOCUMENT_FORM_FILL_EVENT`	2005
`DOCUMENT_CLOSE_EVENT`	2006
`DOCUMENT_MODIFY_EVENT`	2007
`DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT`	2008
`DOCUMENT_SWITCH_POLICY_EVENT`	2009
`DOCUMENT_REVOKE_EVENT`	2010
`$1`	2011
`DOCUMENT_SECURE_EVENT`	2012
`DOCUMENT_UNKNOWN_CLIENT_EVENT`	2013
`DOCUMENT_CHANGE_REVOKE_URL_EVENT`	2014
`POLICY_CHANGE_EVENT`	3000
`POLICY_ENABLE_EVENT`	3001
`POLICY_DISABLE_EVENT`	3002
`POLICY_CREATE_EVENT`	3003
`POLICY_DELETE_EVENT`	3004
`POLICY_CHANGE_OWNER_EVENT`	3005
`SERVER_CLIENT_SYNC_EVENT`	4000
`SERVER_SYNC_DIR_INFO_EVENT`	4001
`SERVER_SYNC_DIR_COMPLETE_EVENT`	4002
`SERVER_VERSION_MISMATCH_EVENT`	4003
`SERVER_CONFIG_CHANGE_EVENT`	4004
`SERVER_ENABLE_OFFLINE_ACCESS_EVENT`	4005
`ADMIN_ADD_EVENT`	5000
`ADMIN_DELETE_EVENT`	5001
`ADMIN_EDIT_EVENT`	5002
`ADMIN_ACTIVATE_EVENT`	5003
`ADMIN_DEACTIVATE_EVENT`	5004
`ERROR_DIRECTORY_SERVICE_EVENT`	6000
`CREATED_POLICYSET_EVENT`	7000
`DELETED_POLICYSET_EVENT`	7001
`MODIFIED_POLICYSET_EVENT`	7002

搜索事件

通过调用对象的方 DocumentSecurityServiceClient 法并传递 searchForEvents 表示要搜索 EventSpec 的事件和最大结果数的事件的对象来搜索。此方法返回一个 MyArrayOf_xsd_anyType 集合，其中每个元素都是 AuditSpec 一个实例。使用 AuditSpec 实例，您可以获取有关事件的信息，如发生时间。实 AuditSpec 例包含指定 timestamp 此信息的数据成员。

代码示例

有关使用Rights Management服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API搜索事件"
“快速开始(SwaRef): 使用Web服务API搜索事件"

另请参阅

将策略应用于Word文档

除PDF文档外，权限管理服务还支持其他文档格式，如Microsoft Word文档（DOC文件）和其他Microsoft office文件格式。例如，您可以将策略应用于Word文档以保护它。通过将策略应用于Word文档，可以限制对文档的访问。如果文档已使用策略保护，则不能对文档应用策略。

在分发受策略保护的Word文档后，可以监视其使用情况。即，您可以看到文档的使用方式以及使用者。例如，您可以查找某人何时打开文档。

注意

有关文档安全服务的详细信息，请参阅AEM Forms服务参考。

步骤摘要

要将策略应用于Word文档，请执行以下步骤：

包括项目文件。
创建文档安全客户端API对象。
检索应用策略的Word文档。
将现有策略应用于Word文档。
保存受策略保护的Word文档。

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建文档安全客户端API对象

在以编程方式执行文档安全服务操作之前，必须创建文档安全服务客户端对象。

检索Word文档

必须检索Word文档才能应用策略。对Word文档应用策略后，用户在使用文档时受到限制。例如，如果策略未启用脱机时文档的打开，则用户必须联机才能打开文档。

将现有策略应用于Word文档

要将策略应用于Word文档，必须引用现有策略并指定策略所属的策略集。设置连接属性的用户必须有权访问指定的策略。否则，会出现异常。

保存Word文档

在文档安全服务将策略应用于Word文档后，可以将受策略保护的Word文档另存为DOC文件。

另请参阅

撤销对文档的访问

使用Java API将策略应用于Word文档

使用文档安全API(Java)将策略应用于Word文档:

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档安全客户端API对象。
- 创建包 ServiceClientFactory 含连接属性的对象。
- 使用对 DocumentSecurityClient 象的构造函数并传递该对 ServiceClientFactory 象。
检索Word文档。
- 通过 java.io.FileInputStream 使用Word文档的构造函数并传递一个指定Word文档位置的字符串值，创建一个表示Word的对象。
- 使用对 com.adobe.idp.Document 象的构造函数并传递该对 java.io.FileInputStream 象。
将现有策略应用于Word文档。
- 通过 DocumentManager 调用对象的 DocumentSecurityClient 方法创建 getDocumentManager 对象。
- 通过调用对象的方法并传递以 DocumentManager 下值， protectDocument 将策略应用于Word文档:
  - 包 com.adobe.idp.Document 含应用策略的Word文档的对象。
  - 一个字符串值，它指定文档的名称。
  - 一个字符串值，它指定策略所属的策略集的名称。您可以指定 null 导致使用策 MyPolicies 略集的值。
  - 指定策略名称的字符串值。
  - 一个字符串值，它表示作为文档发布者的用户的用户管理器域的名称。此参数值是可选的，可以为null（如果此参数为null，则下一个参数值必须为null）。
  - 一个字符串值，它表示作为文档发布者的用户管理器用户的规范名称。此参数值是可选的，可 null 以是(如果此参数 null为，则前一个参数值必须 null是)。
  - 表 com.adobe.livecycle.rightsmanagement.Locale 示用于选择MS Office模板的区域设置。此参数值是可选的，您可以指定 null。
  该方 protectDocument 法返回 RMSecureDocumentResult 一个包含受策略保护的Word文档的对象。
保存Word文档。
- 调用对 RMSecureDocumentResult 象的方 getProtectedDoc 法以获取受策略保护的Word文档。此方法返回一个 com.adobe.idp.Document 对象。
- 创建对 java.io.File 象并确保文件扩展名为DOC。
- 调用 com.adobe.idp.Document 对象的方 copyToFile 法，将对象的内容复制到文件 Document 中(确保使用该方 Document 法返回的 getProtectedDoc 对象)。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

"快速开始（SOAP模式）: 使用Java API将策略应用于Word文档”

使用Web服务API将策略应用于Word文档

使用文档安全API（Web服务）将策略应用于Word文档:

包括项目文件。

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象。
- 使用对象 DocumentSecurityServiceClient 的默认构造函数创建对象。
- 使用构 DocumentSecurityServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/DocumentSecurityService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 DocumentSecurityServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
检索Word文档。
- 使用对 BLOB 象的构造函数创建对象。对 BLOB 象用于存储应用策略的Word文档。
- 通过调 System.IO.FileStream 用对象的构造函数并传递一个字符串值来创建对象，该字符串值表示Word文档的文件位置以及打开文件的模式。
- 创建存储对象内容的字节数 System.IO.FileStream 组。通过获取对象的属性来确 System.IO.FileStream 定字节数组 Length 大小。
- 通过调用对象的方法，用流数 System.IO.FileStream 据填充字节 Read 数组。传递要读取的字节数组、开始位置和流长度。
- 通过 BLOB 为对象的字段 MTOM 指定字节数组的内容来填充对象。
将现有策略应用于Word文档。

通过调用对象的方法并传递以 DocumentSecurityServiceClient 下值， protectDocument 将策略应用于Word文档:
- 包 BLOB 含应用策略的Word文档的对象。
- 一个字符串值，它指定文档的名称。
- 一个字符串值，它指定策略所属的策略集的名称。您可以指定 null 导致使用策 MyPolicies 略集的值。
- 指定策略名称的字符串值。
- 一个字符串值，它表示作为文档发布者的用户的用户管理器域的名称。此参数值是可选的，可以为null(如果此参数为null，则下一个参数值必须 null为)。
- 一个字符串值，它表示作为文档发布者的用户管理器用户的规范名称。此参数值是可选的，可以为null(如果此参数为null，则前一个参数值必须 null为)。
- 一 RMLocale 个值，它指定区域设置值(例如 RMLocale.en)。
- 用于存储策略标识符值的字符串输出参数。
- 用于存储受策略保护的标识符值的字符串输出参数。
- 用于存储mime类型的字符串输出参数(例如 application/doc)。
该方 protectDocument 法返回 BLOB 一个包含受策略保护的Word文档的对象。
保存Word文档。
- 通过调 System.IO.FileStream 用其构造函数并传递一个字符串值来创建对象，该字符串值表示受策略保护的Word文档的文件位置。
- 创建一个字节数组，它存储由方 BLOB 法返回的对象的数据 protectDocument 内容。通过获取对象数据成员的值 BLOB 填充字节 MTOM 数组。
- 通过调 System.IO.BinaryWriter 用对象的构造函数并传递该对 System.IO.FileStream 象来创建。
- 通过调用对象的方法并传递字节数组，将字 System.IO.BinaryWriter 节数组的 Write 内容写入Word文件。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API将策略应用于Word文档”

从Word文档删除策略

您可以从受策略保护的Word文档中删除策略，以便从文档中删除安全性。也就是说，如果您不再希望文档受策略保护。如果要使用较新的策略更新受策略保护的Word文档，则切换策略比删除策略和添加更新的策略更有效。

注意

有关文档安全服务的详细信息，请参阅AEM Forms服务参考。

步骤摘要

要从受策略保护的Word文档中删除策略，请执行以下步骤：

包括项目文件
创建文档安全客户端API对象。
检索受策略保护的Word文档。
从Word文档中删除策略。
保存不安全的Word文档

包括项目文件

将必要的文件包含在您的开发项目中。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建文档安全客户端API对象

在以编程方式执行文档安全服务操作之前，请创建文档安全服务客户端对象。

检索受策略保护的Word文档

必须检索受策略保护的Word文档才能删除策略。如果尝试从未受策略保护的Word文档中删除策略，将引起异常。

从Word文档中删除策略

可以从受策略保护的Word文档中删除策略，前提是在连接设置中指定了管理员。否则，用于保护文档的策略必须包含该权 SWITCH_POLICY 限，才能从Word文档中删除策略。此外，在AEM Forms连接设置中指定的用户也必须具有该权限。否则，将引发异常。

保存不安全的Word文档

在文档安全服务从Word文档中删除策略后，可以将不安全的Word文档另存为DOC文件。

另请参阅

将策略应用于Word文档

使用Java API从Word文档中删除策略

使用文档安全API(Java)从受策略保护的Word文档中删除策略：

包括项目文件

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档安全客户端API对象
- 创建包 ServiceClientFactory 含连接属性的对象。
- 使用对 RightsManagementClient 象的构造函数并传递该对 ServiceClientFactory 象。
检索受策略保护的Word文档
- 创建一 java.io.FileInputStream 个对象，它使用其构造函数并传递一个指定Word文档位置的字符串值来表示受策略保护的Word文档。
- 使用对 com.adobe.idp.Document 象的构造函数并传递该对 java.io.FileInputStream 象。
从Word文档中删除策略
- 通过 DocumentManager 调用对象的 RightsManagementClient 方法创建 getDocumentManager 对象。
- 通过调用对象的方法并传递包含受策 DocumentManager 略保护的Word文档 removeSecurity 的对象， com.adobe.idp.Document 从Word文档中删除策略。此方法返回一 com.adobe.idp.Document 个对象，它包含不安全的Word文档。
保存不安全的Word文档
- 创建对 java.io.File 象并确保文件扩展名为DOC。
- 调用 Document 对象的方 copyToFile 法，将对象的内容复制到文件 Document 中(确保使用该方 Document 法返回的 removeSecurity 对象)。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

"快速开始（SOAP模式）: 使用Java API从Word文档删除策略”

使用Web服务API从Word文档中删除策略

使用文档安全API（Web服务）从受策略保护的Word文档中删除策略：

包括项目文件

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义： http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

注意

替换 localhost 为承载AEM Forms的服务器的IP地址。
创建文档安全客户端API对象
- 使用对象 RightsManagementServiceClient 的默认构造函数创建对象。
- 使用构 RightsManagementServiceClient.Endpoint.Address 造函数创建 System.ServiceModel.EndpointAddress 对象。将指定WSDL的字符串值传递给AEM Forms服务(例如 http://localhost:8080/soap/services/RightsManagementService?WSDL。) 您无需使用该属 lc_version 性。此属性在您创建服务引用时使用。)
- 通过获 System.ServiceModel.BasicHttpBinding 取字段的值创建对 RightsManagementServiceClient.Endpoint.Binding 象。将返回值转换为 BasicHttpBinding。
- 将对 System.ServiceModel.BasicHttpBinding 象的字段 MessageEncoding 设置为 WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 将AEM表单用户名分配给字段 RightsManagementServiceClient.ClientCredentials.UserName.UserName。
  - 为字段分配相应的口令值 RightsManagementServiceClient.ClientCredentials.UserName.Password。
  - 为字段指 HttpClientCredentialType.Basic 定常量值 BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 为字段指 BasicHttpSecurityMode.TransportCredentialOnly 定常量值 BasicHttpBindingSecurity.Security.Mode。
检索受策略保护的Word文档
- 使用对 BLOB 象的构造函数创建对象。该 BLOB 对象用于存储从中删除策略的受策略保护的Word文档。
- 通过调 System.IO.FileStream 用对象的构造函数并传递一个字符串值来创建对象，该字符串值表示Word文档的文件位置以及打开文件的模式。
- 创建存储对象内容的字节数 System.IO.FileStream 组。您可以通过获取对象的属性来确定字 System.IO.FileStream 节数组的大 Length 小。
- 通过调用对象的方法并传递要读取 System.IO.FileStream 的字节数 Read 组、开始位置和流长度，用流数据填充字节数组。
- 通过 BLOB 为对象的字段 MTOM 指定字节数组的内容来填充对象。
从Word文档中删除策略

通过调用对象的方法并传递包含受策 RightsManagementServiceClient 略保护的Word文档 removePolicySecurity 的对象， BLOB 从Word文档中删除策略。此方法返回一 BLOB 个对象，它包含不安全的Word文档。
保存不安全的Word文档
- 通过调 System.IO.FileStream 用对象的构造函数并传递一个字符串值来创建对象，该字符串值表示不安全Word文档的文件位置。
- 创建一个字节数组，它存储由方 BLOB 法返回的对象的数据 removePolicySecurity 内容。通过获取对象字段的值 BLOB 填充字节数 MTOM 组。
- 通过调 System.IO.BinaryWriter 用对象的构造函数并传递该对 System.IO.FileStream 象来创建。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速开始:

“快速开始(MTOM): 使用Web服务API从Word文档删除策略”

另请参阅