使用憑據

本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。

關於憑據服務

憑據包含簽名或標識文檔所需的私鑰資訊。 憑證是您為信任所設定的公開金鑰資訊。 AEM Forms使用憑證和憑證有數種用途：

  • Acrobat Reader DC擴充功能使用憑證來啟用PDF檔案中的Adobe Reader使用權限。 （請參閱將使用權套用至PDF檔案。）
  • 簽名服務在執行諸如數位簽署PDF文檔等操作時訪問證書和憑據。 （請參閱數位簽署PDF檔案。）

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

注意

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

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

您可以使用信任管理器API，以程式設計方式將憑證匯入AEM Forms。 例如，您可以匯入用來簽署PDF檔案的憑證。 （請參閱數位簽署PDF檔案）。

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

ww_ww_truststore

注意

您無法使用網站服務將憑證匯入AEM Forms。

步驟的摘要

要將憑據導入AEM Forms，請執行以下步驟：

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

包含項目檔案

在您的開發專案中加入必要的檔案。 如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用Web服務，請確定您包含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導入憑據

使用信任管理器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擴展憑據，請指定truststore.usage.type.lcre。

另請參閱

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

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

包含AEM Forms Java程式庫檔案

設定連接屬性

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

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

注意

您無法使用Web服務將憑證刪除至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庫檔案。

建立憑據服務客戶端

在以寫程式方式刪除憑據之前，請先建立資料整合服務客戶端。 建立服務客戶端時，您定義調用服務所需的連接設定。 有關資訊，請參閱設定連接屬性。

執行刪除操作

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

另請參閱

使用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程式庫檔案

設定連接屬性

本頁內容