數字簽名和認證文檔 digitally-signing-and-certifying-documents

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案，如adobe-signatures-client.jar。

建立簽名客戶端

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

獲取添加簽名欄位的PDF文檔

• 建立 java.io.FileInputStream 表示簽名欄位添加到的PDF文檔的對象，方法是使用其建構子並傳遞一個字串值，該字串值指定PDF文檔的位置。
• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

添加簽名欄位

• 建立 PositionRectangle 使用其建構子指定簽名欄位位置的對象。 在建構子中，指定坐標值。

• 如果需要，請建立 FieldMDPOptions 指定在將數字簽名應用於簽名欄位時鎖定的欄位的對象。

• 通過調用 SignatureServiceClient 物件 addSignatureField 方法並傳遞下列值：

  • A com.adobe.idp. Document 表示添加簽名欄位的PDF文檔的對象。
  • 指定簽名欄位名稱的字串值。
  • A java.lang.Integer 代表新增簽名欄位的頁碼的值。
  • A PositionRectangle 指定簽名欄位位置的對象。
  • A FieldMDPOptions 指定PDF文檔中在將數字簽名應用到簽名欄位後鎖定的欄位的對象。 此參數值為選用值，您可以傳遞 null.

• A PDFSeedValueOptions 指定各種運行時值的對象。 此參數值為選用值，您可以傳遞 null.

  此 addSignatureField 方法傳回 com.adobe.idp. Document 表示包含簽名欄位的PDF文檔的對象。

將PDF文檔另存為PDF檔案

• 建立 java.io.File 物件，並確定副檔名為.pdf。
• 叫用 com.adobe.idp. Document 物件 copyToFile 複製內容的方法 Document 物件。 請確定您使用 com.adobe.idp. Document 由傳回的物件 addSignatureField 方法。

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

建立簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

獲取添加簽名欄位的PDF文檔

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象用於儲存將包含簽名欄位的PDF文檔。
• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
• 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
• 填入 BLOB 對象，通過賦值 MTOM 屬性（包含位元組陣列的內容）。

添加簽名欄位

通過調用 SignatureServiceClient 物件 addSignatureField 方法並傳遞下列值：

• A BLOB 表示添加簽名欄位的PDF文檔的對象。
• 指定簽名欄位名稱的字串值。
• 一個整數值，表示要向其添加簽名欄位的頁碼。
• A PositionRect 指定簽名欄位位置的對象。
• A FieldMDPOptions 指定PDF文檔中在將數字簽名應用到簽名欄位後鎖定的欄位的對象。 此參數值為選用值，您可以傳遞 null.
• A PDFSeedValueOptions 指定各種運行時值的對象。 此參數值為選用值，您可以傳遞 null.

此 addSignatureField 方法傳回 BLOB 表示包含簽名欄位的PDF文檔的對象。

將PDF文檔另存為PDF檔案

• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示將包含簽名欄位的PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 BLOB 由傳回的物件 addSignatureField 方法。 取得 BLOB 物件 binaryData 資料成員。
• 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
• 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案，如adobe-signatures-client.jar。

建立簽名客戶端

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

獲取包含簽名欄位的PDF文檔

• 建立 java.io.FileInputStream 表示包含簽名欄位的PDF文檔的對象，方法是使用其建構子並傳遞一個字串值，該字串值指定PDF文檔的位置。
• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

檢索簽名欄位名稱

• 通過調用 SignatureServiceClient 物件 getSignatureFieldList 方法和傳遞 com.adobe.idp.Document 包含包含簽名欄位的PDF文檔的對象。 此方法會傳回 java.util.List 物件，其中每個元素包含 PDFSignatureField 物件。 使用此對象，可以獲取有關簽名欄位的其他資訊，如簽名欄位是否可見。
• 重複 java.util.List 用於確定是否存在簽名欄位名稱的對象。 對於PDF文檔中的每個簽名欄位，您可以獲得單獨的 PDFSignatureField 物件。 要獲取簽名欄位的名稱，請調用 PDFSignatureField 物件 getName 方法。 此方法會傳回指定簽名欄位名稱的字串值。

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

建立簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

獲取包含簽名欄位的PDF文檔

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象用於儲存包含簽名欄位的PDF文檔。
• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
• 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
• 填入 BLOB 對象，通過賦值 MTOM 欄位位位元組陣列內容。

檢索簽名欄位名稱

