使用策略保护文档

撤销对文档的访问权限

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

使用Document Security API (Java)将策略应用于PDF文档：

包括项目文件。

在您的Java项目的类路径中包含客户端JAR文件，例如adobe-rightsmanagement-client.jar。
创建Document Security客户端API对象。
- 创建 ServiceClientFactory 包含连接属性的对象。
- 创建 RightsManagementClient 对象，使用它的构造函数传递 ServiceClientFactory 对象。
检索PDF文档。
- 创建 java.io.FileInputStream 使用构造函数表示PDF文档的对象。传递一个指定PDF文档位置的字符串值。
- 创建 com.adobe.idp.Document 对象，使用它的构造函数传递 java.io.FileInputStream 对象。
将现有策略应用于PDF文档。
- 创建 DocumentManager 对象，方法是调用 RightsManagementClient 对象的 getDocumentManager 方法。
- PDF通过调用 DocumentManager 对象的 protectDocument 方法并传递以下值：
  - 此 com.adobe.idp.Document 包含应用策略的PDF文档的对象。
  - 指定文档名称的字符串值。
  - 一个字符串值，它指定策略所属的策略集的名称。您可以指定 null 导致出现以下问题的值： MyPolicies 正在使用的策略集。
  - 指定策略名称的字符串值。
  - 一个字符串值，表示作为文档发布者的用户的用户管理器域的名称。此参数值是可选的，并且可以为null（如果此参数为null，则下一个参数值必须为null）。
  - 一个字符串值，表示作为文档发布者的用户管理员用户的规范名称的名称。此参数值是可选的，可以为 null (如果此参数为null，则前一个参数值必须为 null)。
  - A 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 方法)。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门（EJB模式）：使用Java API将策略应用到PDF文档”
“快速入门（SOAP模式）：使用Java API将策略应用于PDF文档”

另请参阅

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

使用Document Security API（Web服务）将策略应用于PDF文档：

包括项目文件。

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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文档。

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

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API将策略应用到PDF文档”
“快速入门(SwaRef)：使用Web服务API将策略应用于PDF文档”

从PDF文档中删除策略

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

注意

有关Document Security服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Document Security客户端API对象

在以编程方式执行Document Security服务操作之前，请先创建Document Security服务客户端对象。

检索受策略保护的PDF文档

您可以检索受策略保护的PDF文档以删除策略。如果尝试从不受策略保护的PDF文档中删除策略，则会导致异常。

从PDF文档中删除策略

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

保存不安全的PDF文档

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

另请参阅

将策略应用于PDF文档

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

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

包括项目文件。

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

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门（SOAP模式）：使用Java API从PDF文档中删除策略”

使用Web服务API删除策略

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

包括项目文件。

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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文档中删除策略。

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

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API从PDF文档中删除策略”
“快速入门(SwaRef)：使用Web服务API从PDF文档中删除策略”

另请参阅

撤销对文档的访问权限

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

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

注意

有关Document Security服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Document Security客户端API对象

您必须先创建Document Security服务客户端对象，然后才能以编程方式执行Document Security服务操作。

检索受策略保护的PDF文档

检索受策略保护的PDF文档以撤销它。您无法撤销已撤销或不是受策略保护文档的文档。

如果您知道受策略保护文档的license identifier值，则不必检索受策略保护的PDF文档。但是，在大多数情况下，必须检索PDF文档以获得许可证标识符值。

撤销受策略保护的文档

要撤销受策略保护的文档，请指定受策略保护文档的许可证标识符。此外，您可以指定用户尝试打开撤消文档时可以查看的文档URL。也就是说，假定已过期的文档被撤销。当用户尝试打开撤消的文档时，他们将看到更新的文档而不是撤消的文档。

注意

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

另请参阅

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

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

包含项目文件

