Digitally Signing and Certifying Documents

Include project files

Include client JAR files, such as adobe-signatures-client.jar, in your Java project’s classpath.

Create a Signature client

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.

Get a PDF document to which a signature field is added

• Create a java.io.FileInputStream object that represents the PDF document to which a signature field is added by using its constructor and passing a string value that specifies the location of the PDF document.
• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

Add a signature field

• Create a PositionRectangle object that specifies the signature field location by using its constructor. Within the constructor, specify coordinate values.

• If desired, create a FieldMDPOptions object that specifies the fields that are locked when a digital signature is applied to the signature field.

• Add a signature field to a PDF document by invoking the SignatureServiceClient object’s addSignatureField method and passing the following values:

  • A com.adobe.idp. Document object that represents the PDF document to which a signature field is added.
  • A string value that specifies the name of the signature field.
  • A java.lang.Integer value that represents the page number to which a signature field is added.
  • A PositionRectangle object that specifies the location of the signature field.
  • A FieldMDPOptions object that specifies fields in the PDF document that are locked after a digital signature is applied to the signature field. This parameter value is optional, and you can pass null.

• A PDFSeedValueOptions object that specifies various run-time values. This parameter value is optional, and you can pass null.

  The addSignatureField method returns a com.adobe.idp. Document object that represents a PDF document that contains a signature field.

NOTE

You can invoke the SignatureServiceClient object’s addInvisibleSignatureField method to add an invisible signature field.

Save the PDF document as a PDF file

• Create a java.io.File object and ensure that the file extension is .pdf.
• Invoke the com.adobe.idp. Document object’s copyToFile method to copy the contents of the Document object to the file. Ensure that you use the com.adobe.idp. Document object that was returned by the addSignatureField method.

Include project files

Create a Microsoft .NET project that uses MTOM. Ensure that you use the following WSDL definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create a Signature client

• Create a SignatureServiceClient object by using its default constructor.

• Create a SignatureServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/SignatureService?WSDL). You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

• Create a System.ServiceModel.BasicHttpBinding object by getting the value of the SignatureServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding.

• Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom. This value ensures that MTOM is used.

• Enable basic HTTP authentication by performing the following tasks:

  • Assign the AEM forms user name to the field SignatureServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field SignatureServiceClient.ClientCredentials.UserName.Password.
  • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode.

Get a PDF document to which a signature field is added

• Create a BLOB object by using its constructor. The BLOB object is used to store the PDF document that will contain a signature field.
• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method and passing the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM property with the contents of the byte array.

Add a signature field

Add a signature field to the PDF document by invoking the SignatureServiceClient object’s addSignatureField method and passing the following values:

• A BLOB object that represents the PDF document to which a signature field is added.
• A string value that specifies the signature field name.
• An integer value that represents the page number to which a signature field is added.
• A PositionRect object that specifies the location of the signature field.
• A FieldMDPOptions object that specifies fields in the PDF document that are locked after a digital signature is applied to the signature field. This parameter value is optional, and you can pass null.
• A PDFSeedValueOptions object that specifies various run-time values. This parameter value is optional, and you can pass null.

The addSignatureField method returns a BLOB object that represents a PDF document that contains a signature field.

Save the PDF document as a PDF file

• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document that will contain the signature field and the mode in which to open the file.
• Create a byte array that stores the content of the BLOB object that was returned by the addSignatureField method. Populate the byte array by getting the value of the BLOB object’s binaryData data member.
• Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
• Write the contents of the byte array to a PDF file by invoking the System.IO.BinaryWriter object’s Write method and passing the byte array.

Include project files

Include client JAR files, such as the adobe-signatures-client.jar, in your Java project’s classpath.

Create a Signature client

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.

Get the PDF document that contains signature fields

• Create a java.io.FileInputStream object that represents the PDF document that contains signature fields by using its constructor and passing a string value that specifies the location of the PDF document.
• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

Retrieve the signature field names

• Retrieve the signature field names by invoking the SignatureServiceClient object’s getSignatureFieldList method and passing the com.adobe.idp.Document object that contains the PDF document that contains signature fields. This method returns a java.util.List object, in which each element contains a PDFSignatureField object. Using this object, you can obtain additional information about a signature field, such as whether it is visible.
• Iterate through the java.util.List object to determine if there are signature field names. For each signature field in the PDF document, you can obtain a separate PDFSignatureField object. To obtain the name of the signature field, invoke the PDFSignatureField object’s getName method. This method returns a string value that specifies the signature field name.

Include project files

Create a Microsoft .NET project that uses MTOM. Ensure that you use the following WSDL definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create a Signature client

• Create a SignatureServiceClient object by using its default constructor.

• Create a SignatureServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/SignatureService?WSDL). You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

• Create a System.ServiceModel.BasicHttpBinding object by getting the value of the SignatureServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding.

• Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom. This value ensures that MTOM is used.

