使用憑據

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

關於憑證服務

憑證包含簽署或識別檔案所需的私密金鑰資訊。 憑證是您設定為信任的公開金鑰資訊。 AEM Forms使用證書和證書的目的有：

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

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

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

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

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

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

步驟摘要

要將憑據導入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 FormsJava庫檔案。

建立憑證服務客戶端

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

參考憑證

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

執行導入操作

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

另請參閱

使用Java API匯入認證

包含AEM FormsJava庫檔案

設定連接屬性

憑證服務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 FormsJava庫檔案

設定連接屬性

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

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

步驟摘要

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

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 FormsJava庫檔案。

建立憑證服務客戶端

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

執行刪除操作

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

另請參閱

使用Java API匯入認證

包含AEM FormsJava庫檔案

設定連接屬性

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

設定連接屬性