加密和解密PDF文档

快速开始（SOAP模式）:使用Java API加密PDF文档

使用Web服务API加密PDF文档

使用Encryption API（Web服务）使用口令加密PDF文档:

包括项目文件。

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建Encryption Client API对象。
- 使用其默认构造函数创建EncryptionServiceClient对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建EncryptionServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如，http://localhost:8080/soap/services/EncryptionService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取EncryptionServiceClient.Endpoint.Binding字段的值创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 为字段EncryptionServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段EncryptionServiceClient.ClientCredentials.UserName.Password分配相应的口令值。
  - 将常量值HttpClientCredentialType.Basic指定到字段BasicHttpBindingSecurity.Transport.ClientCredentialType。
  - 将常量值BasicHttpSecurityMode.TransportCredentialOnly指定到字段BasicHttpBindingSecurity.Security.Mode。
获取要加密的PDF文档。
- 使用BLOB对象的构造函数创建<a0/>对象。 BLOB对象用于存储使用密码加密的PDF文档。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示要加密的PDF文档的文件位置以及打开文件的模式。
- 创建存储System.IO.FileStream对象内容的字节数组。通过获取System.IO.FileStream对象的Length属性，可以确定字节数组的大小。
- 通过调用System.IO.FileStream对象的Read方法并传递要读取的字节数组、开始位置和流长度，用流数据填充字节数组。
- 通过将字节数组的内容分配给BLOB对象的MTOM数据成员，填充BLOB对象。
设置加密运行时选项。
- 使用PasswordEncryptionOptionSpec对象的构造函数创建<a0/>对象。
- 通过为PasswordEncryptionOptionSpec对象的encryptOption文档成员分配PasswordEncryptionOption明细列表值，指定要加密的PDF资源。要加密整个PDF，包括其元数据及其附件，请将PasswordEncryptionOption.ALL分配给此数据成员。
- 通过为PasswordEncryptionOptionSpec对象的compatability数据成员分配PasswordEncryptionCompatability明细列表值，指定Acrobat兼容性选项。例如，将PasswordEncryptionCompatability.ACRO_7分配给此数据成员。
- 指定允许用户通过为PasswordEncryptionOptionSpec对象的documentOpenPassword数据成员指定表示打开口令的字符串值来打开加密的PDF文档的口令值。
- 指定密码值，允许用户通过为PasswordEncryptionOptionSpec对象的permissionPassword文档成员指定表示主控密码的字符串值，从PDF中删除加密。
添加密码。

通过调用EncryptionServiceClient对象的encryptPDFUsingPassword方法并传递以下值，加密PDF文档:
- BLOB对象，它包含要使用口令加密的PDF文档。
- 包含加密运行时选项的PasswordEncryptionOptionSpec对象。
encryptPDFUsingPassword方法返回一个BLOB对象，该对象包含口令加密的PDF文档。
将加密的PDF文档另存为PDF文件。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示受保护PDF文档的文件位置。
- 创建一个字节数组，用于存储encryptPDFUsingPassword方法返回的BLOB对象的数据内容。通过获取BLOB对象的MTOM数据成员的值，填充字节数组。
- 通过调用System.IO.BinaryWriter对象的构造函数并传递System.IO.FileStream对象，创建<a0/>对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

使用证书加密PDF文档

基于证书的加密允许您通过公钥技术为特定收件人加密文档。可以为各种收件人授予不同的文档权限。公钥技术使加密的许多方面成为可能。算法用于生成两个大数字，称为keys，它们具有以下属性：

一个密钥用于加密一组数据。随后，只能使用其他密钥解密数据。
一把钥匙和另一把钥匙分不开。

其中一个密钥充当用户的私钥。只有用户才有权访问此密钥，这一点很重要。另一个密钥是用户的公钥，可与他人共享。

公钥证书包含用户的公钥和标识信息。 X.509格式用于存储证书。证书通常由证书颁发机构(CA)颁发和数字签名，该机构是提供对证书有效性的信任度的公认实体。证书的到期日期已过期，在此日期后，证书不再有效。此外，证书吊销列表(CRL)还提供有关在其过期日期之前已吊销的证书的信息。 CRL由证书颁发机构定期发布。证书的吊销状态也可以通过网络通过联机证书状态协议(OCSP)进行检索。