在您的Java项目的类路径中包含客户端JAR文件，例如adobe-rightsmanagement-client.jar。
创建Document Security客户端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 指定撤销文档的原因的接口。例如，您可以指定 License.DOCUMENT_REVISED.
  - A java.net.URL 指定修订文档所在位置的值。如果您不想将用户重定向到其他URL，则可以传递 null.

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门（SOAP模式）：使用Java API撤销文档”

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

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

包含项目文件

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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 指定撤销文档原因的枚举。例如，您可以指定 Reason.DOCUMENT_REVISED.
  - A string 值，指定修订文档所在的URL位置。如果您不想将用户重定向到其他URL，则可以传递 null.

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API撤销文档”
“快速入门(SwaRef)：使用Web服务API撤销文档”

另请参阅

从Word文档中删除策略

恢复对已撤消文档的访问

您可以恢复对已撤销PDF文档的访问，从而使用户能够访问已撤销文档的所有副本。当用户打开已撤销的恢复文档时，用户能够查看文档。

注意

有关Document Security服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Document Security客户端API对象

您必须先创建Document Security服务客户端对象，然后才能以编程方式执行Document Security服务操作。如果您使用的是Java API，请创建 DocumentSecurityClient 对象。如果您使用的是Document Security Web服务API，请创建 DocumentSecurityServiceService 对象。

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

检索已撤销PDF文档的许可证标识符以恢复已撤销PDF文档。获取许可证标识符值后，您可以恢复已撤消的文档。如果尝试恢复未撤消的文档，则会导致异常。

恢复对已撤销PDF文档的访问

要恢复对已撤销PDF文档的访问，必须指定已撤销文档的许可证标识符。如果尝试恢复对未撤消的PDF文档的访问，则会导致出现异常。

另请参阅

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

使用Document Security API (Java)恢复对已撤销文档的访问：

包括项目文件。

在您的Java项目的类路径中包含客户端JAR文件，例如adobe-rightsmanagement-client.jar。
创建Document Security客户端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 方法。
- 通过调用，恢复对已撤销PDF文档的访问 LicenseManager 对象的 unrevokeLicense 方法和传递撤销文档的许可证标识符值。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门（SOAP模式）：使用Web服务API恢复对已吊销文档的访问”

使用Web服务API恢复对已撤消文档的访问

使用Document Security API（Web服务）恢复对已撤销文档的访问：

包括项目文件。

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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 方法和传递指定已撤销PDF文档的许可证标识符值的字符串值(传递 DocumentSecurityServiceClient 对象的 getLicenseId 方法)。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API恢复对已吊销文档的访问”
“快速入门(SwaRef)：使用Web服务API恢复对已吊销文档的访问”

另请参阅

检查受策略保护的PDF文档

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

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

注意

有关Document Security服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Document Security客户端API对象

在以编程方式执行Document Security服务操作之前，请先创建Document Security服务客户端对象。如果您使用的是Java API，请创建 RightsManagementClient 对象。如果您使用的是Document Security Web服务API，请创建 RightsManagementServiceService 对象。

检索要检查的受策略保护的文档

要检查受策略保护的文档，请检索它。如果尝试检查未使用策略保护或撤消的文档，则会引发异常。

Inspect文档

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

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

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

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

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

另请参阅

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

使用Document Security Service API (Java)Inspect受策略保护的PDF文档：

包括项目文件。

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

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

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门（SOAP模式）：使用Java API检查受策略保护的PDF文档”

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

Inspect使用Document Security服务API（Web服务）创建受策略保护的PDF文档：

包括项目文件。

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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 包含字节数组内容的字段。
Inspect文档。

Inspect通过调用 RightsManagementServiceClient 对象的 inspectDocument 方法。传递 BLOB 包含受策略保护的PDF文档的对象。此方法会返回 RMInspectResult 包含有关受策略保护文档信息的对象。
获取有关受策略保护文档的信息。

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

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API检查受策略保护的PDF文档”
“快速入门(SwaRef)：使用Web服务API检查受策略保护的PDF文档”

另请参阅

创建水印

