You can control the way in which recipients use your policy-protected documents no matter how widely you distribute them.
Using the Documents page you can do these tasks:
When a document is protected by a policy and you revoke access privileges or switch the applied policy, the changes take effect as follows:
For each document that is listed on the Documents page, you can see the document name, publisher name, policy name, and date the document was protected. If the policy that protected a document has been deleted, the policy ID is listed under Policy Name.
You can also view more details, which are described below, about a particular document on the Document Detail page:
You must use the Policy Name link on the Document Detail page to access policies that are auto-generated in Microsoft Outlook for recipients of a document that is attached to an email message. These policies do not appear on the policies page.
Document Name: The name of the selected document.
Document ID: A unique identifier that document security assigns when a policy is applied to the document. document security uses this number to track the document.
Document Status: Status of the document (for example, active or revoked.)
Publisher: Name of the user who attached the policy to the document.
Policy Name: The name of the policy that is used to protect the document. You can click the name to open the policy. You must use this link to access policies that Acrobat generates for recipients of a document that is attached to an email message in Outlook. Those policies do not appear on the Policies page.
Policy Type: The type of policy that was applied to the document.
Date Published: The date the policy was applied to the document.
Related Iterations: If the document has related iterations, this item also appears in the list. Click the link to view the list of related iterations for the document.
Users can view information about their protected documents. Administrators can view information about documents that any user has protected with a policy. Policy set coordinators can view information about documents that are protected by policies from their policy sets.
If tracking related iterations is enabled, you can track versions of a document that various users have saved. This feature is supported only by certain applications, such as PTC Pro/ENGINEER Wildfire.
This feature is useful when multiple users are collaborating and are saving different versions of the same document. document security can keep track of the various iterations; therefore, you can easily view document information for the different versions.
If this feature is enabled, you can view the related iterations of a document from the Documents page.
View the Document Detail page for a document. (See View information about a document.)
Click View Related Iterations. The option is available only if the feature is enabled. The list of related iterations appears. For each iteration, you can view the following information:
To display the Document Detail page for that iteration, click the filename of an iteration.
You can revoke and reinstate access to policy-protected documents:
Users: Can revoke or reinstate access to documents that they protect with their own personal policies or with shared policies for which the revoke capability is enabled for the user who applies the policy. Users who cannot revoke access to a document or switch a policy need to contact the administrator.
Administrators: Can revoke or reinstate access privileges to any policy-protected document, including those protected by personal or shared policies. If an administrator revokes access to a document that is protected with a shared policy, only an administrator can reinstate access privileges for that document.
Policy set coordinators: Can revoke or reinstate access privileges for documents that policies from their policy sets protect.
When you revoke or reinstate document access privileges, the change takes effect at these times:
Revoke access to a policy-protected document
On the document security page, click Documents.
Select the check box beside the appropriate document and click Revoke. You can revoke access to multiple documents at a time.
Select a message to display to users who attempt to open the document after it is revoked:
(Optional) If a newer version of the document is available, enter the URL and click Test to verify the URL.
Click OK, and then click OK again to return to the Documents page.
Reinstate document access privileges
Users, policy set coordinators, and administrators can switch the policy that is applied to a policy-protected document (you can apply only one policy at a time to a document). Users can switch policies that are applied to their own policy-protected documents if they created the policy or if the policy is a shared one that has this capability enabled. Otherwise, the administrator or policy set coordinator must switch the policy. Administrators can switch policies for any user’s policy-protected documents. Policy set coordinators can switch policies from their policy sets.
When you switch a policy, the new policy is enforced as follows:
To permit anonymous access to a policy-protected document that currently does not have this access, remove the existing policy in the client application and then apply a policy that permits anonymous access. If you switch the policy, users still must log in to access the document.
You can search for documents on the Documents page by using a combination of date range criteria and the search criteria that are available in the list. These criteria include the document name, policy name, or all documents.
Some additional search options are only available to administrators:
Document ID: Unique ID number that document security assigns to the document when the policy is applied.
Document name: Name of the document.
Publisher name: Name of the user who attached the policy to the document. You can select the user from all domains or a specified domain.
Policy ID: ID number of the policy that is attached to the document.
Policy name: Name of the policy that is attached to the document.
All documents: All documents protected by administrators and users. Using the All Documents option to search may return a long list of documents.
On the document security page, click Documents.
In the Find list, select the required search criteria.
You can specify the criteria as document ID, document name, publisher name, policy ID, policy name, or all documents.
If you specify publisher name, click the Address Book icon and specify the domain where you want to search the user, and click OK to return to the Documents search page.
(Optional) In the Date list, select a date range option. If you select Custom Dates, type the date in format yyyy/mm/dd in the boxes that appear or use the Date Picker to specify the date range:
You can sort the list of documents by column heading. Triangle icons next to the column heading indicate which column is currently used to sort. An upward-pointing triangle indicates ascending order, while a downward-pointing triangle indicates descending order.
In the case of most non-Adobe PDF viewers, if you open a document security protected document either the first page is displayed as a blank page or the application aborts without opening the document.
You can use the Page 0 (Wrapper Document) support to allow non-Adobe PDF viewers to open a protected document and display a cover page in the document.
When viewing such documents (containing a Page 0) in Adobe Reader/Acrobat or Mobile Reader, the protected document is opened by default.
To add cover page to a policy protected document
Use the following processes in workbench:
Protect Document With Cover Page: Secures a PDF document with the specified policy, and adds a cover page to the document
Extract Protected Document: Extracts the policy-protected PDF document from the PDF document with cover page
Use the following document security APIs:
protectDocumentWithCoverPage: Secures a given PDF with the specified policy, and returns a document with a cover page and the protected document as an attachment
/Create a ServiceClientFactory instance ServiceClientFactory factory = ServiceClientFactory.createInstance(connectionProps); /Create a RightsManagementClient object RightsManagementClient rightsClient = new RightsManagementClient(factory); /Reference a PDF document to which a policy is applied FileInputStream fileInputStream = new FileInputStream("C:\\testFile.pdf"); Document inPDF = new Document(fileInputStream); /Reference a Cover Page document FileInputStream coverPageInputStream = new FileInputStream("C:\\CoverPage.pdf"); Document inCoverDoc = new Document(coverPageInputStream); /Create a Document Manager object DocumentManager documentManager = rightsClient.getDocumentManager(); /Apply a policy to the PDF document RMSecureDocumentResult rmSecureDocument = documentManager.protectDocumentWithCoverPage( inPDF, "ProtectedPDF.pdf", "PolicySetName", "PolicyName", null, null, inCoverDoc, true); /Retrieve the policy-protected PDF document Document protectPDF = rmSecureDocument.getProtectedDoc(); /Save the policy-protected PDF document File myFile = new File("C:\\PolicyProtectedDoc.pdf"); protectPDF.copyToFile(myFile); extractProtectedDocument: Extracts the protected document which is an attachment in the document with cover page. The document with the cover page can be created using protectDocumentWithCoverPage method
/Create a ServiceClientFactory instance ServiceClientFactory factory = ServiceClientFactory.createInstance(connectionProps); /Create a RightsManagementClient object RightsManagementClient rightsClient = new RightsManagementClient(factory); /Reference a protected PDF document with a Cover Page FileInputStream fileInputStream = new FileInputStream("C:\\policyProtectedDocWithCoverPage.pdf"); Document inPDF = new Document(fileInputStream); /Create a Document Manager object DocumentManager documentManager = rightsClient.getDocumentManager(); /Apply a policy to the PDF document Document extractedDoc = documentManager.extractProtectedDocument(inPDF); /Save the policy-protected PDF document File myFile = new File("C:\\PolicyProtectedDoc.pdf"); extractedDoc.copyToFile(myFile);