• Enable basic HTTP authentication by performing the following tasks:

  • Assign the AEM forms user name to the field SignatureServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field SignatureServiceClient.ClientCredentials.UserName.Password.
  • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode.

Get the PDF document that contains signature fields

• Create a BLOB object by using its constructor. The BLOB object is used to store the PDF document that contains signature fields.
• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method and passing the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM field the byte array contents.

Retrieve the signature field names

• Retrieve the signature field names by invoking SignatureServiceClient object’s getSignatureFieldList method and passing the BLOB object that contains the PDF document that contains signature fields. This method returns a MyArrayOfPDFSignatureField collection object where each element contains a PDFSignatureField object.
• Iterate through the MyArrayOfPDFSignatureField object to determine whether there are signature field names. For each signature field in the PDF document, you can obtain a PDFSignatureField object. To obtain the name of the signature field, invoke the PDFSignatureField object’s getName method. This method returns a string value that specifies the signature field name.

Include project files

Include client JAR files, such as the adobe-signatures-client.jar, in your Java project’s class path.

Create a Signature client

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.

Get the PDF document that contains the signature field to modify

• Create a java.io.FileInputStream object that represents the PDF document that contains the signature field to modify by using its constructor and passing a string value that specifies the location of the PDF document.
• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

Set dictionary values

• Create a PDFSignatureFieldProperties object by using its constructor. A PDFSignatureFieldProperties object stores signature field lock dictionary and seed value dictionary information.
• Create a PDFSeedValueOptionSpec object by using its constructor. This object lets you set seed value dictionary values.
• Disallow changes to the PDF document by invoking the PDFSeedValueOptionSpec object’s setMdpValue method and passing the MDPPermissions.NoChanges enumeration value.
• Create a FieldMDPOptionSpec object by using its constructor. This object lets you set signature field lock dictionary values.
• Lock all fields in the PDF document by invoking the FieldMDPOptionSpec object’s setMdpValue method and passing the FieldMDPAction.ALL enumeration value.
• Set seed value dictionary information by invoking the PDFSignatureFieldProperties object’s setSeedValue method and passing the PDFSeedValueOptionSpec object.
• Set signature field lock dictionary information by invoking the PDFSignatureFieldPropertiesobject’s setFieldMDP method and passing the FieldMDPOptionSpec object.

NOTE

To see all seed value dictionary values that you can set, see the PDFSeedValueOptionSpec class reference. (See AEM Forms API Reference.)

Modify the signature field

Modify the signature field by invoking the SignatureServiceClient object’s modifySignatureField method and passing the following values:

• The com.adobe.idp.Document object that stores the PDF document that contains the signature field to modify
• A string value that specifies the name of the signature field
• The PDFSignatureFieldProperties object that stores signature field lock dictionary and seed value dictionary information

The modifySignatureField method returns a com.adobe.idp.Document object that stores a PDF document that contains the modified signature field.

Save the PDF document as a PDF file

• Create a java.io.File object and ensure that the file name extension is .pdf.
• Invoke the com.adobe.idp.Document object’s copyToFile method to copy the contents of the com.adobe.idp.Document object to the file. Ensure that you use the com.adobe.idp.Document object that the modifySignatureField method returned.

Include project files

Create a Microsoft .NET project that uses MTOM. Ensure that you use the following WSDL definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create a Signature client

• Create a SignatureServiceClient object by using its default constructor.

• Create a SignatureServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/SignatureService?WSDL). You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

• Create a System.ServiceModel.BasicHttpBinding object by getting the value of the SignatureServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding.

• Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom. This value ensures that MTOM is used.

• Enable basic HTTP authentication by performing the following tasks:

  • Assign the AEM forms user name to the field SignatureServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field SignatureServiceClient.ClientCredentials.UserName.Password.
  • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode.

Get the PDF document that contains the signature field to modify

• Create a BLOB object by using its constructor. The BLOB object is used to store the PDF document that contains the signature field to modify.
• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method and passing the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM property the contents of the byte array.

Set dictionary values

• Create a PDFSignatureFieldProperties object by using its constructor. This object stores signature field lock dictionary and seed value dictionary information.
• Create a PDFSeedValueOptionSpec object by using its constructor. This object lets you set seed value dictionary values.
• Disallow changes to the PDF document by assigning the MDPPermissions.NoChanges enumeration value to the PDFSeedValueOptionSpec object’s mdpValue data member.
• Create a FieldMDPOptionSpec object by using its constructor. This object lets you set signature field lock dictionary values.
• Lock all fields in the PDF document by assigning the FieldMDPAction.ALL enumeration value to the FieldMDPOptionSpec object’s mdpValue data member.
• Set seed value dictionary information by assigning the PDFSeedValueOptionSpec object to the PDFSignatureFieldProperties object’s seedValue data member.
• Set signature field lock dictionary information by assigning the FieldMDPOptionSpec object to the PDFSignatureFieldProperties object’s fieldMDP data member.

