使用策略保护文档

撤销对文档的访问

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

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

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档 Security客户端API对象。
- 创建包含连接属性的ServiceClientFactory对象。
- 使用RightsManagementClient对象的构造函数并传递ServiceClientFactory对象，创建对象。
检索PDF文档。
- 使用PDF文档的构造函数创建一个java.io.FileInputStream对象。传递一个指定PDF文档位置的字符串值。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。
将现有策略应用于PDF文档。
- 通过调用RightsManagementClient对象的getDocumentManager方法创建DocumentManager对象。
- 通过调用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对象的内容复制到文件（请确保使用由getProtectedDoc方法返回的Document对象）。

代码示例

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

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

另请参阅

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

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

包括项目文件。

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建文档 Security客户端API对象。
- 使用RightsManagementServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建RightsManagementServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给Forms服务（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取RightsManagementServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段RightsManagementServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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文档的文件位置。
- 创建一个字节数组，用于存储protectDocument方法返回的BLOB对象的数据内容。通过获取BLOB对象的MTOM数据成员的值来填充字节数组。
- 通过调用其构造函数并传递System.IO.FileStream对象，创建System.IO.BinaryWriter对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

代码示例

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

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

从PDF文档删除策略

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

注意

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

步骤的摘要

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

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

包括项目文件

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

创建文档 Security客户端API对象

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

检索受策略保护的PDF文档

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

从PDF文档中删除策略

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

保存不安全的PDF文档

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

另请参阅

将策略应用于PDF文档

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

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

包括项目文件。

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

代码示例

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

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

使用Web服务API删除策略

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

包括项目文件。

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建文档 Security客户端API对象。
- 使用DocumentSecurityServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建DocumentSecurityServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取DocumentSecurityServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段DocumentSecurityServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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方法并传递包含受策略保护的PDF文档的BLOB对象，从PDF文档中删除策略。此方法返回一个BLOB对象，它包含一个不安全的PDF文档。
保存不安全的PDF文档。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值来创建对象，该字符串值表示不安全PDF文档的文件位置。
- 创建一个字节数组，用于存储removePolicySecurity方法返回的BLOB对象的数据内容。通过获取BLOB对象的MTOM字段的值来填充字节数组。
- 通过调用其构造函数并传递System.IO.FileStream对象，创建System.IO.BinaryWriter对象。

代码示例

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

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

另请参阅

撤销对文档的访问

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

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

注意

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

步骤的摘要

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

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

包括项目文件

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

创建文档 Security客户端API对象

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

检索受策略保护的PDF文档

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

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

撤销受策略保护的文档

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

注意

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

另请参阅

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

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

包括项目文件

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

代码示例

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

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

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

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

包括项目文件

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建文档 Security客户端API对象
- 使用DocumentSecurityServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建DocumentSecurityServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取DocumentSecurityServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段DocumentSecurityServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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。
  - 一个string值，它指定修订文档所在的URL位置。如果您不希望将用户重定向到其他URL，则可以传递null。

代码示例

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

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

另请参阅

从Word文档删除策略

恢复对已吊销文档的访问

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

注意

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

步骤的摘要

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

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

包括项目文件

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

创建文档 Security客户端API对象

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

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

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

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

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

另请参阅

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

通过使用文档 Security API(Java)恢复对已吊销文档的访问：

包括项目文件。

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

代码示例

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

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

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

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

包括项目文件。

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建文档 Security客户端API对象。
- 使用DocumentSecurityServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建DocumentSecurityServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取DocumentSecurityServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段DocumentSecurityServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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文档的访问，该字符串值指定已吊销PDF文档的许可证标识符值（传递DocumentSecurityServiceClient对象的getLicenseId方法的返回值）。

代码示例

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

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

另请参阅

检查受策略保护的PDF文档

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

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

注意

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

步骤的摘要

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

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

包括项目文件

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

创建文档 Security客户端API对象

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

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

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

Inspect 文档

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

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

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

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

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

另请参阅

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

Inspect是一个受策略保护的PDF文档，它使用文档 Security Service API(Java):

包括项目文件。

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

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

代码示例

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

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

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

Inspect是一个受策略保护的PDF文档，它使用文档 Security Service API（Web服务）：

包括项目文件。

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建文档 Security客户端API对象。
- 使用RightsManagementServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建RightsManagementServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取RightsManagementServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段RightsManagementServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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方法来设置受策略保护的文档。传递包含受策略保护的PDF文档的BLOB对象。此方法返回一个RMInspectResult对象，其中包含有关受策略保护的文档的信息。
获取有关受策略保护的文档的信息。

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

代码示例

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

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

另请参阅

创建水印

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

注意

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

