加密和解密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对象的构造函数创建对象。 BLOB对象用于存储使用密码加密的PDF文档。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值来创建对象，该字符串值表示要加密的PDF文档的文件位置以及打开文件的模式。
- 创建一个字节数组，用于存储System.IO.FileStream对象的内容。可以通过获取System.IO.FileStream对象的Length属性来确定字节数组的大小。
- 通过调用System.IO.FileStream对象的Read方法并传递要读取的字节数组、开始位置和流长度，用流数据填充字节数组。
- 通过将字节数组的内容分配给BLOB对象的MTOM数据成员，填充BLOB对象。
设置加密运行时选项。
- 使用PasswordEncryptionOptionSpec对象的构造函数创建对象。
- 通过为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.FileStream对象，创建System.IO.BinaryWriter对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

使用证书加密PDF文档

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

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

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

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

注意

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

注意

有关Encryption服务的详细信息，请参阅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对象，创建对象。
引用证书。
- 创建一个java.util.List对象，该对象使用其构造函数存储权限信息。
- 通过调用java.util.List对象的add方法并传递一个CertificateEncryptionPermissions文档值来指定与加密的明细列表关联的权限，该值表示向打开受保护的PDF文档的用户授予的权限。例如，要指定所有权限，请传递CertificateEncryptionPermissions.PKI_ALL_PERM。
- 使用Recipient对象的构造函数创建对象。
- 创建一个java.io.FileInputStream对象，它表示使用PDF文档的构造函数并传递一个指定证书位置的字符串值来加密该证书的证书。
- 使用com.adobe.idp.Document对象的构造函数并传递表示证书的java.io.FileInputStream对象，创建对象。
- 调用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文档资源。例如，要加密整个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对象的构造函数创建对象。 BLOB对象用于存储使用证书加密的PDF文档。
- 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值来创建对象，该字符串值表示要加密的PDF文档的文件位置以及打开文件的模式。
- 创建一个字节数组，用于存储System.IO.FileStream对象的内容。可以通过获取System.IO.FileStream对象的Length属性来确定字节数组的大小。
- 通过调用System.IO.FileStream对象的Read方法并传递要读取的字节数组、开始位置和流长度，用流数据填充字节数组。
- 通过将MTOM属性赋予字节数组的内容，填充BLOB对象。
引用证书。
- 使用Recipient对象的构造函数创建对象。此对象将存储证书信息。
- 使用BLOB对象的构造函数创建对象。此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对象的构造函数创建对象。
- 通过为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.FileStream对象，创建System.IO.BinaryWriter对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

删除基于证书的加密

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

注意

有关Encryption服务的详细信息，请参阅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文档的对象。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。
删除加密。

通过调用EncryptionServiceClient对象的removePDFCertificateSecurity方法并传递以下值，从PDF文档中删除基于证书的加密：
- 包含加密的PDF文档的com.adobe.idp.Document对象。
- 一个字符串值，它指定与用于加密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对象的构造函数创建对象。 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.FileStream对象，创建System.IO.BinaryWriter对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

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

正在删除密码加密

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

注意

有关Encryption服务的详细信息，请参阅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(在JBoss上部署AEM Forms时为必需)
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文档的对象。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。
删除密码。

通过调用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对象的构造函数创建对象。 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.FileStream对象，创建System.IO.BinaryWriter对象。
- 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

解锁加密的PDF文档

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

注意

有关Encryption服务的详细信息，请参阅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文档的对象。
- 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。
解锁文档。

通过调用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 Forms Java方法以执行操作。
执行AEM Forms操作。

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

另请参阅

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

将使用权限应用于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对象的构造函数创建对象。
- 通过调用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服务创建的策略
另一种加密

注意

有关Encryption服务的详细信息，请参阅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对象，创建对象。
确定加密类型。
- 通过调用EncryptionServiceClient对象的getPDFEncryption方法并传递包含PDF文档的com.adobe.idp.Document对象，确定加密类型。此方法返回一个EncryptionTypeResult对象。
- 调用EncryptionTypeResult对象的getEncryptionType方法。此方法返回一个指定加密类型的EncryptionType枚举值。例如，如果PDF文档使用基于口令的加密进行保护，则此方法返回EncryptionType.PASSWORD。

另请参阅

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