注意

在使用证书加密PDF文档之前，必须确保将证书添加到AEM Forms。证书是使用管理控制台添加的，或使用Trust Manager API以编程方式添加的。（请参阅使用Trust Manager API导入凭据。）

注意

有关加密服务的详细信息，请参阅AEM Forms的服务参考。

步骤的摘要

要使用证书加密PDF文档，请执行以下步骤：

包括项目文件。
创建Encryption Client API对象。
获取要加密的PDF文档。
引用证书。
设置加密运行时选项。
创建证书加密的PDF文档。
将加密的PDF文档另存为PDF文件。

包括项目文件

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

必须将以下JAR文件添加到项目的类路径中：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar(如果AEM Forms部署在JBoss Application Server上，则为必需)
jbossall-client.jar(如果AEM Forms部署在JBoss Application Server上，则为必需)

创建加密客户端API对象

要以编程方式执行加密服务操作，必须创建加密服务客户端。如果您使用Java Encryption Service API，请创建EncrytionServiceClient对象。如果您使用Web服务Encryption Service API，请创建EncryptionServiceService对象。

获取要加密的PDF文档

您必须获得未加密的PDF文档才能加密。如果尝试保护已加密的PDF文档，将引发异常。

引用证书

要使用证书加密PDF文档，请引用用于加密PDF文档的证书。证书是。cer文件、.crt文件或。pem文件。 PKCS#12文件用于存储具有相应证书的私钥。

使用证书加密PDF文档时，指定与安全文档关联的权限。通过指定权限，您可以控制打开证书加密PDF文档的用户可以执行的操作。

设置加密运行时选项

指定要加密的PDF文档资源。您可以加密整个PDF文档、除文档元数据以外的所有内容，或仅加密文档的附件。

创建证书加密的PDF文档

在检索不安全的PDF文档、引用证书并设置运行时选项后，您可以创建证书加密的PDF文档。 PDF文档加密后，您需要相应的公钥才能解密它。

将加密的PDF文档另存为PDF文件

您可以将加密的PDF文档另存为PDF文件。

另请参阅

使用Java API使用证书加密PDF文档

使用Web服务API使用证书加密PDF文档

使用Java API使用证书加密PDF文档

使用Encryption API(Java)使用证书加密PDF文档:

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-encryption-client.jar。
创建Encryption Client API对象。
- 创建包含连接属性的ServiceClientFactory对象。
- 使用EncryptionServiceClient对象的构造函数创建ServiceClientFactory对象。
获取要加密的PDF文档。
- 创建一个java.io.FileInputStream对象，它表示要加密的PDF文档，方法是使用它的构造函数并传递一个指定PDF文档位置的字符串值。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建<a0/>对象。
引用证书。
- 创建一个java.util.List对象，它使用其构造函数存储权限信息。
- 通过调用java.util.List对象的add方法并传递一个CertificateEncryptionPermissions文档值，指定与加密的明细列表关联的权限，该值表示向打开受保护的PDF文档的用户授予的权限。例如，要指定所有权限，请传递CertificateEncryptionPermissions.PKI_ALL_PERM。
- 使用Recipient对象的构造函数创建<a0/>对象。
- 创建一个java.io.FileInputStream对象，它表示用于加密PDF文档的证书，方法是使用它的构造函数并传递一个指定证书位置的字符串值。
- 使用com.adobe.idp.Document对象的构造函数创建java.io.FileInputStream对象，并传递表示证书的<a1/>对象。
- 调用Recipient对象的setX509Cert方法并传递包含证书的com.adobe.idp.Document对象。（此外，Recipient对象可以具有Truststore证书别名或LDAP URL作为证书源。）
- 使用CertificateEncryptionIdentity对象的构造函数创建一个用于存储权限和证书信息的对象。
- 调用CertificateEncryptionIdentity对象的setPerms方法并传递存储权限信息的java.util.List对象。
- 调用CertificateEncryptionIdentity对象的setRecipient方法并传递存储证书信息的Recipient对象。
- 创建一个java.util.List对象，它使用其构造函数存储证书信息。
- 调用java.util.List对象的add方法并传递CertificateEncryptionIdentity对象。（此java.util.List对象作为参数传递给encryptPDFUsingCertificates方法。）
设置加密运行时选项。
- 通过调用其构造函数创建CertificateEncryptionOptionSpec对象。
- 通过调用CertificateEncryptionOptionSpec对象的setOption方法并传递指定要加密的文档资源的CertificateEncryptionOption明细列表值，指定要加密的文档资源。例如，要加密整个PDF文档，包括其元数据及其附件，请指定CertificateEncryptionOption.ALL。
- 通过调用CertificateEncryptionOptionSpec对象的setCompat方法并传递指定Acrobat兼容性级别的CertificateEncryptionCompatibility明细列表值，指定Acrobat兼容性选项。例如，可以指定CertificateEncryptionCompatibility.ACRO_7。
创建证书加密的PDF文档。