• 通過調用以檢索簽名欄位名稱 SignatureServiceClient 物件 getSignatureFieldList 方法和傳遞 BLOB 包含包含簽名欄位的PDF文檔的對象。 此方法會傳回 MyArrayOfPDFSignatureField 每個元素包含的集合物件 PDFSignatureField 物件。
• 重複 MyArrayOfPDFSignatureField 用於確定是否存在簽名欄位名稱的對象。 對於PDF文檔中的每個簽名欄位，您可以獲取 PDFSignatureField 物件。 要獲取簽名欄位的名稱，請調用 PDFSignatureField 物件 getName 方法。 此方法會傳回指定簽名欄位名稱的字串值。

包含項目檔案

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

建立簽名客戶端

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

獲取包含要修改的簽名欄位的PDF文檔

• 建立 java.io.FileInputStream 表示包含要修改的簽名欄位的PDF文檔的對象，方法是使用其建構子並傳遞一個字串值，該字串值指定PDF文檔的位置。
• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

設定字典值

• 建立 PDFSignatureFieldProperties 物件，使用其建構子。 A PDFSignatureFieldProperties 對象儲存簽名欄位鎖字典和種子值字典資訊。
• 建立 PDFSeedValueOptionSpec 物件，使用其建構子。 此物件可讓您設定種子值字典值。
• 禁止通過調用 PDFSeedValueOptionSpec 物件 setMdpValue 方法和傳遞 MDPPermissions.NoChanges 枚舉值。
• 建立 FieldMDPOptionSpec 物件，使用其建構子。 此對象允許您設定簽名欄位鎖定字典值。
• 調用以鎖定PDF文檔中的所有欄位 FieldMDPOptionSpec 物件 setMdpValue 方法和傳遞 FieldMDPAction.ALL 枚舉值。
• 調用 PDFSignatureFieldProperties 物件 setSeedValue 方法和傳遞 PDFSeedValueOptionSpec 物件。
• 通過調用 PDFSignatureFieldProperties物件 setFieldMDP 方法和傳遞 FieldMDPOptionSpec 物件。

修改簽名欄位

調用 SignatureServiceClient 物件 modifySignatureField 方法並傳遞下列值：

• 此 com.adobe.idp.Document 儲存包含要修改的簽名欄位的PDF文檔的對象
• 指定簽名欄位名稱的字串值
• 此 PDFSignatureFieldProperties 儲存簽名欄位鎖字典和種子值字典資訊的對象

此 modifySignatureField 方法傳回 com.adobe.idp.Document 儲存包含已修改簽名欄位的PDF文檔的對象。

將PDF文檔另存為PDF檔案

• 建立 java.io.File 物件，並確定副檔名為.pdf。
• 叫用 com.adobe.idp.Document 物件 copyToFile 複製內容的方法 com.adobe.idp.Document 物件。 請確定您使用 com.adobe.idp.Document 物件 modifySignatureField 方法傳回。

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

建立簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

獲取包含要修改的簽名欄位的PDF文檔

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象用於儲存包含要修改的簽名欄位的PDF文檔。
• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
• 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
• 填入 BLOB 對象，通過賦值 MTOM 屬性位元組陣列的內容。

設定字典值

• 建立 PDFSignatureFieldProperties 物件，使用其建構子。 該對象儲存簽名欄位鎖字典和種子值字典資訊。
• 建立 PDFSeedValueOptionSpec 物件，使用其建構子。 此物件可讓您設定種子值字典值。
• 通過指定 MDPPermissions.NoChanges 枚舉值 PDFSeedValueOptionSpec 物件 mdpValue 資料成員。
• 建立 FieldMDPOptionSpec 物件，使用其建構子。 此對象允許您設定簽名欄位鎖定字典值。
• 通過指定 FieldMDPAction.ALL 枚舉值 FieldMDPOptionSpec 物件 mdpValue 資料成員。
• 通過分配 PDFSeedValueOptionSpec 物件 PDFSignatureFieldProperties 物件 seedValue 資料成員。
• 通過分配 FieldMDPOptionSpec 物件 PDFSignatureFieldProperties 物件 fieldMDP 資料成員。

修改簽名欄位

調用 SignatureServiceClient 物件 modifySignatureField 方法並傳遞下列值：

• 此 BLOB 儲存包含要修改的簽名欄位的PDF文檔的對象
• 指定簽名欄位名稱的字串值
• 此 PDFSignatureFieldProperties 儲存簽名欄位鎖字典和種子值字典資訊的對象

此 modifySignatureField 方法傳回 BLOB 儲存包含已修改簽名欄位的PDF文檔的對象。

將PDF文檔另存為PDF檔案

• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示將包含簽名欄位的PDF文檔的檔案位置，以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 BLOB 物件 addSignatureField 方法會傳回。 取得 BLOB 物件 MTOM 資料成員。
• 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
• 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案，如adobe-signatures-client.jar。

建立簽名客戶端

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

