數位簽署和認證檔案 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 物件，指定將數位簽章套用至簽章欄位時鎖定的欄位。

• 透過叫用將簽名欄位新增到PDF檔案 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 包含位元組陣列內容的屬性。

新增簽名欄位

透過叫用將簽名欄位新增到PDF檔案 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 物件。
• 透過叫用將位元組陣列的內容寫入PDF檔案 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 物件（使用其建構函式）。 此物件可讓您設定種子值字典值。
• 不允許透過叫用變更PDF檔案 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 物件（使用其建構函式）。 此物件可讓您設定種子值字典值。
• 透過指派禁止變更PDF檔案 MDPPermissions.NoChanges 列舉值至 PDFSeedValueOptionSpec 物件的 mdpValue 資料成員。
• 建立 FieldMDPOptionSpec 物件（使用其建構函式）。 此物件可讓您設定簽章欄位鎖定字典值。
• 透過指派以下專案來鎖定PDF檔案中的所有欄位： 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 物件。
• 透過叫用將位元組陣列的內容寫入PDF檔案 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演演算法。
• Boolean值，指定是否使用雜湊演演算法。
• 字串值，代表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 物件。
• 透過叫用將位元組陣列的內容寫入PDF檔案 System.IO.BinaryWriter 物件的 Write 方法並傳遞位元組陣列。

包含專案檔案

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

建立Forms和簽名使用者端

• 建立 ServiceClientFactory 包含連線屬性的物件。
• 建立 SignatureServiceClient 物件，使用它的建構函式並傳遞 ServiceClientFactory 物件。
• 建立 FormsServiceClient 物件，使用它的建構函式並傳遞 ServiceClientFactory 物件。

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

• 建立 java.io.FileInputStream 物件，代表使用建構函式傳遞至Forms服務的PDF檔案。 傳遞字串值，指定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定義作為與Signature服務相關的服務參考： http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

使用下列WSDL定義作為與Forms服務相關的服務參考： 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演演算法。
• Boolean值，指定是否使用雜湊演演算法。
• 字串值，代表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 物件。
• 透過叫用將位元組陣列的內容寫入PDF檔案 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演演算法。
• Boolean值，指定是否使用雜湊演演算法。
• 代表驗證PDF檔案之原因的字串值。
• 代表簽署者位置的字串值。
• 代表簽署者聯絡資訊的字串值。
• 一個 MDPPermissions 物件的靜態資料成員，指定可在PDF檔案上執行的使簽章失效的動作。
• Boolean值，指定是否使用 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 物件，您可以設定TSP的URL TSPPreferences 物件的 tspServerURL 資料成員。 此引數為選用引數，可以是 null.

此 certify 方法傳回 BLOB 代表已驗證PDF檔案的物件。

將認證的PDF檔案儲存為PDF檔案

• 建立 System.IO.FileStream 物件，方法為叫用其建構函式，並傳遞字串值，該值代表PDF檔案的檔案位置，其中將包含認證的PDF檔案以及開啟檔案的模式。
• 建立位元組陣列，儲存 BLOB 物件，由 certify 方法。 透過取得 BLOB 物件的 binaryData 資料成員。
• 建立 System.IO.BinaryWriter 物件，方法是叫用其建構函式，然後傳遞 System.IO.FileStream 物件。
• 透過叫用將位元組陣列的內容寫入PDF檔案 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 此引數的。

此 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 資料成員a VerificationTime 指定驗證時間的列舉值。
• 透過指定 PKIOptions 物件的 revocationCheckStyle 資料成員a RevocationCheckStyle 指定是否執行撤銷檢查的列舉值。

驗證數位簽名

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

• 此 BLOB 包含數位簽署或認證的PDF檔案的物件。
• 字串值，代表包含要驗證之簽章的簽章欄位名稱。
• A PKIOptions 包含PKI執行階段選項的物件。
• A VerifySPIOptions 包含SPI資訊的執行個體。 您可以指定 null 此引數的。

此 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 此引數的。

此 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 資料成員a VerificationTime 指定驗證時間的列舉值。
• 透過指派以下專案來設定撤銷檢查選項 PKIOptions 物件的 revocationCheckStyle 資料成員a 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 物件。
• PDF透過叫用 System.IO.BinaryWriter 物件的 Write 方法並傳遞位元組陣列。