使用憑據

關於憑證服務

憑證包含簽署或識別檔案所需的私密金鑰資訊。 憑證是您設定為信任的公開金鑰資訊。 AEM Forms使用憑證和認證以進行數種用途：

  • Acrobat Reader DC擴充功能使用憑證，以啟用PDF檔案中的Adobe Reader使用權限。 （請參閱將使用權套用至PDF檔案）。
  • 簽名服務在執行數位簽署PDF檔案等作業時，會存取憑證和認證。 （請參閱數位簽署PDF檔案）。

您可以使用Trust Manager Java API，以程式設計方式與憑證服務互動。 您可以執行下列工作：

注意

您也可以使用管理控制台來匯入和刪除憑證。 （請參閱管理說明。）

使用信任管理器API導入憑據

您可以使用Trust Manager API，以程式設計方式將憑證匯入AEM Forms。 例如，您可以匯入用於簽署PDF檔案的憑證。 （請參閱數位簽署PDF檔案）。

在導入憑據時，可以指定憑據的別名。 別名用於執行需要憑據的Forms操作。 在匯入後，憑證就可以在管理控制台中檢視，如下圖所示。 請注意，憑證的別名為​Secure。

ww_ww_truststore

注意

您無法使用web services將憑證匯入AEM Forms。

步驟摘要

若要將憑證匯入AEM Forms，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立憑證服務客戶端。
  3. 參考憑證。
  4. 執行導入操作。

包含專案檔案

將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用web services，請確定您包含proxy檔案。

必須將以下JAR檔案添加到項目的類路徑中：

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar（若AEM Forms部署在JBoss上，則為必要項）
  • jbossall-client.jar（如果AEM Forms部署在JBoss上，則為必要）

如需這些JAR檔案位置的詳細資訊，請參閱包含AEM Forms Java程式庫檔案。

建立憑證服務客戶端

在以程式設計方式將憑證匯入AEM Forms之前，請先建立憑證服務用戶端。 有關資訊，請參見設定連接屬性。

參考憑證

參考您要匯入至AEM Forms的憑證。 與本節關聯的快速入門參考了位於檔案系統中的P12檔案。

執行導入操作

參考憑證後，請將憑證匯入AEM Forms。 如果憑證未成功匯入，則會擲回例外。 在導入憑據時，可以指定憑據的別名。

另請參閱

使用Java API匯入認證

包含AEM Forms Java程式庫檔案

設定連接屬性

憑證服務API快速入門

使用信任管理器API刪除憑證

使用Java API匯入認證

使用Trust Manager API(Java)將憑證匯入AEM Forms:

  1. 包含專案檔案

    在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-truststore-client.jar。

  2. 建立憑證服務客戶端

    • 建立包含連接屬性的ServiceClientFactory對象。
    • 使用其建構子並傳遞ServiceClientFactory對象，建立CredentialServiceClient對象。

  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 Extension憑證，請指定truststore.usage.type.lcre。

另請參閱

使用信任管理器API匯入憑證

快速入門（SOAP模式）:使用Java API匯入認證

包含AEM Forms Java程式庫檔案

設定連接屬性

使用信任管理器API刪除憑據

您可以使用信任管理器API以程式設計方式刪除憑證。 在刪除憑據時，可以指定與憑據對應的別名。 刪除後，將不能使用憑據來執行操作。

注意

您無法使用web services將憑證刪除至AEM Forms。

步驟摘要

要刪除憑據，請執行以下步驟：

  1. 包含專案檔案。
  2. 建立憑證服務客戶端。
  3. 執行刪除操作。

包含專案檔案

將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 必須將以下JAR檔案添加到項目的類路徑中：

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar（若AEM Forms部署在JBoss上，則為必要項）
  • jbossall-client.jar（如果AEM Forms部署在JBoss上，則為必要）

如需這些JAR檔案位置的詳細資訊，請參閱包含AEM Forms Java程式庫檔案。

建立憑證服務客戶端

在以程式設計方式刪除憑證之前，請先建立Data Integration服務用戶端。 建立服務客戶端時，您定義調用服務所需的連接設定。 有關資訊，請參見設定連接屬性。

執行刪除操作

要刪除憑據，請指定與憑據對應的別名。 如果指定不存在的別名，則會拋出異常。

另請參閱

使用Java API匯入認證

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Java API匯入認證

使用Java API刪除憑據

使用信任管理員API(Java)從AEM Forms刪除憑證：

  1. 包含專案檔案

    在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-truststore-client.jar。

  2. 建立憑證服務客戶端

    • 建立包含連接屬性的ServiceClientFactory對象。
    • 使用其建構子並傳遞ServiceClientFactory對象，建立CredentialServiceClient對象。

  3. 執行刪除操作

    叫用CredentialServiceClient物件的deleteCredential方法並傳遞指定別名值的字串值。

另請參閱

使用信任管理器API刪除憑證

快速入門（SOAP模式）:使用Java API刪除認證

包含AEM Forms Java程式庫檔案

設定連接屬性

本頁內容