NOTE

To see all seed value dictionary values that you can set, see the PDFSeedValueOptionSpec class reference. (See AEM Forms API Reference).

Modify the signature field

Modify the signature field by invoking the SignatureServiceClient object’s modifySignatureField method and passing the following values:

• The BLOB object that stores the PDF document that contains the signature field to modify
• A string value that specifies the name of the signature field
• The PDFSignatureFieldProperties object that stores signature field lock dictionary and seed value dictionary information

The modifySignatureField method returns a BLOB object that stores a PDF document that contains the modified signature field.

Save the PDF document as a PDF file

• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document that will contain the signature field, and the mode in which to open the file.
• Create a byte array that stores the content of the BLOB object that the addSignatureField method returns. Populate the byte array by getting the value of the BLOB object’s MTOM data member.
• Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
• Write the contents of the byte array to a PDF file by invoking the System.IO.BinaryWriter object’s Write method and passing the byte array.

Include project files

Include client JAR files, such as adobe-signatures-client.jar, in your Java project’s classpath.

Create a Signatures client

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.

Get the PDF document to sign

• Create a java.io.FileInputStream object that represents the PDF document to digitally sign by using its constructor and passing a string value that specifies the location of the PDF document.
• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

Sign the PDF document

Sign the PDF document by invoking the SignatureServiceClient object’s sign method and passing the following values:

• A com.adobe.idp.Document object that represents the PDF document to sign.
• A string value that represents the name of the signature field that will contain the digital signature.
• A Credential object that represents the credential that is used to digitally sign the PDF document. Create a Credential object by invoking the Credential object’s static getInstance method and passing a string value that specifies the alias value that corresponds to the security credential.
• A HashAlgorithm object that specifies a static data member that represents the hash algorithm to use to digest the PDF document. For example, you can specify HashAlgorithm.SHA1 to use the SHA1 algorithm.
• A string value that represents the reason why the PDF document was digitally signed.
• A string value that represents the signer’s contact information.
• A PDFSignatureAppearanceOptions object that controls the appearance of the digital signature. For example, you can use this object to add a custom logo to a digital signature.
• A java.lang.Boolean object that specifies whether to perform revocation checking on the signer’s certificate.
• An OCSPOptionSpec object that stores preferences for Online Certificate Status Protocol (OCSP) support. If revocation checking is not done, this parameter is not used and you can specify null.
• A CRLPreferences object that stores certificate revocation list (CRL) preferences. If revocation checking is not done, this parameter is not used and you can specify null.
• A TSPPreferences object that stores preferences for time stamp provider (TSP) support. This parameter is optional and can be null. For more information, see AEM Forms API Reference.

The sign method returns a com.adobe.idp.Document object that represents the signed PDF document.

Save the signed PDF document

• Create a java.io.File object and ensure that the file extension is .pdf.
• Invoke the com.adobe.idp.Document object’s copyToFile method and pass java.io.Fileto copy the contents of the Document object to the file. Ensure that you use the com.adobe.idp.Document object that was returned by the sign method.

Include project files

Create a Microsoft .NET project that uses MTOM. Ensure that you use the following WSDL definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create a Signatures client

• Create a SignatureServiceClient object by using its default constructor.

• Create a SignatureServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/SignatureService?WSDL). You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

• Create a System.ServiceModel.BasicHttpBinding object by getting the value of the SignatureServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding.

• Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom. This value ensures that MTOM is used.

• Enable basic HTTP authentication by performing the following tasks:

  • Assign the AEM forms user name to the field SignatureServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field SignatureServiceClient.ClientCredentials.UserName.Password.
  • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode.

Get the PDF document to sign

• Create a BLOB object by using its constructor. The BLOB object is used to store a PDF document that is signed.
• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document to sign, and the mode in which to open the file.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method and passing the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM property the contents of the byte array.

Sign the PDF document

Sign the PDF document by invoking the SignatureServiceClient object’s sign method and passing the following values:

• A BLOB object that represents the PDF document to sign.
• A string value that represents the name of the signature field that will contain the digital signature.
• A Credential object that represents the credential that is used to digitally sign the PDF document. Create a Credential object by using its constructor and specify the alias by assigning a value to the Credential object’s alias property.
• A HashAlgorithm object that specifies a static data member that represents the hash algorithm to use to digest the PDF document. For example, you can specify HashAlgorithm.SHA1 to use the SHA1 algorithm.
• A Boolean value that specifies whether the hash algorithm is used.
• A string value that represents the reason why the PDF document was digitally signed.
• A string value that represents the signer’s location.
• A string value that represents the signer’s contact information.
• A PDFSignatureAppearanceOptions object that controls the appearance of the digital signature. For example, you can use this object to add a custom logo to a digital signature.
• A System.Boolean object that specifies whether to perform revocation checking on the signer’s certificate. If this revocation checking is done, it is embedded in the signature. The default is false.
• An OCSPOptionSpec object that stores preferences for Online Certificate Status Protocol (OCSP) support. If revocation checking is not done, this parameter is not used and you can specify null. For information about this object, see AEM Forms API Reference.
• A CRLPreferences object that stores certificate revocation list (CRL) preferences. If revocation checking is not done, this parameter is not used and you can specify null.
• A TSPPreferences object that stores preferences for time stamp provider (TSP) support. This parameter is optional and can be null.