通过调用EncryptionServiceClient对象的encryptPDFUsingCertificates方法并传递以下值，使用证书加密PDF文档:
- 包含要加密的PDF文档的com.adobe.idp.Document对象。
- 存储证书信息的java.util.List对象。
- 包含加密运行时选项的CertificateEncryptionOptionSpec对象。
encryptPDFUsingCertificates方法返回一个com.adobe.idp.Document对象，该对象包含证书加密的PDF文档。
将加密的PDF文档另存为PDF文件。
- 创建java.io.File对象，并确保文件扩展名为。pdf。
- 调用com.adobe.idp.Document对象的copyToFile方法，将com.adobe.idp.Document对象的内容复制到文件。确保使用由encryptPDFUsingCertificates方法返回的com.adobe.idp.Document对象。

另请参阅

快速开始（SOAP模式）:使用Java API使用证书加密PDF文档

使用Web服务API使用证书加密PDF文档

使用Encryption API（Web服务）使用证书加密PDF文档:

包括项目文件。

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

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建Encryption Client API对象。
- 使用其默认构造函数创建EncryptionServiceClient对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建EncryptionServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如，http://localhost:8080/soap/services/EncryptionService?WSDL）。您无需使用lc_version属性。此属性在您创建服务引用时使用。)
- 通过获取EncryptionServiceClient.Endpoint.Binding字段的值创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 为字段EncryptionServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段EncryptionServiceClient.ClientCredentials.UserName.Password分配相应的口令值。
  - 将常量值HttpClientCredentialType.Basic指定到字段BasicHttpBindingSecurity.Transport.ClientCredentialType。
  - 将常量值BasicHttpSecurityMode.TransportCredentialOnly指定到字段BasicHttpBindingSecurity.Security.Mode。
获取要加密的PDF文档。
- 使用BLOB对象的构造函数创建<a0/>对象。 BLOB对象用于存储使用证书加密的PDF文档。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示要加密的PDF文档的文件位置以及打开文件的模式。
- 创建存储System.IO.FileStream对象内容的字节数组。通过获取System.IO.FileStream对象的Length属性，可以确定字节数组的大小。
- 通过调用System.IO.FileStream对象的Read方法并传递要读取的字节数组、开始位置和流长度，用流数据填充字节数组。
- 通过为MTOM对象的<a1/>属性指定字节数组的内容，填充BLOB对象。
引用证书。
- 使用Recipient对象的构造函数创建<a0/>对象。此对象将存储证书信息。
- 使用BLOB对象的构造函数创建<a0/>对象。此BLOB对象将存储加密PDF文档的证书。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示证书的文件位置以及打开文件的模式。
- 创建存储System.IO.FileStream对象内容的字节数组。通过获取System.IO.FileStream对象的Length属性，可以确定字节数组的大小。
- 通过调用System.IO.FileStream对象的Read方法并传递要读取的字节数组、开始位置和流长度，用流数据填充字节数组。
- 通过将字节数组的内容分配给BLOB对象的MTOM数据成员，填充BLOB对象。
- 将存储证书的BLOB对象分配给Recipient对象的x509Cert数据成员。
- 创建一个CertificateEncryptionIdentity对象，它使用其构造函数存储证书信息。
- 将存储证书的Recipient对象分配给CertificateEncryptionIdentity对象的收件人数据成员。
- 创建Object数组，将CertificateEncryptionIdentity对象分配给Object数组的第一个元素。此Object数组作为参数传递给encryptPDFUsingCertificates方法。
设置加密运行时选项。
- 使用CertificateEncryptionOptionSpec对象的构造函数创建<a0/>对象。
- 通过为CertificateEncryptionOptionSpec对象的option文档成员分配CertificateEncryptionOption明细列表值，指定要加密的PDF资源。要加密整个PDF文档，包括其元数据及其附件，请为此数据成员分配CertificateEncryptionOption.ALL。
- 通过为CertificateEncryptionOptionSpec对象的compat数据成员分配CertificateEncryptionCompatibility明细列表值，指定Acrobat兼容性选项。例如，将CertificateEncryptionCompatibility.ACRO_7分配给此数据成员。
创建证书加密的PDF文档。

