Revoking Access to Documents

To revoke a policy-protected document, perform the following steps:

1. Include project files.

2. Create a Rights Management Client API object.

3. Retrieve a policy-protected PDF document.

4. Revoke the policy-protected document.

Revoke access to a policy-protected PDF document by using the Rights Management API (Java):

1. Include project files

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

2. Create a Rights Management Client API object

   • Create a ServiceClientFactory object that contains connection properties.

   • Create a RightsManagementClient object by using its constructor and passing the ServiceClientFactory object.

3. Retrieve a policy-protected PDF document

   • Create a java.io.FileInputStream object that represent the policy-protected 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. Revoke the policy-protected document

   • Create a DocumentManager object by invoking the RightsManagementClient object’s getDocumentManager method.

   • Retrieve the license identifier value of the policy-protected document by invoking the DocumentManager object’s getLicenseId method. Pass the com.adobe.idp.Document object that represents the policy-protected document. This method returns a string value that represents the license identifier value.

   • Create a LicenseManager object by invoking the RightsManagementClient object’s getLicenseManager method.

   • Revoke the policy-protected document by invoking the LicenseManager object’s revokeLicense method and passing the following values:

     • A string value that specifies the license identifier value of the policy-protected document (specify the return value of the DocumentManager object’s getLicenseId method).

     • A static data member of the License interface that specifies the reason to revoke the document. For example, you can specify License.DOCUMENT_REVISED.

     • A java.net.URL value that specifies the location to where a revised document is located. If you do not want to redirect a user to another URL, then you can pass null.

Revoke access to a policy-protected PDF document by using the Rights Management 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/RightsManagementService?WSDL&lc_version=9.0.1.

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

2. Create a Rights Management Client API object

   • Create a RightsManagementServiceClient object by using its default constructor.

   • Create a RightsManagementServiceClient.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/RightsManagementService?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 RightsManagementServiceClient.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 RightsManagementServiceClient.ClientCredentials.UserName.UserName.

     • Assign the corresponding password value to the field RightsManagementServiceClient.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. Retrieve a policy-protected PDF document

   • Create a BLOB object by using its constructor. The BLOB object is used to store a policy-protected PDF document that is revoked.

   • Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the policy-protected PDF document to revoke 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 with the contents of the byte array.

4. Revoke the policy-protected document

   • Retrieve the license identifier value of the policy-protected document by invoking the RightsManagementServiceClient object’s getLicenseID method and passing the BLOB object that represents the policy-protected document. This method returns a string value that represents the license identifier.

   • Revoke the policy-protected document by invoking the RightsManagementServiceClient object’s revokeLicense method and passing the following values:

     • A string value that specifies the license identifier value of the policy-protected document (specify the return value of the RightsManagementServiceService object’s getLicenseId method).

     • A static data member of the Reason enum that specifies the reason to revoke the document. For example, you can specify Reason.DOCUMENT_REVISED.

     • A string value that specifies the URL location to where a revised document is located. If you do not want to redirect a user to another URL, then you can pass null.