The sign method returns a BLOB object that represents the signed PDF document.

Save the signed PDF document

• Create a System.IO.FileStream object by invoking its constructor. Pass a string value that represents the file location of the signed PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the BLOB object that was returned by the sign method. Populate the byte array by getting the value of the BLOB object’s MTOM data member.
• Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
• Write the contents of the byte array to a PDF file by invoking the System.IO.BinaryWriter object’s Write method and passing the byte array.

Include project files

Include client JAR files, such as adobe-signatures-client.jar and adobe-forms-client.jar, in your Java project’s classpath.

Create a Forms and Signatures client

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.
• Create a FormsServiceClient object by using its constructor and passing the ServiceClientFactory object.

Obtain the interactive form using the Forms service

• Create a java.io.FileInputStream object that represents the PDF document to pass to the Forms service by using its constructor. Pass a string value that specifies the location of the PDF document.

• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

• Create a java.io.FileInputStream object that represents the XML document that contains form data to pass to the Forms service by using its constructor. Pass a string value that specifies the location of the XML file.

• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

• Create a PDFFormRenderSpec object that is used to set run-time options. Invoke the PDFFormRenderSpec object’s setGenerateServerAppearance method and pass true.

• Invoke the FormsServiceClient object’s renderPDFForm2 method and pass the following values:

  • A com.adobe.idp.Document object that contains the PDF form to render.
  • A com.adobe.idp.Document object that contains data to merge with the form.
  • A PDFFormRenderSpec object that stores run-time options.
  • A URLSpec object that contains URI values that are required by the Forms service. You can specify null for this parameter value.
  • A java.util.HashMap object that stores file attachments. This is an optional parameter and you can specify null if you do not want to attach files to the form.

  The renderPDFForm2 method returns a FormsResult object that contains a form data stream

• Retrieve the PDF form by invoking the FormsResult object’s getOutputContent method. This method returns a com.adobe.idp.Document object that represents the interactive form.

Sign the interactive form

Sign the PDF document by invoking the SignatureServiceClient object’s sign method and passing the following values:

• A com.adobe.idp.Document object that represents the PDF document to sign. Ensure that this object is the com.adobe.idp.Document object obtained from the Forms service.
• A string value that represents the name of the signature field that is signed.
• A Credential object that represents the credential that is used to digitally sign the PDF document. Create a Credential object by invoking the Credential object’s static getInstance method. Pass a string value that specifies the alias value that corresponds to the security credential.
• A HashAlgorithm object that specifies a static data member that represents the hash algorithm to use to digest the PDF document. For example, you can specify HashAlgorithm.SHA1 to use the SHA1 algorithm.
• A string value that represents the reason why the PDF document was digitally signed.
• A string value that represents the signer’s contact information.
• A PDFSignatureAppearanceOptions object that controls the appearance of the digital signature. For example, you can use this object to add a custom logo to a digital signature.
• A java.lang.Boolean object that specifies whether to perform revocation checking on the signer’s certificate.
• An OCSPPreferences object that stores preferences for Online Certificate Status Protocol (OCSP) support. If revocation checking is not done, this parameter is not used and you can specify null.
• A CRLPreferences object that stores certificate revocation list (CRL) preferences. If revocation checking is not done, this parameter is not used and you can specify null.
• A TSPPreferences object that stores preferences for time stamp provider (TSP) support. This parameter is optional and can be null.

The sign method returns a com.adobe.idp.Document object that represents the signed PDF document.

Save the signed PDF document

• Create a java.io.File object and ensure that the filename extension is .pdf.
• Invoke the com.adobe.idp.Document object’s copyToFile method and pass java.io.Fileto copy the contents of the Document object to the file. Ensure that you use the com.adobe.idp.Document object that the sign method returned.

Include project files

Create a Microsoft .NET project that uses MTOM. Because this client application invokes two AEM Forms services, create two service references. Use the following WSDL definition for the service reference associated with the Signature service: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

Use the following WSDL definition for the service reference associated with the Forms service: http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

Because the BLOB data type is common to both service references, fully qualify the BLOB data type when using it. In the corresponding web service quick start, all BLOB instances are fully qualified.

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create a Forms and Signatures client

• Create a SignatureServiceClient object by using its default constructor.

• Create a SignatureServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/SignatureService?WSDL). You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

• Create a System.ServiceModel.BasicHttpBinding object by getting the value of the SignatureServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding.

• Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom. This value ensures that MTOM is used.

• Enable basic HTTP authentication by performing the following tasks:

  • Assign the AEM forms user name to the field SignatureServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field SignatureServiceClient.ClientCredentials.UserName.Password.
  • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode.

NOTE

Repeat these steps for the Forms service client.

Obtain the interactive form using the Forms service

• Create a BLOB object by using its constructor. The BLOB object is used to store a PDF document that is signed.

• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document to sign, and the mode in which to open the file.

• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.

• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method and passing the byte array, the starting position, and the stream length to read.

• Populate the BLOB object by assigning its MTOM property the contents of the byte array.

• Create a BLOB object by using its constructor. The BLOB object is used to store form data.

• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the XML file that contains form data, and the mode in which to open the file.

• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.

• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method and passing the byte array, the starting position, and the stream length to read.

• Populate the BLOB object by assigning its MTOM property the contents of the byte array.

• Create a PDFFormRenderSpec object that is used to set run-time options. Assign the value true to the PDFFormRenderSpec object’s generateServerAppearance field.

• Invoke the FormsServiceClient object’s renderPDFForm2 method and pass the following values:

  • A BLOB object that contains the PDF form to render.
  • A BLOB object that contains data to merge with the form.
  • A PDFFormRenderSpec object that stores run-time options.
  • A URLSpec object that contains URI values that are required by the Forms service. You can specify null for this parameter value.
  • A java.util.HashMap object that stores file attachments. This is an optional parameter and you can specify null if you do not want to attach files to the form.
  • A long output parameter used to store the number of pages in the form.
  • A string output parameter that is used for the locale value.
  • A FormResult value that is an output parameter that is used to store the interactive form.

• Retieve the PDF form by invoking the FormsResult object’s outputContent field. This field stores a BLOB object that represents the interactive form.

Sign the interactive form

Sign the PDF document by invoking the SignatureServiceClient object’s sign method and passing the following values:

• A BLOB object that represents the PDF document to sign. Use the BLOB instance returned by the Forms service.
• A string value that represents the name of the signature field that is signed.
• A Credential object that represents the credential that is used to digitally sign the PDF document. Create a Credential object by using its constructor and specify the alias by assigning a value to the Credential object’s alias property.
• A HashAlgorithm object that specifies a static data member that represents the hash algorithm to use to digest the PDF document. For example, you can specify HashAlgorithm.SHA1 to use the SHA1 algorithm.
• A Boolean value that specifies whether the hash algorithm is used.
• A string value that represents the reason why the PDF document was digitally signed.
• A string value that represents the signer’s location.
• A string value that represents the signer’s contact information.
• A PDFSignatureAppearanceOptions object that controls the appearance of the digital signature. For example, you can use this object to add a custom logo to a digital signature.
• A System.Boolean object that specifies whether to perform revocation checking on the signer’s certificate. If this revocation checking is done, it is embedded in the signature. The default is false.
• An OCSPPreferences object that stores preferences for Online Certificate Status Protocol (OCSP) support. If revocation checking is not done, this parameter is not used and you can specify null. For information about this object, see AEM Forms API Reference.
• A CRLPreferences object that stores certificate revocation list (CRL) preferences. If revocation checking is not done, this parameter is not used and you can specify null.
• A TSPPreferences object that stores preferences for time stamp provider (TSP) support. This parameter is optional and can be null.

The sign method returns a BLOB object that represents the signed PDF document.

Save the signed PDF document

• Create a System.IO.FileStream object by invoking its constructor. Pass a string value that represents the file location of the signed PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the BLOB object that was returned by the sign method. Populate the byte array by getting the value of the BLOB object’s MTOM data member.
• Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
• Write the contents of the byte array to a PDF file by invoking the System.IO.BinaryWriter object’s Write method and passing the byte array.

Include project files

Include client JAR files, such as adobe-signatures-client.jar, in your Java project’s class path.

Create a Signature client

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.

Get the PDF document to certify

• Create a java.io.FileInputStream object that represents the PDF document to certify by using its constructor and passing a string value that specifies the location of the PDF document.
• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

Certify the PDF document

Certify the PDF document by invoking the SignatureServiceClient object’s certify method and passing the following values:

• The com.adobe.idp.Document object that represents the PDF document to certify.
• A string value that represents the name of the signature field that will contain the signature.
• A Credential object that represents the credential that is used to certify the PDF document. Create a Credential object by invoking the Credential object’s static getInstance method and passing a string value that specifies the alias value that corresponds to the security credential.
• A HashAlgorithm object that specifies a static data member that represents the hash algorithm used to digest the PDF document. For example, you can specify HashAlgorithm.SHA1 to use the SHA1 algorithm.
• A string value that represents the reason why the PDF document was certified.
• A string value that represents the signer’s contact information.
• A MDPPermissions object that specifies actions that can be performed on the PDF document that invalidates the signature.
• A PDFSignatureAppearanceOptions object that controls the appearance of the certified signature. If desired, modify the appearance of the signature by invoking a method, such as setShowDate.
• A string value that provides an explanation of what actions invalidate the signature.
• A java.lang.Boolean object that specifies whether to perform revocation checking on the signer’s certificate. If this revocation checking is done, it is embedded in the signature. The default is false.
• A java.lang.Boolean object that specifies whether the signature field being certified is locked. If the field is locked, the signature field is marked as read only, its properties cannot be modified, and it cannot be cleared by anyone who does not have the required permissions. The default is false.
• An OCSPPreferences object that stores preferences for Online Certificate Status Protocol (OCSP) support. If revocation checking is not done, this parameter is not used and you can specify null. For information about this object, See AEM Forms API Reference.
• A CRLPreferences object that stores certificate revocation list (CRL) preferences. If revocation checking is not done, this parameter is not used and you can specify null.
• A TSPPreferences object that stores preferences for time stamp provider (TSP) support. For example, after you create a TSPPreferences object, you can set the URL of the TSP server by invoking the TSPPreferences object’s setTspServerURL method. This parameter is optional and can be null. For more information, see Services Reference for AEM Forms.

The certify method returns a com.adobe.idp.Document object that represents the certified PDF document.

Save the certified PDF document as a PDF file

• Create a java.io.File object and ensure that the file extension is .pdf.
• Invoke the com.adobe.idp.Document object’s copyToFile method to copy the contents of the com.adobe.idp.Document object to the file.

Include project files

Create a Microsoft .NET project that uses MTOM. Ensure that you use the following WSDL definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create a Signature client

• Create a SignatureServiceClient object by using its default constructor.

• Create a SignatureServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/SignatureService?WSDL). You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

• Create a System.ServiceModel.BasicHttpBinding object by getting the value of the SignatureServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding.

• Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom. This value ensures that MTOM is used.

• Enable basic HTTP authentication by performing the following tasks:

  • Assign the AEM forms user name to the field SignatureServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field SignatureServiceClient.ClientCredentials.UserName.Password.
  • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode.

Get the PDF document to certify

• Create a BLOB object by using its constructor. The BLOB object is used to store a PDF document that is certified.
• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document to certify and the mode in which to open the file.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method and passing the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM data member the contents of the byte array.

Certify the PDF document

Certify the PDF document by invoking the SignatureServiceClient object’s certify method and passing the following values:

• The BLOB object that represents the PDF document to certify.
• A string value that represents the name of the signature field that will contain the signature.
• A Credential object that represents the credential that is used to certify the PDF document. Create a Credential object by using its constructor, and specify the alias by assigning a value to the Credential object’s alias property.
• A HashAlgorithm object that specifies a static data member that represents the hash algorithm used to digest the PDF document. For example, you can specify HashAlgorithm.SHA1 to use the SHA1 algorithm.
• A Boolean value that specifies whether the hash algorithm is used.
• A string value that represents the reason why the PDF document was certified.
• A string value that represents the signer’s location.
• A string value that represents the signer’s contact information.
• An MDPPermissions object’s static data member that specifies actions that can be performed on the PDF document that invalidate the signature.
• A Boolean value that specifies whether to use the MDPPermissions object that was passed as the previous parameter value.
• A string value that explains what actions invalidate the signature.
• A PDFSignatureAppearanceOptions object that controls the appearance of the certified signature. Create a PDFSignatureAppearanceOptions object by using its constructor. You can modify the appearance of the signature by setting one of its data members.
• A System.Boolean object that specifies whether to perform revocation checking on the signer’s certificate. If this revocation checking is done, it is embedded in the signature. The default is false.
• A System.Boolean object that specifies whether the signature field being certified is locked. If the field is locked, the signature field is marked as read only, its properties cannot be modified, and it cannot be cleared by anyone who does not have the required permissions. The default is false.
• A System.Boolean object that specifies whether the signature field is locked. That is, if you pass true to the previous parameter, then pass true to this parameter.
• An OCSPPreferences object that stores preferences for Online Certificate Status Protocol (OCSP) support, which provides information about the status of the credential that is used to certify the PDF document. If revocation checking is not done, this parameter is not used and you can specify null.
• A CRLPreferences object that stores certificate revocation list (CRL) preferences. If revocation checking is not done, this parameter is not used and you can specify null.
• A TSPPreferences object that stores preferences for time stamp provider (TSP) support. For example, after you create a TSPPreferences object, you can set the URL of the TSP by setting the TSPPreferences object’s tspServerURL data member. This parameter is optional and can be null.

The certify method returns a BLOB object that represents the certified PDF document.

Save the certified PDF document as a PDF file

• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document that will contain the certified PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the BLOB object that was returned by the certify method. Populate the byte array by getting the value of the BLOB object’s binaryData data member.
• Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
• Write the contents of the byte array to a PDF file by invoking the System.IO.BinaryWriter object’s Write method and passing the byte array.

Include project files

Include client JAR files, such as adobe-signatures-client.jar, in your Java project’s classpath.

Create a Signature client

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.

Get the PDF document that contains the signature to verify

• Create a java.io.FileInputStream object that represents the PDF document that contains the signature to verify by using its constructor. Pass a string value that specifies the location of the PDF document.
• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

Set PKI run-time options

• Create a PKIOptions object by using its constructor.
• Set the verification time by invoking the PKIOptions object’s setVerificationTime method and passing a VerificationTime enumeration value that specifies the verification time.
• Set the revocation-checking option by invoking PKIOptions object’s setRevocationCheckStyle method and passing a RevocationCheckStyle enumeration value that specifies whether to perform revocation checking.

Verify the digital signature

Verify the signature by invoking the SignatureServiceClient object’s verify2 method and passing the following values:

• A com.adobe.idp.Document object that contains a digitally signed or certified PDF document.
• A string value that represents the signature field name that contains the signature to verify.
• A PKIOptions object that contains PKI run-time options.
• A VerifySPIOptions instance that contains SPI information. You can specify null for this parameter.

The verify2 method returns a PDFSignatureVerificationInfo object that contains information that can be used to verify the digital signature.

Determine the status of the signature

• Determine the signature’s status by invoking the PDFSignatureVerificationInfo object’s getStatus method. This method returns a SignatureStatus object that specifies the signature status. For example, if a signed PDF document is not modified, this method returns SignatureStatus.DocumentSigNoChanges.

Determine the identity of the signer

• Determine the signer’s identity by invoking the PDFSignatureVerificationInfo object’s getSigner method. This method returns an IdentityInformation object.
• Invoke the IdentityInformation object’s getStatus method to determine the signer’s identity. This method returns an IdentityStatus enumeration value that specifies the identity. For example, if the signer is trusted, this method returns IdentityStatus.TRUSTED.

Include project files

Create a Microsoft .NET project that uses MTOM. Ensure that you use the following WSDL definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create a Signature client

• Create a SignatureServiceClient object by using its default constructor.

• Create a SignatureServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/SignatureService?WSDL). You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

• Create a System.ServiceModel.BasicHttpBinding object by getting the value of the SignatureServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding.

• Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom. This value ensures that MTOM is used.

• Enable basic HTTP authentication by performing the following tasks:

  • Assign the AEM forms user name to the field SignatureServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field SignatureServiceClient.ClientCredentials.UserName.Password.
  • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode.

Get the PDF document that contains the signature to verify

• Create a BLOB object by using its constructor. The BLOB object is used to store a PDF document that contains a digital or certified signature to verify.
• Create a System.IO.FileStream object by invoking its constructor. Pass a string value that represents the file location of the signed PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method. Pass the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM property the contents of the byte array.

Set PKI run-time options

• Create a PKIOptions object by using its constructor.
• Set the verification time by assigning the PKIOptions object’s verificationTime data member a VerificationTime enumeration value that specifies the verification time.
• Set the revocation-checking option by assigning the PKIOptions object’s revocationCheckStyle data member a RevocationCheckStyle enumeration value that specifies whether to perform revocation checking.

Verify the digital signature

Verify the signature by invoking the SignatureServiceClient object’s verify2 method and passing the following values:

• The BLOB object that contains a digitally signed or certified PDF document.
• A string value that represents the signature field name that contains the signature to verify.
• A PKIOptions object that contains PKI run-time options.
• A VerifySPIOptions instance that contains SPI information. You can specify null for this parameter.

The verify2 method returns a PDFSignatureVerificationInfo object that contains information that can be used to verify the digital signature.

Determine the status of the signature

Determine the signature’s status by getting the value of the PDFSignatureVerificationInfo object’s status data member. This data member stores a SignatureStatus object that specifies the signature’s status. For example, if a signed PDF document is modified, the status data member stores the value SignatureStatus.DocumentSigNoChanges.

Determine the identity of the signer

• Determine the signer’s identity by retrieving the value of the PDFSignatureVerificationInfo object’s signer data member. This member returns an IdentityInformation object.
• Retrieve the IdentityInformation object’s status data member to determine the signer’s identity. This data member returns an IdentityStatus enumeration value that specifies the identity. For example, if the signer is trusted, this member returns IdentityStatus.TRUSTED.

Include project files

Include client JAR files, such as adobe-signatures-client.jar, in your Java project’s classpath.

Create a Signature client

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.

Get the PDF document that contains the signatures to verify

• Create a java.io.FileInputStream object that represents the PDF document that contains multiple digital signatures to verify by using its constructor. Pass a string value that specifies the location of the PDF document.
• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

Set PKI runtime options