通过调用EncryptionServiceService对象的encryptPDFUsingCertificates方法并传递以下值，使用证书加密PDF文档:
- 包含要加密的PDF文档的BLOB对象。
- 存储证书信息的Object阵列。
- 包含加密运行时选项的CertificateEncryptionOptionSpec对象。
encryptPDFUsingCertificates方法返回一个BLOB对象，该对象包含证书加密的PDF文档。
将加密的PDF文档另存为PDF文件。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示受保护PDF文档的文件位置。
- 创建一个字节数组，用于存储encryptPDFUsingCertificates方法返回的BLOB对象的数据内容。通过获取BLOB对象的binaryData数据成员的值，填充字节数组。
- 通过调用System.IO.BinaryWriter对象的构造函数并传递System.IO.FileStream对象，创建<a0/>对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

删除基于证书的加密

可以从PDF文档中删除基于证书的加密，以便用户可以在Adobe Reader或Acrobat打开PDF文档。要从使用证书加密的PDF文档中删除加密，必须引用公钥。从PDF文档删除加密后，它不再安全。

注意

有关加密服务的详细信息，请参阅AEM Forms的服务参考。

步骤的摘要

要从PDF文档中删除基于证书的加密，请执行以下步骤：

包括项目文件。
创建加密服务客户端。
获取加密的PDF文档。
删除加密。
将PDF文档另存为PDF文件。

包括项目文件

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

必须将以下JAR文件添加到项目的类路径中：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar(如果AEM Forms部署在JBoss Application Server上，则为必需)
jbossall-client.jar(如果AEM Forms部署在JBoss Application Server上，则为必需)

创建加密服务客户端

获取加密的PDF文档

您必须获得加密的PDF文档才能删除基于证书的加密。如果尝试从未加密的PDF文档中删除加密，将引发异常。同样，如果尝试从密码加密文档删除基于证书的加密，则会引发异常。

删除加密

要从加密的PDF文档中删除基于证书的加密，您需要加密的PDF文档和与用于加密PDF文档的密钥相对应的私钥。从加密的PDF文档删除基于证书的加密时，将指定私钥的别名值。有关公钥的信息，请参阅使用证书加密PDF文档。

注意

私钥存储在AEM Forms信任商店。将证书放在该位置时，将指定别名值。

保存PDF文档

从加密的PDF文档中删除基于证书的加密后，您可以将PDF文档另存为PDF文件。用户可以在Adobe Reader或Acrobat打开PDF文档。

另请参阅

使用Java API删除基于证书的加密

使用Encryption API(Java)从PDF文档中删除基于证书的加密：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-encryption-client.jar。
创建加密服务客户端。
- 创建包含连接属性的ServiceClientFactory对象。
- 使用EncryptionServiceClient对象的构造函数创建ServiceClientFactory对象。
获取加密的PDF文档。
- 使用java.io.FileInputStream对象的构造函数并传递一个指定加密PDF文档位置的字符串值，创建一个表示加密PDF文档的<a0/>对象。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建<a0/>对象。
删除加密。