注意

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

步骤的摘要

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

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

包括项目文件

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

创建文档 Security客户端API对象

设置水印属性

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

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

下表列表了使用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

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

注册水印

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

另请参阅

将策略应用于PDF文档

使用Java API创建水印

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

包括项目文件。

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

代码示例

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

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

使用Web服务API创建水印

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

创建文档 Security客户端API对象。

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

注意

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

代码示例

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

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

另请参阅

修改水印

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

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

注意

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

注意

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

步骤的摘要

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

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

包括项目文件

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

创建文档 Security客户端API对象

检索要修改的水印

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

设置水印属性

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

注意

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

注意

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

更新水印

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

另请参阅

创建水印

使用Java API修改水印

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

包括项目文件。

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

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

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

注意

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

代码示例

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

使用Web服务API修改水印

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

包括项目文件。

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建文档 Security客户端API对象。
- 使用DocumentSecurityServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建RightsManagementServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/DocumentSecurityService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取DocumentSecurityServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段DocumentSecurityServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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对象来更新水印。

代码示例

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

“快速开始(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 Client API对象

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

指定要搜索的事件

必须指定要搜索的事件。例如，您可以搜索策略创建事件，创建新策略时会发生该操作。

搜索事件

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

另请参阅

使用Java API搜索事件

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

包括项目文件

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

使用DocumentSecurityClient对象的构造函数并传递包含连接属性的ServiceClientFactory对象，创建对象。
指定要搜索的事件
- 通过调用DocumentSecurityClient对象的getEventManager方法创建EventManager对象。此方法返回一个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 Client API对象
- 使用DocumentSecurityServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建DocumentSecurityServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取DocumentSecurityServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段DocumentSecurityServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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文档外，Rights Management服务还支持其他文档格式，如Microsoft Word文档（DOC文件）和其他Microsoft office文件格式。例如，您可以将策略应用于Word文档以保护它。通过将策略应用于Word文档，可以限制对文档的访问。如果文档已使用策略保护，则不能将策略应用于文档。

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

注意

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

步骤的摘要

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

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

包括项目文件

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

创建文档 Security客户端API对象

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

检索Word文档

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

将现有策略应用于Word文档

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

保存Word文档

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

另请参阅

撤销对文档的访问

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

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

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-rightsmanagement-client.jar。
创建文档 Security客户端API对象。
- 创建包含连接属性的ServiceClientFactory对象。
- 使用DocumentSecurityClient对象的构造函数并传递ServiceClientFactory对象，创建对象。
检索Word文档。
- 使用Word文档的构造函数并传递一个指定Word文档位置的字符串值，创建一个表示Word的java.io.FileInputStream对象。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。
将现有策略应用于Word文档。
- 通过调用DocumentSecurityClient对象的getDocumentManager方法创建DocumentManager对象。
- 通过调用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对象的内容复制到文件（请确保使用由getProtectedDoc方法返回的Document对象）。

代码示例

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

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

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

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

包括项目文件。

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建文档 Security客户端API对象。
- 使用DocumentSecurityServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建DocumentSecurityServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/DocumentSecurityService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取DocumentSecurityServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段DocumentSecurityServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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文档的文件位置。
- 创建一个字节数组，用于存储protectDocument方法返回的BLOB对象的数据内容。通过获取BLOB对象的MTOM数据成员的值来填充字节数组。
- 通过调用其构造函数并传递System.IO.FileStream对象，创建System.IO.BinaryWriter对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入Word文件。

代码示例

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

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

从Word文档中删除策略

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

注意

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

步骤的摘要

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

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

包括项目文件

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

创建文档 Security客户端API对象

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

检索受策略保护的Word文档

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

从Word文档中删除策略

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

保存不安全的Word文档

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

另请参阅

将策略应用于Word文档

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

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

包括项目文件

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

代码示例

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

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

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

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

包括项目文件

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建文档 Security客户端API对象
- 使用RightsManagementServiceClient对象的默认构造函数创建对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建RightsManagementServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取RightsManagementServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务，启用基本HTTP身份验证：
  - 为字段RightsManagementServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段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方法并传递包含受策略保护的Word文档的BLOB对象，从Word文档中删除策略。此方法返回一个BLOB对象，它包含一个不安全的Word文档。
保存不安全的Word文档
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值来创建对象，该字符串值表示不安全Word文档的文件位置。
- 创建一个字节数组，用于存储removePolicySecurity方法返回的BLOB对象的数据内容。通过获取BLOB对象的MTOM字段的值来填充字节数组。
- 通过调用其构造函数并传递System.IO.FileStream对象，创建System.IO.BinaryWriter对象。

代码示例

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

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

另请参阅