• Create a PKIOptions object by using its constructor.
• Set the verification time by invoking the PKIOptions object’s setVerificationTime method and passing a VerificationTime enumeration value that specifies the verification time.
• Set the revocation checking option by invoking PKIOptions object’s setRevocationCheckStyle method and passing a RevocationCheckStyle enumeration value that specifies whether to perform revocation checking.

Retrieve all digital signatures

Invoke the SignatureServiceClient object’s verifyPDFDocument method and pass the following values:

• A com.adobe.idp.Document object that contains a PDF document that contains multiple digital signatures.
• A PKIOptions object that contains PKI run-time options.
• A VerifySPIOptions instance that contains SPI information. You can specify null for this parameter.

The verifyPDFDocument method returns a PDFDocumentVerificationInfo object that contains information about all the digital signatures in the PDF document.

Iterate through all signatures

• Iterate through all signatures by invoking the PDFDocumentVerificationInfo object’s getVerificationInfos method. This method returns a java.util.List object where each element is a PDFSignatureVerificationInfo object. Use a java.util.Iterator object to iterate through the list of signatures.
• Using the PDFSignatureVerificationInfo object, you can perform tasks such as determining the status of the signature by invoking the PDFSignatureVerificationInfo object’s getStatus method. This method returns a SignatureStatus object whose static data member informs you about the status of the signature. For example, if the signature is unknown, this method returns SignatureStatus.DocumentSignatureUnknown.

Include project files

Create a Microsoft .NET project that uses MTOM. Ensure that you use the following WSDL definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create a Signature client

• Create a SignatureServiceClient object by using its default constructor.

• Create a SignatureServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/SignatureService?WSDL). You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

• Create a System.ServiceModel.BasicHttpBinding object by getting the value of the SignatureServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding.

• Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom. This value ensures that MTOM is used.

• Enable basic HTTP authentication by performing the following tasks:

  • Assign the AEM forms user name to the field SignatureServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field SignatureServiceClient.ClientCredentials.UserName.Password.
  • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode.

Get the PDF document that contains the signatures to verify

• Create a BLOB object by using its constructor. The BLOB object stores a PDF document that contains multiple digital signatures to verify.
• Create a System.IO.FileStream object by invoking its constructor. Pass a string value that represents the file location of the PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method. Pass the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM property the contents of the byte array.

Set PKI runtime options

• Create a PKIOptions object by using its constructor.
• Set the verification time by assigning the PKIOptions object’s verificationTime data member a VerificationTime enumeration value that specifies the verification time.
• Set the revocation checking option by assigning the PKIOptions object’s revocationCheckStyle data member a RevocationCheckStyle enumeration value that specifies whether to perform revocation checking.

Retrieve all digital signatures

Invoke the SignatureServiceClient object’s verifyPDFDocument method and pass the following values:

• A BLOB object that contains a PDF document that contains multiple digital signatures.
• A PKIOptions object that contains PKI run-time options.
• A VerifySPIOptions instance that contains SPI information. You can specify null for this parameter.

The verifyPDFDocument method returns a PDFDocumentVerificationInfo object that contains information about all the digital signatures in the PDF document.

Iterate through all signatures

• Iterate through all signatures by getting the PDFDocumentVerificationInfo object’s verificationInfos data member. This data member returns an Object array where each element is a PDFSignatureVerificationInfo object.
• Using the PDFSignatureVerificationInfo object, you can perform tasks like determining the status of the signature by getting the PDFSignatureVerificationInfo object’s status data member. This data member returns a SignatureStatus object whose static data member informs you about the status of the signature. For example, if the signature is unknown, this method returns SignatureStatus.DocumentSignatureUnknown.

Include project files

Include client JAR files, such as adobe-signatures-client.jar, in your Java project’s class path.

Create a Signature client.

• Create a ServiceClientFactory object that contains connection properties.
• Create a SignatureServiceClient object by using its constructor and passing the ServiceClientFactory object.

Get the PDF document that contains a signature to remove

• Create a java.io.FileInputStream object that represents the PDF document that contains the signature to remove by using its constructor and passing a string value that specifies the location of the PDF document.
• Create a com.adobe.idp.Document object by using its constructor and passing the java.io.FileInputStream object.

Remove the digital signature from the signature field

Remove a digital signature from a signature field by invoking the SignatureServiceClient object’s clearSignatureField method and passing the following values:

• A com.adobe.idp.Document object that represents the PDF document that contains the signature to remove.
• A string value that specifies the name of the signature field that contains the digital signature.

The clearSignatureField method returns a com.adobe.idp.Document object that represents the PDF document from which the digital signature was removed.

Save the PDF document as a PDF file

• Create a java.io.File object and ensure that the file extension is .pdf.
• Invoke the com.adobe.idp.Document object’s copyToFile method. Pass the java.io.File object to copy the contents of the com.adobe.idp.Document object to the file. Ensure that you use the Document object that was returned by the clearSignatureField method.