取得要簽署的PDF檔案

• 建立 java.io.FileInputStream 用其建構子並傳遞指定PDF文檔位置的字串值來表示要數字簽名的PDF文檔的對象。
• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

簽署PDF檔案

叫用PDF檔案 SignatureServiceClient 物件 sign 方法並傳遞下列值：

• A com.adobe.idp.Document 表示要簽名的PDF文檔的對象。
• 表示將包含數字簽名的簽名欄位的名稱的字串值。
• A Credential 表示用於對PDF文檔進行數字簽名的憑據的對象。 建立 Credential 對象，方法是調用 Credential 對象的靜態 getInstance 方法，並傳遞指定與安全憑據對應的別名值的字串值。
• A HashAlgorithm 指定靜態資料成員的對象，該靜態資料成員表示用於摘要PDF文檔的哈希算法。 例如，您可以指定 HashAlgorithm.SHA1 來使用SHA1演算法。
• 代表PDF檔案進行數位簽署原因的字串值。
• 表示簽名者聯繫資訊的字串值。
• A PDFSignatureAppearanceOptions 控制數字簽名外觀的對象。 例如，您可以使用此物件將自訂標誌新增至數位簽名。
• A java.lang.Boolean 指定是否對簽名者的證書執行吊銷檢查的對象。
• 安 OCSPOptionSpec 儲存線上證書狀態協定(OCSP)支援首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A CRLPreferences 儲存證書吊銷清單(CRL)首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A TSPPreferences 儲存時間戳提供程式(TSP)支援偏好設定的物件。 此參數為選用參數，可以是 null. 如需詳細資訊，請參閱 AEM Forms API參考.

此 sign 方法傳回 com.adobe.idp.Document 表示簽名PDF文檔的對象。

保存已簽名的PDF文檔

• 建立 java.io.File 物件，並確定副檔名為.pdf。
• 叫用 com.adobe.idp.Document 物件 copyToFile 方法和傳遞 java.io.File複製 Document 物件。 請確定您使用 com.adobe.idp.Document 由傳回的物件 sign 方法。

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

建立簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

取得要簽署的PDF檔案

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象用於儲存已簽名的PDF文檔。
• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示要簽名的PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
• 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
• 填入 BLOB 對象，通過賦值 MTOM 屬性位元組陣列的內容。

簽署PDF檔案

叫用PDF檔案 SignatureServiceClient 物件 sign 方法並傳遞下列值：

• A BLOB 表示要簽名的PDF文檔的對象。
• 表示將包含數字簽名的簽名欄位的名稱的字串值。
• A Credential 表示用於對PDF文檔進行數字簽名的憑據的對象。 建立 Credential 對象，使用其建構子，並通過為 Credential 物件 alias 屬性。
• A HashAlgorithm 指定靜態資料成員的對象，該靜態資料成員表示用於摘要PDF文檔的哈希算法。 例如，您可以指定 HashAlgorithm.SHA1 來使用SHA1演算法。
• 一個布林值，指定是否使用哈希算法。
• 代表PDF檔案進行數位簽署原因的字串值。
• 代表簽署者位置的字串值。
• 表示簽名者聯繫資訊的字串值。
• A PDFSignatureAppearanceOptions 控制數字簽名外觀的對象。 例如，您可以使用此物件將自訂標誌新增至數位簽名。
• A System.Boolean 指定是否對簽名者的證書執行吊銷檢查的對象。 如果完成了此吊銷檢查，則它嵌入到簽名中。 預設為 false。
• 安 OCSPOptionSpec 儲存線上證書狀態協定(OCSP)支援首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null. 如需此物件的相關資訊，請參閱 AEM Forms API參考.
• A CRLPreferences 儲存證書吊銷清單(CRL)首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A TSPPreferences 儲存時間戳提供程式(TSP)支援偏好設定的物件。 此參數為選用參數，可以是 null.

此 sign 方法傳回 BLOB 表示簽名PDF文檔的對象。

保存已簽名的PDF文檔

• 建立 System.IO.FileStream 對象，方法是調用其建構子。 傳遞一個字串值，該字串值表示已簽名PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 BLOB 由傳回的物件 sign 方法。 取得 BLOB 物件 MTOM 資料成員。
• 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
• 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案，如adobe-signatures-client.jar和adobe-forms-client.jar。

建立Forms和簽名客戶端

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

使用Forms服務取得互動式表單

• 建立 java.io.FileInputStream 代表PDF檔案的物件，可使用其建構函式傳遞至Forms服務。 傳遞指定PDF文檔位置的字串值。

• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

• 建立 java.io.FileInputStream 表示包含表單資料的XML檔案的物件，可透過其建構函式傳遞至Forms服務。 傳遞指定XML檔案位置的字串值。

• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

• 建立 PDFFormRenderSpec 用於設定運行時選項的對象。 叫用 PDFFormRenderSpec 物件 setGenerateServerAppearance 方法和傳遞 true.

• 叫用 FormsServiceClient 物件 renderPDFForm2 方法，並傳遞下列值：

  • A com.adobe.idp.Document 包含要呈現的PDF表單的對象。
  • A com.adobe.idp.Document 包含要與表單合併資料的物件。
  • A PDFFormRenderSpec 儲存運行時選項的對象。
  • A URLSpec 包含Forms服務所需URI值的物件。 您可以指定 null ，以取得此參數值。
  • A java.util.HashMap 儲存檔案附件的物件。 這是選用參數，您可以指定 null 如果您不想將檔案附加到表單。

  此 renderPDFForm2 方法傳回 FormsResult 包含表單資料流的物件

• 叫用以擷取PDF表單 FormsResult 物件 getOutputContent 方法。 此方法會傳回 com.adobe.idp.Document 代表互動式表單的物件。

簽署互動式表單

叫用PDF檔案 SignatureServiceClient 物件 sign 方法並傳遞下列值：

• A com.adobe.idp.Document 表示要簽名的PDF文檔的對象。 請確定此物件為 com.adobe.idp.Document 從Forms服務取得的物件。
• 表示簽名欄位名稱的字串值。
• A Credential 表示用於對PDF文檔進行數字簽名的憑據的對象。 建立 Credential 對象，方法是調用 Credential 對象的靜態 getInstance 方法。 傳遞一個字串值，該字串值指定與安全憑據對應的別名值。
• A HashAlgorithm 指定靜態資料成員的對象，該靜態資料成員表示用於摘要PDF文檔的哈希算法。 例如，您可以指定 HashAlgorithm.SHA1 來使用SHA1演算法。
• 代表PDF檔案進行數位簽署原因的字串值。
• 表示簽名者聯繫資訊的字串值。
• A PDFSignatureAppearanceOptions 控制數字簽名外觀的對象。 例如，您可以使用此物件將自訂標誌新增至數位簽名。
• A java.lang.Boolean 指定是否對簽名者的證書執行吊銷檢查的對象。
• 安 OCSPPreferences 儲存線上證書狀態協定(OCSP)支援首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A CRLPreferences 儲存證書吊銷清單(CRL)首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A TSPPreferences 儲存時間戳提供程式(TSP)支援偏好設定的物件。 此參數為選用參數，可以是 null.

此 sign 方法傳回 com.adobe.idp.Document 表示簽名PDF文檔的對象。

保存已簽名的PDF文檔

• 建立 java.io.File 物件，並確定副檔名為.pdf。
• 叫用 com.adobe.idp.Document 物件 copyToFile 方法和傳遞 java.io.File複製 Document 物件。 請確定您使用 com.adobe.idp.Document 物件 sign 方法傳回。

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 由於此客戶端應用程式調用了兩個AEM Forms服務，因此請建立兩個服務引用。 為與簽名服務關聯的服務引用使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

為與Forms服務關聯的服務引用使用以下WSDL定義： http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

因為 BLOB 資料類型是兩個服務參考的共同類型，完全限定 BLOB 資料類型。 在相應的Web服務快速入門中，所有 BLOB 例項已完全限定。

建立Forms和簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.

• 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

使用Forms服務取得互動式表單

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象用於儲存已簽名的PDF文檔。

• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示要簽名的PDF文檔的檔案位置以及開啟檔案的模式。

• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。

• 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。

• 填入 BLOB 對象，通過賦值 MTOM 屬性位元組陣列的內容。

• 建立 BLOB 物件，使用其建構子。 此 BLOB 物件可用來儲存表單資料。

• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示包含表單資料的XML檔案的檔案位置，以及開啟檔案的模式。

• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。

• 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。

• 填入 BLOB 對象，通過賦值 MTOM 屬性位元組陣列的內容。

• 建立 PDFFormRenderSpec 用於設定運行時選項的對象。 指派值 true 到 PDFFormRenderSpec 物件 generateServerAppearance 欄位。

• 叫用 FormsServiceClient 物件 renderPDFForm2 方法，並傳遞下列值：

  • A BLOB 包含要呈現的PDF表單的對象。
  • A BLOB 包含要與表單合併資料的物件。
  • A PDFFormRenderSpec 儲存運行時選項的對象。
  • A URLSpec 包含Forms服務所需URI值的物件。 您可以指定 null ，以取得此參數值。
  • A java.util.HashMap 儲存檔案附件的物件。 這是選用參數，您可以指定 null 如果您不想將檔案附加到表單。
  • 長輸出參數，用於儲存表單中的頁數。
  • 用於地區設定值的字串輸出參數。
  • A FormResult 值，此為用於儲存互動式表單的輸出參數。

