Determining Encryption Type

To determine the type of encryption that is protecting a PDF document, perform the following steps:

1. Include project files.

2. Create an encryption service client.

3. Get the encrypted PDF document.

4. Determine the encryption type.

Determine the type of encryption that is protecting a PDF document by using the Encryption API (Java):

1. Include project files.

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

2. Create a service client.

   • Create a ServiceClientFactory object that contains connection properties.

   • Create an EncryptionServiceClient object by using its constructor and passing the ServiceClientFactory object.

3. Get the encrypted PDF document.

   • Create a java.io.FileInputStream object that represents the PDF document 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.

4. Determine the encryption type.

   • Determine the encryption type by invoking the EncryptionServiceClient object’s getPDFEncryption method and passing thecom.adobe.idp.Document object that contains the PDF document. This method returns an EncryptionTypeResult object.

   • Invoke the EncryptionTypeResult object’s getEncryptionType method. This method returns an EncryptionType enum value that specifies the encryption type. For example, if the PDF document is protected with password-based encryption, this method returns EncryptionType.PASSWORD.

Determine the type of encryption that is protecting a PDF document by using the Encryption API (web service):

1. Include project files.

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

   Note: Replace localhost with the IP address of the server hosting LiveCycle.

2. Create a service client.

   • Create an EncryptionServiceClient object by using its default constructor.

   • Create an EncryptionServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the LiveCycle service (for example, http://localhost:8080/soap/services/EncryptionService?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 EncryptionServiceClient.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 LiveCycle user name to the field EncryptionServiceClient.ClientCredentials.UserName.UserName.

     • Assign the corresponding password value to the field EncryptionServiceClient.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.

3. Get the encrypted PDF document.

   • Create a BLOB object by using its constructor.

   • Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the encrypted 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 the contents of the byte array to the BLOB object’s MTOM data member.

4. Determine the encryption type.

   • Invoke the EncryptionServiceClient object’s getPDFEncryption method and pass the BLOB object that contains the PDF document. This method returns an EncryptionTypeResult object.

   • Get the value of the EncryptionTypeResult object’s encryptionType data method. For example, if the PDF document is protected with password-based encryption, the value of this data member is EncryptionType.PASSWORD.