使用凭据 working-with-credentials

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

关于凭据服务

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

您可以使用信任管理器Java API以编程方式与凭据服务交互。 您可以执行以下任务:

NOTE
您还可以使用管理控制台导入和删除证书。 (请参阅 管理帮助。)

使用信任管理器API导入凭据 importing-credentials-by-using-the-trust-manager-api

您可以使用信任管理器API以编程方式将凭据导入AEM Forms。 例如,您可以导入用于对PDF文档进行签名的凭据。 (请参阅 数字签名PDF文档)。

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

ww_ww_truststore

NOTE
无法使用Web服务将凭据导入AEM Forms。

步骤摘要 summary-of-steps

要将凭据导入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快速入门

使用信任管理器API删除凭据

使用Java API导入凭据 import-credentials-using-the-java-api

使用信任管理器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.

另请参阅

使用信任管理器API导入凭据

快速入门(SOAP模式):使用Java API导入凭据

包括AEM Forms Java库文件

设置连接属性

使用信任管理器API删除凭据 deleting-credentials-by-using-the-trust-manager-api

您可以使用信任管理器API以编程方式删除凭据。 删除凭据时,您需要指定与凭据对应的别名。 删除凭据后,便无法使用凭据执行操作。

NOTE
您无法使用Web服务将凭据删除到AEM Forms中。

步骤摘要 summary_of_steps-1

要删除凭据,请执行以下步骤:

  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 Service客户端。 在创建服务客户端时,您可以定义调用服务所需的连接设置。 有关信息,请参阅 设置连接属性.

执行删除操作

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

另请参阅

使用Java API导入凭据

包括AEM Forms Java库文件

设置连接属性

使用Java API导入凭据

使用Java API删除凭据 deleting-credentials-using-the-java-api

使用信任管理器API(Java)从AEM Forms中删除凭据:

  1. 包含项目文件

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

  2. 创建凭据服务客户端

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 CredentialServiceClient 对象,并使用其构造函数进行传递 ServiceClientFactory 对象。
  3. 执行删除操作

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

另请参阅

使用信任管理器API删除凭据

快速入门(SOAP模式):使用Java API删除凭据

包括AEM Forms Java库文件

设置连接属性

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da