水印通过唯一地标识文档并控制版权侵权，帮助确保文档的安全。例如，您可以创建并放置一个水印，在文档的所有页面上显示“机密”。创建水印后，您可以将其包含在策略中。即，您可以使用新建的水印设置策略的水印属性。将包含水印的策略应用于文档后，水印将显示在受策略保护的文档中。

注意

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

注意

有关Document Security服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Document Security客户端API对象

设置水印属性

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

自定义文本
包含日期
UserIdInclude
UserNameInclude

下表列出了使用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`	指定水印的水平对齐方式。默认值为center。	左、中或右
`WaterBackCmd:VERT_ALIGN`	指定水印的垂直对齐方式。默认值为center。	顶部、中心或底部
`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

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

注册水印

新的水印必须先在Document Security服务中注册，然后才能使用。注册水印后，您可以在策略中使用该水印。

另请参阅

将策略应用于PDF文档

使用Java API创建水印

使用Document Security API (Java)创建水印：

包括项目文件。

包括客户端JAR文件，例如 adobe-rightsmanagement-client.jar，在Java项目的类路径中。
创建Document Security客户端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 表示要注册的水印的对象。此方法返回代表水印标识值的字符串值。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门（SOAP模式）：使用Java API创建水印”

使用Web服务API创建水印

使用Document Security API（Web服务）创建水印：

创建Document Security客户端API对象。

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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 表示要注册的水印的对象。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API创建水印”
“快速入门(SwaRef)：使用Web服务API创建水印”

另请参阅

修改水印

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

当您修改水印时，此更改将影响对其应用了水印的未来文档。也就是说，包含水印的现有PDF文档不受影响。

注意

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

注意

有关Document Security服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Document Security客户端API对象

检索要修改的水印

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

设置水印属性

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

注意

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

注意

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

更新水印

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

另请参阅

创建水印

使用Java API修改水印

使用Document Security API (Java)修改水印：

包括项目文件。

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

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

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

注意

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

代码示例

有关使用Document Security服务的代码示例，请参阅快速入门（SOAP模式）：使用Java API修改水印部分。

使用Web服务API修改水印

使用Document Security API（Web服务）修改水印：

包括项目文件。

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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 表示要修改的水印的对象。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API修改水印”

搜索事件

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

事件分为以下类别之一：

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

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

注意

有关Rights Management服务的详细信息，请参见 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Rights Management客户端API对象

必须先创建Rights Management服务客户端对象，然后才能以编程方式执行Rights Management服务操作。如果您使用的是Java API，请创建 DocumentSecurityClient 对象。如果您使用Rights ManagementWeb服务API，请创建 DocumentSecurityServiceService 对象。

指定要搜索的事件

指定要搜索的事件。例如，您可以搜索策略创建事件，该事件将在创建新策略时发生。

搜索事件

指定要搜索的事件后，可以使用Rights ManagementJava API或Rights ManagementWeb服务API来搜索该事件。

另请参阅

使用Java API搜索事件