通过调用EncryptionServiceClient对象的removePDFCertificateSecurity方法并传递以下值，从PDF文档中删除基于证书的加密：
- com.adobe.idp.Document对象，它包含加密的PDF文档。
- 一个字符串值，它指定与用于加密PDf文档的密钥对应的私钥的别名。
removePDFCertificateSecurity方法返回一个com.adobe.idp.Document对象，该对象包含一个不安全的PDF文档。
保存PDF文档。
- 创建java.io.File对象，并确保文件扩展名为。pdf。
- 调用com.adobe.idp.Document对象的copyToFile方法，将Document对象的内容复制到文件。确保使用由removePDFCredentialSecurity方法返回的com.adobe.idp.Document对象。

另请参阅

快速开始（SOAP模式）:使用Java API删除基于证书的加密

使用Web服务API删除基于证书的加密

使用Encryption API（Web服务）删除基于证书的加密：

包括项目文件。

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

注意

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

调用EncryptionServiceClient对象的removePDFCertificateSecurity方法并传递以下值：
- BLOB对象，它包含表示加密PDF文档的文件流数据。
- 一个字符串值，它指定与用于加密PDf文档的私钥对应的公钥的别名。
removePDFCredentialSecurity方法返回一个BLOB对象，该对象包含一个不安全的PDF文档。
保存PDF文档。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示不安全的PDF文档的文件位置。
- 创建一个字节数组，用于存储removePDFPasswordSecurity方法返回的BLOB对象的内容。通过获取BLOB对象的MTOM数据成员的值，填充字节数组。
- 通过调用System.IO.BinaryWriter对象的构造函数并传递System.IO.FileStream对象，创建<a0/>对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

快速开始（SOAP模式）:使用Java API删除基于密码的加密

删除密码加密

可以从PDF文档中删除基于密码的加密，这样用户无需指定密码即可在Adobe Reader或Acrobat打开PDF文档。从PDF文档删除基于密码的加密后，文档不再安全。

注意

有关加密服务的详细信息，请参阅AEM Forms的服务参考。

步骤的摘要

要从PDF文档中删除基于密码的加密，请执行以下步骤：

包括项目文件
创建加密服务客户端。
获取加密的PDF文档。
删除密码。
将PDF文档另存为PDF文件。

包括项目文件

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

必须将以下JAR文件添加到项目的类路径中：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar(如果AEM Forms部署在JBoss上，则为必需)
jbossall-client.jar(如果在JBoss上部署了AEM Forms，则此为必需)

创建加密服务客户端

获取加密的PDF文档

您必须获得加密的PDF文档才能删除基于密码的加密。如果尝试从未加密的PDF文档中删除加密，将引发异常。

删除密码

要从加密的PDF文档中删除基于密码的加密，您需要加密的PDF文档和用于从PDF文档中删除加密的主控密码值。用于打开密码加密的PDF文档的密码不能用于删除加密。当用密码加密PDF文档时，将指定主控密码。 (请参阅使用口令加密PDF文档。)

保存PDF文档

在Encryption服务从PDF文档删除基于密码的加密后，您可以将PDF文档另存为PDF文件。用户无需指定口令即可在Adobe Reader或Acrobat打开PDF文档。

另请参阅

使用Java API删除基于口令的加密

使用Encryption API(Java)从PDF文档中删除基于密码的加密：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-encryption-client.jar。
创建加密服务客户端。
- 创建包含连接属性的ServiceClientFactory对象。
- 使用EncryptionServiceClient对象的构造函数创建ServiceClientFactory对象。
获取加密的PDF文档。
- 使用java.io.FileInputStream对象的构造函数并传递一个指定PDF文档位置的字符串值，创建一个表示已加密PDF文档的<a0/>对象。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建<a0/>对象。
删除密码。

通过调用EncryptionServiceClient对象的removePDFPasswordSecurity方法并传递以下值，从PDF文档中删除基于口令的加密：
- 一个com.adobe.idp.Document对象，它包含加密的PDF文档。
- 一个字符串值，它指定用于从PDF文档中删除加密的主控密码值。
removePDFPasswordSecurity方法返回一个com.adobe.idp.Document对象，该对象包含一个不安全的PDF文档。
保存PDF文档。
- 创建java.io.File对象，并确保文件扩展名为。pdf。
- 调用com.adobe.idp.Document对象的copyToFile方法，将Document对象的内容复制到文件。确保使用由removePDFPasswordSecurity方法返回的Document对象。

