使用策略保护文档

撤消对文档的访问

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

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

包括项目文件。

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

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

“快速启动（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 方法和传递以下值：
- 的 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 对象。
- 通过调用 System.IO.BinaryWriter 对象 Write 方法和传递字节数组。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

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

从PDF文档中删除策略

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

注意

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

步骤摘要

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

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

包含项目文件

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

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

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

检索受策略保护的PDF文档

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

从PDF文档中删除策略

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

保存不安全的PDF文档

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

另请参阅

将策略应用于PDF文档

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

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

包括项目文件。

将客户端JAR文件（如adobe-rightsmanagement-client.jar）包含在您Java项目的类路径中。
创建文档安全客户端API对象。
- 创建 ServiceClientFactory 包含连接属性的对象。
- 创建 DocumentSecurityClient 对象，并使用其构造函数进行传递 ServiceClientFactory 对象。
检索受策略保护的PDF文档。
- 创建 java.io.FileInputStream 对象，该对象通过使用其构造函数并传递指定PDF文档位置的字符串值来表示受策略保护的PDF文档。
- 创建 com.adobe.idp.Document 对象，并使用其构造函数进行传递 java.io.FileInputStream 对象。
从PDF文档中删除策略。
- 创建 DocumentManager 对象 DocumentSecurityClient 对象 getDocumentManager 方法。
- 通过调用 DocumentManager 对象 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 对象 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。当您撤消对文档的访问权时，更改将在用户下次与文档安全服务同步时生效，方法是联机打开受策略保护的文档。

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

注意

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

步骤摘要

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

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

包含项目文件

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

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

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

检索受策略保护的PDF文档

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

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

撤消受策略保护的文档

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

注意

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

另请参阅

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

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

包含项目文件

将客户端JAR文件（如adobe-rightsmanagement-client.jar）包含在您Java项目的类路径中。
创建文档安全客户端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.

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

“快速入门（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地址。
创建文档安全客户端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.

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

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

另请参阅

从Word文档中删除策略

恢复对已吊销文档的访问

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

注意

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

步骤摘要

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

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

包含项目文件

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

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

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

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

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

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

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

另请参阅

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

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

包括项目文件。

将客户端JAR文件（如adobe-rightsmanagement-client.jar）包含在您Java项目的类路径中。
创建文档安全客户端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 方法和传递被吊销文档的许可证标识符值。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

“快速入门（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 表示已吊销文档的对象。此方法会返回表示许可证标识符的字符串值。
- 通过调用 DocumentSecurityServiceClient 对象 unrevokeLicense 方法，并传递指定已吊销PDF文档的许可证标识符值的字符串值(传递 DocumentSecurityServiceClient 对象 getLicenseId 方法)。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

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

另请参阅

检查受策略保护的PDF文档

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

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

注意

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

步骤摘要

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

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

包含项目文件

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

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

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

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

要检查受策略保护的文档，请检索该文档。如果您尝试检查未使用策略进行安全保护的文档或该文档已被撤消，则会引发异常。

Inspect文档

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

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

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

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

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

另请参阅

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

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

包括项目文件。

将客户端JAR文件（如adobe-rightsmanagement-client.jar）包含在您Java项目的类路径中。有关这些文件位置的信息，请参阅包括AEM Forms Java库文件.
创建文档安全客户端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 方法。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

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

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

Inspect使用Document Security Service 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 字段中，显示字节数组的内容。
Inspect文档。

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

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

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

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

另请参阅

创建水印

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

注意

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

注意

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

步骤摘要

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

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

包含项目文件

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

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

设置水印属性

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

自定义文本
DateIncluded
UserIdIncluded
UserNameIncluded

下表列出了使用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)创建水印：

包括项目文件。

包括客户端JAR文件，如 adobe-rightsmanagement-client.jar，位于您的Java项目的类路径中。
创建文档安全客户端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文档不会受到影响。

注意

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

注意

有关Document Security服务的详细信息，请参阅 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)修改水印：

包括项目文件。

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

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

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

注意

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

代码示例

有关使用文档安全服务的代码示例，请参阅快速入门（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地址。
创建文档安全客户端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 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)搜索事件：

包含项目文件

将客户端JAR文件（如adobe-rightsmanagement-client.jar）包含在您Java项目的类路径中。
创建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文件）和其他Micosoft办公室文件格式。例如，您可以将策略应用于Word文档以保护其安全。通过将策略应用于Word文档，可以限制对文档的访问。如果文档已使用策略进行了保护，则不能将策略应用于该文档。

在分发受策略保护的Word文档后，您可以对其使用情况进行监控。也就是说，您可以查看文档的使用方式以及使用者。例如，您可以了解某人何时打开了文档。

注意

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

步骤摘要

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

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

包含项目文件

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

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

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

检索Word文档

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

将现有策略应用于Word文档

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

保存Word文档

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

另请参阅

撤消对文档的访问

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

使用文档安全API(Java)将策略应用到Word文档：

包括项目文件。

将客户端JAR文件（如adobe-rightsmanagement-client.jar）包含在您Java项目的类路径中。
创建文档安全客户端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)。
  - 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 方法)。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

“快速入门（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 方法和传递以下值：
- 的 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 方法和传递字节数组。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

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

从Word文档中删除策略

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

注意

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

步骤摘要

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

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

包含项目文件

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

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

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

检索受策略保护的Word文档

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

从Word文档中删除策略

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

保存不安全的Word文档

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

另请参阅

对Word文档应用策略

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

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

包含项目文件

将客户端JAR文件（如adobe-rightsmanagement-client.jar）包含在您Java项目的类路径中。
创建文档安全客户端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 方法)。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

“快速入门（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 对象 removePolicySecurity 方法和通过 BLOB 包含受策略保护的Word文档的对象。此方法将返回 BLOB 包含不安全的Word文档的对象。
保存不安全的Word文档
- 创建 System.IO.FileStream 对象，方法是调用其构造函数并传递一个字符串值，该字符串值表示不安全Word文档的文件位置。
- 创建用于存储 BLOB 由返回的对象 removePolicySecurity 方法。通过获取 BLOB 对象 MTOM 字段。
- 创建 System.IO.BinaryWriter 对象，方法是调用其构造函数并传递 System.IO.FileStream 对象。

代码示例

有关使用文档安全服务的代码示例，请参阅以下快速入门：

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

另请参阅