使用Rights ManagementAPI (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 ManagementAPI（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文档后监视其使用情况。也就是说，您可以看到文档的使用方式以及谁在使用它。例如，您可以查找何时有人打开了文档。

注意

有关Document Security服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Document Security客户端API对象

您必须先创建Document Security服务客户端对象，然后才能以编程方式执行Document Security服务操作。

检索Word文档

检索Word文档以应用策略。将策略应用到Word文档后，用户使用文档时受到限制。例如，如果策略不允许在脱机时打开文档，则用户必须联机才能打开文档。

将现有策略应用到Word文档

要将策略应用到Word文档，必须引用现有策略并指定该策略属于哪个策略集。设置连接属性的用户必须具有对指定策略的访问权限。如果不存在，则会发生异常。

保存Word文档

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

另请参阅

撤销对文档的访问权限

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

使用Document Security API (Java)将策略应用到Word文档：

包括项目文件。

在您的Java项目的类路径中包含客户端JAR文件，例如adobe-rightsmanagement-client.jar。
创建Document Security客户端API对象。
- 创建 ServiceClientFactory 包含连接属性的对象。
- 创建 DocumentSecurityClient 对象，使用它的构造函数传递 ServiceClientFactory 对象。
检索Word文档。
- 创建 java.io.FileInputStream 通过使用其构造函数并传递指定Word文档位置的字符串值来表示Word文档的对象。
- 创建 com.adobe.idp.Document 对象，使用它的构造函数传递 java.io.FileInputStream 对象。
将现有策略应用到Word文档。
- 创建 DocumentManager 对象，方法是调用 DocumentSecurityClient 对象的 getDocumentManager 方法。
- 通过调用 DocumentManager 对象的 protectDocument 方法并传递以下值：
  - 此 com.adobe.idp.Document 包含应用策略的Word文档的对象。
  - 指定文档名称的字符串值。
  - 一个字符串值，它指定策略所属的策略集的名称。您可以指定 null 导致出现以下问题的值： MyPolicies 正在使用的策略集。
  - 指定策略名称的字符串值。
  - 一个字符串值，表示作为文档发布者的用户的用户管理器域的名称。此参数值是可选的，并且可以为null（如果此参数为null，则下一个参数值必须为null）。
  - 一个字符串值，表示作为文档发布者的用户管理员用户的规范名称的名称。此参数值是可选的，可以为 null (如果此参数为 null，则前一个参数值必须为 null)。
  - A 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 方法)。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门（SOAP模式）：使用Java API将策略应用到Word文档”

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

使用Document Security API（Web服务）将策略应用到Word文档：

包括项目文件。

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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 方法并传递以下值：
- 此 BLOB 包含应用策略的Word文档的对象。
- 指定文档名称的字符串值。
- 一个字符串值，它指定策略所属的策略集的名称。您可以指定 null 导致出现以下问题的值： MyPolicies 正在使用的策略集。
- 指定策略名称的字符串值。
- 一个字符串值，表示作为文档发布者的用户的用户管理器域的名称。此参数值为可选值，并且可以为null(如果此参数为null，则下一个参数值必须为 null)。
- 一个字符串值，表示作为文档发布者的用户管理员用户的规范名称的名称。此参数值是可选的，并且可以为null(如果此参数为null，则前一个参数值必须为 null)。
- A 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 和传递字节数组。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API将策略应用到Word文档”

从Word文档中删除策略

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

注意

有关Document Security服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要

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

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

包含项目文件

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

创建Document Security客户端API对象

在以编程方式执行Document Security服务操作之前，请先创建Document Security服务客户端对象。

检索受策略保护的Word文档

检索受策略保护的Word文档以删除策略。如果尝试从不受策略保护的Word文档中删除策略，则会导致异常。

从Word文档中删除策略

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

保存不安全的Word文档

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

另请参阅

将策略应用到Word文档

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

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

包含项目文件

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

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门（SOAP模式）：使用Java API从Word文档中删除策略”

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

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

包含项目文件

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

注意

替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。
创建Document Security客户端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 对象的 removePolicySecurity 方法和传递 BLOB 包含受策略保护的Word文档的对象。此方法会返回 BLOB 包含不安全Word文档的对象。
保存不安全的Word文档
- 创建 System.IO.FileStream 对象，方法是调用其构造函数并传递一个字符串值，该值表示不安全的Word文档的文件位置。
- 创建一个字节数组，用于存储 BLOB 返回的对象 removePolicySecurity 方法。通过获取的值，填充字节数组 BLOB 对象的 MTOM 字段。
- 创建 System.IO.BinaryWriter 对象通过调用其构造函数并传递 System.IO.FileStream 对象。

代码示例

有关使用Document Security服务的代码示例，请参阅以下快速入门：

“快速入门(MTOM)：使用Web服务API从Word文档中删除策略”

另请参阅