另请参阅

使用Web服务API删除基于口令的加密

使用Encryption API（Web服务）删除基于密码的加密：

包括项目文件。

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

注意

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

调用EncryptionServiceService对象的removePDFPasswordSecurity方法并传递以下值：
- BLOB对象，它包含表示加密PDF文档的文件流数据。
- 一个字符串值，它指定用于从PDF文档中删除加密的口令值。使用口令加密PDF文档时指定此值。
removePDFPasswordSecurity方法返回一个BLOB对象，该对象包含一个不安全的PDF文档。
保存PDF文档。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示不安全的PDF文档的文件位置。
- 创建一个字节数组，用于存储removePDFPasswordSecurity方法返回的BLOB对象的内容。通过获取BLOB对象的MTOM数据成员的值，填充字节数组。
- 通过调用System.IO.BinaryWriter对象的构造函数并传递System.IO.FileStream对象，创建<a0/>对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

解锁加密的PDF文档

必须先解锁密码加密或证书加密的PDF文档，然后才能对其执行其他AEM Forms操作。如果尝试对加密的PDF文档执行操作，将生成异常。解锁加密的PDF文档后，可以对其执行一个或多个操作。这些业务可以属于其他服务，如Acrobat Reader DC扩展服务。

注意

有关加密服务的详细信息，请参阅AEM Forms的服务参考。

步骤的摘要

要解锁加密的PDF文档，请执行以下步骤：

包括项目文件。
创建加密服务客户端。
获取加密的PDF文档。
解锁文档。
执行AEM Forms操作。

包括项目文件

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

必须将以下JAR文件添加到项目的类路径中：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar(如果AEM Forms部署在JBoss Application Server上，则为必需)
jbossall-client.jar(如果AEM Forms部署在JBoss Application Server上，则为必需)

创建加密服务客户端

获取加密的PDF文档

您必须获得加密的PDF文档才能将其解锁。如果尝试解锁未加密的PDF文档，将引发异常。

解锁文档

要解锁密码加密的PDF文档，您需要加密的PDF文档和用于打开密码加密的PDF文档的密码值。使用口令加密PDF文档时指定此值。 (请参阅使用口令加密PDF文档。)

要解锁证书加密的PDF文档，您需要加密的PDF文档以及与用于加密PDF文档的私钥对应的公钥的别名值。

执行AEM Forms操作

解锁加密的PDF文档后，您可以对其执行其他服务操作，如对其应用使用权限。此操作属于Acrobat Reader DC扩展服务。

另请参阅

使用Java API解锁加密的PDF文档

使用Encryption API(Java)解锁加密的PDF文档:

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-encryption-client.jar。
创建加密服务客户端。
- 创建包含连接属性的ServiceClientFactory对象。
- 使用EncryptionServiceClient对象的构造函数创建ServiceClientFactory对象。
获取加密的PDF文档。
- 使用java.io.FileInputStream对象的构造函数并传递一个指定加密PDF文档位置的字符串值，创建一个表示加密PDF文档的<a0/>对象。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建<a0/>对象。
解锁文档。

通过调用EncryptionServiceClient对象的unlockPDFUsingPassword或unlockPDFUsingCredential方法解锁已加密的PDF文档。

要解锁使用密码加密的PDF文档，请调用unlockPDFUsingPassword方法并传递以下值：
- com.adobe.idp.Document对象，它包含密码加密的PDF文档。
- 一个字符串值，它指定用于打开密码加密的PDF文档的密码值。使用口令加密PDF文档时指定此值。
要解锁使用证书加密的PDF文档，请调用unlockPDFUsingCredential方法并传递以下值：
- com.adobe.idp.Document对象，它包含证书加密的PDF文档。
- 一个字符串值，它指定与用于加密PDF文档的私钥对应的公钥的别名。
unlockPDFUsingPassword和unlockPDFUsingCredential方法都返回一个com.adobe.idp.Document对象，您将该对象传递给另一个AEM FormsJava方法以执行操作。
执行AEM Forms操作。