• 叫用PDF表單 FormsResult 物件 outputContent 欄位。 此欄位會儲存 BLOB 代表互動式表單的物件。

簽署互動式表單

叫用PDF檔案 SignatureServiceClient 物件 sign 方法並傳遞下列值：

• A BLOB 表示要簽名的PDF文檔的對象。 使用 BLOB 由Forms服務傳回的例項。
• 表示簽名欄位名稱的字串值。
• A Credential 表示用於對PDF文檔進行數字簽名的憑據的對象。 建立 Credential 對象，使用其建構子，並通過為 Credential 物件 alias 屬性。
• A HashAlgorithm 指定靜態資料成員的對象，該靜態資料成員表示用於摘要PDF文檔的哈希算法。 例如，您可以指定 HashAlgorithm.SHA1 來使用SHA1演算法。
• 一個布林值，指定是否使用哈希算法。
• 代表PDF檔案進行數位簽署原因的字串值。
• 代表簽署者位置的字串值。
• 表示簽名者聯繫資訊的字串值。
• A PDFSignatureAppearanceOptions 控制數字簽名外觀的對象。 例如，您可以使用此物件將自訂標誌新增至數位簽名。
• A System.Boolean 指定是否對簽名者的證書執行吊銷檢查的對象。 如果完成了此吊銷檢查，則它嵌入到簽名中。 預設為 false。
• 安 OCSPPreferences 儲存線上證書狀態協定(OCSP)支援首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null. 如需此物件的相關資訊，請參閱 AEM Forms API參考.
• A CRLPreferences 儲存證書吊銷清單(CRL)首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A TSPPreferences 儲存時間戳提供程式(TSP)支援偏好設定的物件。 此參數為選用參數，可以是 null.

此 sign 方法傳回 BLOB 表示簽名PDF文檔的對象。

保存已簽名的PDF文檔

• 建立 System.IO.FileStream 對象，方法是調用其建構子。 傳遞一個字串值，該字串值表示已簽名PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 BLOB 由傳回的物件 sign 方法。 取得 BLOB 物件 MTOM 資料成員。
• 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
• 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

包含項目檔案

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

建立簽名客戶端

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

取得PDF檔案以進行認證

• 建立 java.io.FileInputStream 表示要認證的PDF文檔的對象，使用其建構子並傳遞指定PDF文檔位置的字串值。
• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

認證PDF檔案

叫用以驗證PDF檔案 SignatureServiceClient 物件 certify 方法並傳遞下列值：

