使用凭据

本文档中的示例和示例仅适用于JEE环境上的AEM Forms。

关于凭据服务

凭据包含签名或标识文档所需的私钥信息。 证书是您为信任配置的公钥信息。 AEM Forms将证书和凭据用于以下几个用途：

• Acrobat Reader DC扩展使用凭据在PDF文档中启用Adobe Reader使用权限。 (请参阅将使用权限应用于PDF文档。)
• 签名服务在执行对PDF文档进行数字签名等操作时访问证书和凭据。 (请参阅对PDF文档进行数字签名。)

您可以使用Trust Manager Java API与凭据服务进行编程交互。 您可以执行以下任务:

• 使用Trust Manager API导入凭据
• 使用Trust Manager API删除凭据

使用Trust Manager API导入凭据

您可以使用Trust Manager API以编程方式将凭据导入AEM Forms。 例如，您可以导入用于签署PDF文档的凭据。 (请参阅对PDF文档进行数字签名)。

在导入凭据时，需为凭据指定别名。 别名用于执行需要凭据的Forms操作。 导入后，可以在管理控制台中查看凭据，如下图所示。 请注意，凭据的别名为​Secure。

步骤的摘要

要将凭据导入AEM Forms，请执行以下步骤：

1. 包括项目文件。
2. 创建凭据服务客户端。
3. 引用凭据。
4. 执行导入操作。

包括项目文件

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

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

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-truststore-client.jar
• adobe-utilities.jar(在JBoss上部署AEM Forms时为必需)
• jbossall-client.jar(在JBoss上部署AEM Forms时为必需)

有关这些JAR文件位置的信息，请参阅包括AEM Forms Java库文件。

创建凭据服务客户端

在以编程方式将凭据导入AEM Forms之前，请先创建凭据服务客户端。 有关信息，请参阅设置连接属性。

引用凭据

引用要导入AEM Forms的凭据。 与此部分关联的快速开始引用位于文件系统中的P12文件。

执行导入操作

引用凭据后，将凭据导入AEM Forms。 如果未成功导入凭据，则会引发异常。 在导入凭据时，需为凭据指定别名。

另请参阅

使用Java API导入凭据

包括AEM Forms Java库文件

设置连接属性

凭据服务API快速开始

使用Trust Manager API删除凭据

使用Java API导入凭据

使用Trust Manager API(Java)将凭据导入AEM Forms:

1. 包括项目文件

   在Java项目的类路径中包含客户端JAR文件，如adobe-truststore-client.jar。

2. 创建凭据服务客户端

   • 创建包含连接属性的ServiceClientFactory对象。
   • 使用CredentialServiceClient对象的构造函数并传递ServiceClientFactory对象，创建对象。

3. 引用凭据

   • 使用java.io.FileInputStream对象的构造函数创建对象。 传递一个字符串值，它指定凭据的位置。
   • 使用com.adobe.idp.Document构造函数创建存储凭据的com.adobe.idp.Document对象。 将包含凭据的java.io.FileInputStream对象传递给构造函数。

4. 执行导入操作

   • 创建一个包含一个元素的字符串数组。 将值truststore.usage.type.sign赋给元素。

   • 调用CredentialServiceClient对象的importCredential方法并传递以下值：

     • 一个字符串值，它指定凭据的别名值。
     • 存储凭据的com.adobe.idp.Document实例。
     • 一个字符串值，它指定与凭据关联的密码。
     • 包含使用值的字符串数组。 例如，可以指定此值truststore.usage.type.sign。 要导入Reader扩展凭据，请指定truststore.usage.type.lcre。

另请参阅

使用Trust Manager API导入凭据

快速开始（SOAP模式）：使用Java API导入凭据

包括AEM Forms Java库文件

设置连接属性

使用Trust Manager API删除凭据

您可以使用Trust Manager API以编程方式删除凭据。 在删除凭据时，您需要指定与凭据对应的别名。 删除后，不能使用凭据执行操作。

步骤的摘要

要删除凭据，请执行以下步骤：

1. 包括项目文件。
2. 创建凭据服务客户端。
3. 执行删除操作。

包括项目文件

在开发项目中包含必要的文件。 如果您使用Java创建客户端应用程序，请包含必要的JAR文件。 必须将以下JAR文件添加到项目的类路径中：

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-truststore-client.jar
• adobe-utilities.jar(在JBoss上部署AEM Forms时为必需)
• jbossall-client.jar(在JBoss上部署AEM Forms时为必需)

有关这些JAR文件位置的信息，请参阅包括AEM Forms Java库文件。

创建凭据服务客户端

在以编程方式删除凭据之前，请先创建一个Data Integration服务客户端。 在创建服务客户端时，您定义调用服务所需的连接设置。 有关信息，请参阅设置连接属性。

执行删除操作

要删除凭据，请指定与凭据对应的别名。 如果指定的别名不存在，则会引发异常。

另请参阅

使用Java API导入凭据

包括AEM Forms Java库文件

设置连接属性

使用Java API导入凭据

使用Java API删除凭据

使用Trust Manager API(Java)从AEM Forms中删除凭据：

1. 包括项目文件

   在Java项目的类路径中包含客户端JAR文件，如adobe-truststore-client.jar。

2. 创建凭据服务客户端

   • 创建包含连接属性的ServiceClientFactory对象。
   • 使用CredentialServiceClient对象的构造函数并传递ServiceClientFactory对象，创建对象。

3. 执行删除操作

   调用CredentialServiceClient对象的deleteCredential方法并传递一个指定别名值的字符串值。

另请参阅

使用Trust Manager API删除凭据

快速开始（SOAP模式）：使用Java API删除凭据

包括AEM Forms Java库文件

设置连接属性