在已解锁的PDF文档上执行AEM Forms操作，以满足您的业务要求。例如，假定要对已解锁的PDF文档应用使用权限，请将unlockPDFUsingPassword或unlockPDFUsingCredential方法返回的com.adobe.idp.Document对象传递给ReaderExtensionsServiceClient对象的applyUsageRights方法。

另请参阅

快速开始（SOAP模式）:使用Java API（SOAP模式）解锁加密的 PDF文档。

将使用权限应用于PDF文档

使用Web服务API解锁加密的PDF文档

使用Encryption API（Web服务）解锁加密的PDF文档:

包括项目文件。

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

注意

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

通过调用EncryptionServiceClient对象的unlockPDFUsingPassword或unlockPDFUsingCredential方法解锁已加密的PDF文档。

要解锁使用密码加密的PDF文档，请调用unlockPDFUsingPassword方法并传递以下值：
- BLOB对象，它包含密码加密的PDF文档。
- 一个字符串值，它指定用于打开密码加密的PDF文档的密码值。使用口令加密PDF文档时指定此值。
要解锁使用证书加密的PDF文档，请调用unlockPDFUsingCredential方法并传递以下值：
- BLOB对象，它包含证书加密的PDF文档。
- 一个字符串值，它指定与用于加密PDf文档的私钥对应的公钥的别名。
unlockPDFUsingPassword和unlockPDFUsingCredential方法都返回一个com.adobe.idp.Document对象，您将该对象传递给另一个AEM Forms方法以执行操作。
执行AEM Forms操作。

在已解锁的PDF文档上执行AEM Forms操作，以满足您的业务要求。例如，假定要对已解锁的PDF文档应用使用权限，请将unlockPDFUsingPassword或unlockPDFUsingCredential方法返回的BLOB对象传递给ReaderExtensionsServiceClient对象的applyUsageRights方法。

另请参阅

确定加密类型

您可以使用Java Encryption Service API或Web服务Encryption Service API以编程方式确定保护PDF文档的加密类型。有时，需要动态确定PDF文档是否已加密，如果是，则需要动态确定加密类型。例如，您可以确定PDF文档是使用基于口令的加密还是Rights Management策略进行保护。

PDF文档可以受以下加密类型的保护：

基于密码的加密
基于证书的加密
由Rights Management服务创建的策略
另一种加密

注意

有关加密服务的详细信息，请参阅AEM Forms的服务参考。

步骤的摘要

要确定保护PDF文档的加密类型，请执行以下步骤：

包括项目文件。
创建加密服务客户端。
获取加密的PDF文档。
确定加密类型。

包括项目文件

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

必须将以下JAR文件添加到项目的类路径中：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar(如果AEM Forms部署在JBoss Application Server上，则为必需)
jbossall-client.jar(如果AEM Forms部署在JBoss Application Server上，则为必需)

创建服务客户端

获取加密的PDF文档

您必须获得PDF文档，以确定保护该文件的加密类型。

确定加密类型

您可以确定保护PDF文档的加密类型。如果PDF文档没有保护，则加密服务会通知您PDF文档没有保护。

另请参阅

使用Java API确定加密类型

使用Encryption API(Java)确定保护PDF文档的加密类型：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-encryption-client.jar。
创建服务客户端。
- 创建包含连接属性的ServiceClientFactory对象。
- 使用EncryptionServiceClient对象的构造函数创建ServiceClientFactory对象。
获取加密的PDF文档。
- 使用PDF文档的构造函数并传递一个指定PDF文档位置的字符串值，创建一个表示PDF的java.io.FileInputStream对象。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建<a0/>对象。
确定加密类型。
- 通过调用EncryptionServiceClient对象的getPDFEncryption方法并传递包含PDF文档的com.adobe.idp.Document对象，确定加密类型。此方法返回一个EncryptionTypeResult对象。
- 调用EncryptionTypeResult对象的getEncryptionType方法。此方法返回指定加密类型的EncryptionType枚举值。例如，如果PDF文档受基于密码的加密保护，则此方法返回EncryptionType.PASSWORD。

另请参阅

快速开始（SOAP模式）:使用Java API确定加密类型

使用Web服务API确定加密类型

使用Encryption API（Web服务）确定保护PDF文档的加密类型：

包括项目文件。

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

注意

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

另请参阅