• 此 com.adobe.idp.Document 表示要認證的PDF文檔的對象。
• 表示將包含簽名的簽名欄位的名稱的字串值。
• A Credential 表示用於驗證PDF文檔的憑據的對象。 建立 Credential 對象，方法是調用 Credential 對象的靜態 getInstance 方法，並傳遞指定與安全憑據對應的別名值的字串值。
• A HashAlgorithm 指定靜態資料成員的對象，該靜態資料成員表示用於摘要PDF文檔的哈希算法。 例如，您可以指定 HashAlgorithm.SHA1 來使用SHA1演算法。
• 表示PDF文檔被認證原因的字串值。
• 表示簽名者聯繫資訊的字串值。
• A MDPPermissions 對象，指定可在PDF文檔上執行的使簽名失效的操作。
• A PDFSignatureAppearanceOptions 控制認證簽名外觀的對象。 如果需要，通過調用方法(如 setShowDate.
• 字串值，可說明使簽名無效的動作。
• A java.lang.Boolean 指定是否對簽名者的證書執行吊銷檢查的對象。 如果完成了此吊銷檢查，則它嵌入到簽名中。 預設為 false。
• A java.lang.Boolean 指定是否鎖定要認證的簽名欄位的對象。 如果欄位被鎖定，則簽名欄位被標籤為只讀，其屬性無法修改，並且沒有必需權限的任何人無法清除該欄位。 預設為 false。
• 安 OCSPPreferences 儲存線上證書狀態協定(OCSP)支援首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null. 有關此對象的資訊，請參閱 AEM Forms API參考.
• A CRLPreferences 儲存證書吊銷清單(CRL)首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A TSPPreferences 儲存時間戳提供程式(TSP)支援偏好設定的物件。 例如，在您建立 TSPPreferences 物件，您可以叫用 TSPPreferences 物件 setTspServerURL 方法。 此參數為選用參數，可以是 null. 如需詳細資訊，請參閱 AEM Forms服務參考.

此 certify 方法傳回 com.adobe.idp.Document 表示經認證的PDF文檔的對象。

將認證的PDF文檔另存為PDF檔案

• 建立 java.io.File 物件，並確定副檔名為.pdf。
• 叫用 com.adobe.idp.Document 物件 copyToFile 複製內容的方法 com.adobe.idp.Document 物件。

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

建立簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

取得PDF檔案以進行認證

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象用於儲存經認證的PDF文檔。
• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示要認證的PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
• 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
• 填入 BLOB 對象，通過賦值 MTOM 資料成員是位元組陣列的內容。

認證PDF檔案

叫用以驗證PDF檔案 SignatureServiceClient 物件 certify 方法並傳遞下列值：

• 此 BLOB 表示要認證的PDF文檔的對象。
• 表示將包含簽名的簽名欄位的名稱的字串值。
• A Credential 表示用於驗證PDF文檔的憑據的對象。 建立 Credential 對象（使用其建構子），並通過為 Credential 物件 alias 屬性。
• A HashAlgorithm 指定靜態資料成員的對象，該靜態資料成員表示用於摘要PDF文檔的哈希算法。 例如，您可以指定 HashAlgorithm.SHA1 來使用SHA1演算法。
• 一個布林值，指定是否使用哈希算法。
• 表示PDF文檔被認證原因的字串值。
• 代表簽署者位置的字串值。
• 表示簽名者聯繫資訊的字串值。
• 安 MDPPermissions 對象的靜態資料成員，該成員指定可對使簽名無效的PDF文檔執行的操作。
• 一個布林值，它指定是否使用 MDPPermissions 以上一個參數值傳遞的物件。
• 一個字串值，說明使簽名無效的操作。
• A PDFSignatureAppearanceOptions 控制認證簽名外觀的對象。 建立 PDFSignatureAppearanceOptions 物件，使用其建構子。 可以通過設定簽名的一個資料成員來修改簽名的外觀。
• A System.Boolean 指定是否對簽名者的證書執行吊銷檢查的對象。 如果完成了此吊銷檢查，則它嵌入到簽名中。 預設為 false。
• A System.Boolean 指定是否鎖定要認證的簽名欄位的對象。 如果欄位被鎖定，則簽名欄位被標籤為只讀，其屬性無法修改，並且沒有必需權限的任何人無法清除該欄位。 預設為 false。
• A System.Boolean 指定是否鎖定簽名欄位的對象。 就是說，如果你通過 true 轉入上一個參數，然後傳入 true 到此參數。
• 安 OCSPPreferences 用於儲存線上證書狀態協定(OCSP)支援首選項的對象，該協定提供有關用於驗證PDF文檔的憑據的狀態的資訊。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A CRLPreferences 儲存證書吊銷清單(CRL)首選項的對象。 如果未完成吊銷檢查，則不使用此參數，您可以指定 null.
• A TSPPreferences 儲存時間戳提供程式(TSP)支援偏好設定的物件。 例如，在您建立 TSPPreferences 物件，您可以設定 TSPPreferences 物件 tspServerURL 資料成員。 此參數為選用參數，可以是 null.

此 certify 方法傳回 BLOB 表示經認證的PDF文檔的對象。

將認證的PDF文檔另存為PDF檔案

• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示將包含經認證的PDF文檔的PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 BLOB 由傳回的物件 certify 方法。 取得 BLOB 物件 binaryData 資料成員。
• 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
• 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案，如adobe-signatures-client.jar。

建立簽名客戶端

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

獲取包含要驗證的簽名的PDF文檔

• 建立 java.io.FileInputStream 表示包含要使用其建構子驗證的簽名的PDF文檔的對象。 傳遞指定PDF文檔位置的字串值。
• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

設定PKI運行時選項

• 建立 PKIOptions 物件，使用其建構子。
• 調用 PKIOptions 物件 setVerificationTime 方法和傳遞 VerificationTime 指定驗證時間的枚舉值。
• 通過調用 PKIOptions 物件 setRevocationCheckStyle 方法和傳遞 RevocationCheckStyle 指定是否執行吊銷檢查的枚舉值。

驗證數字簽名

叫用 SignatureServiceClient 物件 verify2 方法並傳遞下列值：

• A com.adobe.idp.Document 包含數字簽名或認證的PDF文檔的對象。
• 表示包含要驗證的簽名的簽名欄位名稱的字串值。
• A PKIOptions 包含PKI運行時選項的對象。
• A VerifySPIOptions 包含SPI資訊的實例。 您可以指定 null 的URL。

此 verify2 方法傳回 PDFSignatureVerificationInfo 包含可用於驗證數字簽名的資訊的對象。

確定簽名的狀態

• 通過調用 PDFSignatureVerificationInfo 物件 getStatus 方法。 此方法會傳回 SignatureStatus 指定簽名狀態的對象。 例如，如果未修改簽名的PDF文檔，則此方法將返回 SignatureStatus.DocumentSigNoChanges.

確定簽名者的身份

• 叫用 PDFSignatureVerificationInfo 物件 getSigner 方法。 此方法會傳回 IdentityInformation 物件。
• 叫用 IdentityInformation 物件 getStatus 確定簽名者身份的方法。 此方法會傳回 IdentityStatus 指定身分的枚舉值。 例如，如果簽名者受信任，則此方法會傳回 IdentityStatus.TRUSTED.

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

建立簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

獲取包含要驗證的簽名的PDF文檔

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象用於儲存包含要驗證的數字或認證簽名的PDF文檔。
• 建立 System.IO.FileStream 對象，方法是調用其建構子。 傳遞一個字串值，該字串值表示已簽名PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
• 叫用 System.IO.FileStream 物件 Read 方法。 傳遞位元組陣列、起始位置和資料流長度以讀取。
• 填入 BLOB 對象，通過賦值 MTOM 屬性位元組陣列的內容。

設定PKI運行時選項

• 建立 PKIOptions 物件，使用其建構子。
• 通過分配 PKIOptions 物件 verificationTime 資料成員 VerificationTime 指定驗證時間的枚舉值。
• 通過分配 PKIOptions 物件 revocationCheckStyle 資料成員 RevocationCheckStyle 指定是否執行吊銷檢查的枚舉值。

驗證數字簽名

叫用 SignatureServiceClient 物件 verify2 方法並傳遞下列值：

• 此 BLOB 包含數字簽名或認證的PDF文檔的對象。
• 表示包含要驗證的簽名的簽名欄位名稱的字串值。
• A PKIOptions 包含PKI運行時選項的對象。
• A VerifySPIOptions 包含SPI資訊的實例。 您可以指定 null 的URL。

此 verify2 方法傳回 PDFSignatureVerificationInfo 包含可用於驗證數字簽名的資訊的對象。

確定簽名的狀態

通過獲取 PDFSignatureVerificationInfo 物件 status 資料成員。 此資料成員儲存 SignatureStatus 指定簽名狀態的對象。 例如，如果修改了已簽名的PDF文檔，則 status 資料成員儲存值 SignatureStatus.DocumentSigNoChanges.

確定簽名者的身份

• 通過檢索 PDFSignatureVerificationInfo 物件 signer 資料成員。 此成員返回 IdentityInformation 物件。
• 擷取 IdentityInformation 物件 status 確定簽名者身份的資料成員。 此資料成員返回 IdentityStatus 指定身分的枚舉值。 例如，如果簽名者受信任，則此成員返回 IdentityStatus.TRUSTED.

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案，如adobe-signatures-client.jar。

建立簽名客戶端

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

獲取包含要驗證的簽名的PDF文檔

• 建立 java.io.FileInputStream 表示包含多個數字簽名的PDF文檔的對象，要使用其建構子進行驗證。 傳遞指定PDF文檔位置的字串值。
• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

設定PKI運行時選項

• 建立 PKIOptions 物件，使用其建構子。
• 調用 PKIOptions 物件 setVerificationTime 方法和傳遞 VerificationTime 指定驗證時間的枚舉值。
• 通過調用 PKIOptions 物件 setRevocationCheckStyle 方法和傳遞 RevocationCheckStyle 指定是否執行吊銷檢查的枚舉值。

檢索所有數字簽名

叫用 SignatureServiceClient 物件 verifyPDFDocument 方法，並傳遞下列值：

• A com.adobe.idp.Document 包含包含多個數字簽名的PDF文檔的對象。
• A PKIOptions 包含PKI運行時選項的對象。
• A VerifySPIOptions 包含SPI資訊的實例。 您可以指定 null 的URL。

此 verifyPDFDocument 方法傳回 PDFDocumentVerificationInfo 包含PDF文檔中所有數字簽名資訊的對象。

重複查看所有簽名

• 叫用 PDFDocumentVerificationInfo 物件 getVerificationInfos 方法。 此方法會傳回 java.util.List 其中每個元素都是 PDFSignatureVerificationInfo 物件。 使用 java.util.Iterator 物件，以逐一查看簽名清單。
• 使用 PDFSignatureVerificationInfo 對象，您可以通過調用 PDFSignatureVerificationInfo 物件 getStatus 方法。 此方法會傳回 SignatureStatus 靜態資料成員通知您簽名的狀態的對象。 例如，如果簽名未知，則此方法返回 SignatureStatus.DocumentSignatureUnknown.

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

建立簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

獲取包含要驗證的簽名的PDF文檔

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象儲存包含多個數字簽名以驗證的PDF文檔。
• 建立 System.IO.FileStream 對象，方法是調用其建構子。 傳遞一個字串值，該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
• 叫用 System.IO.FileStream 物件 Read 方法。 傳遞位元組陣列、起始位置和資料流長度以讀取。
• 填入 BLOB 對象，通過賦值 MTOM 屬性位元組陣列的內容。

設定PKI運行時選項

• 建立 PKIOptions 物件，使用其建構子。
• 通過分配 PKIOptions 物件 verificationTime 資料成員 VerificationTime 指定驗證時間的枚舉值。
• 通過分配 PKIOptions 物件 revocationCheckStyle 資料成員 RevocationCheckStyle 指定是否執行吊銷檢查的枚舉值。

檢索所有數字簽名

叫用 SignatureServiceClient 物件 verifyPDFDocument 方法，並傳遞下列值：

• A BLOB 包含包含多個數字簽名的PDF文檔的對象。
• A PKIOptions 包含PKI運行時選項的對象。
• A VerifySPIOptions 包含SPI資訊的實例。 可以為此參數指定null。

此 verifyPDFDocument 方法傳回 PDFDocumentVerificationInfo 包含PDF文檔中所有數字簽名資訊的對象。

重複查看所有簽名

• 透過取得 PDFDocumentVerificationInfo 物件 verificationInfos 資料成員。 此資料成員返回 Object 陣列，其中每個元素都是 PDFSignatureVerificationInfo 物件。
• 使用 PDFSignatureVerificationInfo 對象，您可以通過獲取 PDFSignatureVerificationInfo 物件 status 資料成員。 此資料成員返回 SignatureStatus 靜態資料成員通知您簽名的狀態的對象。 例如，如果簽名未知，則此方法返回 SignatureStatus.DocumentSignatureUnknown.

包含項目檔案

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

建立簽名客戶端。

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

獲取包含要刪除的簽名的PDF文檔

• 建立 java.io.FileInputStream 表示包含要刪除的簽名的PDF文檔的對象，方法是使用其建構子並傳遞一個字串值，該字串值指定PDF文檔的位置。
• 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。

從簽名欄位中刪除數字簽名

叫用 SignatureServiceClient 物件 clearSignatureField 方法並傳遞下列值：

• A com.adobe.idp.Document 表示包含要刪除的簽名的PDF文檔的對象。
• 一個字串值，它指定包含數字簽名的簽名欄位的名稱。

此 clearSignatureField 方法傳回 com.adobe.idp.Document 表示從中刪除數字簽名的PDF文檔的對象。

將PDF文檔另存為PDF檔案

• 建立 java.io.File 物件，並確定副檔名為.pdf。
• 叫用 com.adobe.idp.Document 物件 copyToFile 方法。 傳遞 java.io.File 要複製 com.adobe.idp.Document 物件。 請確定您使用 Document 由傳回的物件 clearSignatureField 方法。

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

建立簽名客戶端

• 建立 SignatureServiceClient 物件，使用其預設建構函式。

• 建立 SignatureServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/SignatureService?WSDL)。 您不需要使用 lc_version 屬性。 建立服務參考時會使用此屬性。)

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 SignatureServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 SignatureServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 SignatureServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

獲取包含要刪除的簽名的PDF文檔

• 建立 BLOB 物件，使用其建構子。 此 BLOB 對象用於儲存包含要刪除的數字簽名的PDF文檔。
• 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示已簽名PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
• 叫用 System.IO.FileStream 物件 Read 方法。 傳遞位元組陣列、起始位置和資料流長度以讀取。
• 填入 BLOB 對象，通過賦值 MTOM 屬性（包含位元組陣列的內容）。

從簽名欄位中刪除數字簽名

叫用 SignatureServiceClient 物件 clearSignatureField 方法並傳遞下列值：

• A BLOB 包含簽名PDF文檔的對象。
• 一個字串值，它表示包含要刪除的數字簽名的簽名欄位的名稱。

此 clearSignatureField 方法傳回 BLOB 表示從中刪除數字簽名的PDF文檔的對象。

將PDF文檔另存為PDF檔案

• 建立 System.IO.FileStream 對象，方法是調用其建構子，並傳遞一個字串值，該字串值表示包含空簽名欄位的PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 BLOB 由傳回的物件 sign 方法。 取得 BLOB 物件 MTOM 資料成員。
• 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
• 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。