Show Menu
主题×

Reader使用可移植保护库扩展受策略保护的PDF文档

要扩展受文档安全性策略保护的PDF文档,您必须熟悉文档安全性、Reader扩展和Java编程语言的概念。
您可以使用文档安全性将特定PDF文档的访问权限限制为仅限授权用户。 您还可以确定收件人如何使用受保护的文档。 例如,您可以指定收件人是否可以打印、复制或编辑受策略保护的文档的文本。 要进一步了解文档安全性,请参阅 文档安全性
您可以使用Reader扩展功能通过Acrobat reader在Adobe PDF文档中启用交互式功能。 这些交互功能通常仅通过Adobe Acrobat Professional和Standard提供。 要了解Reader扩展可启用的交互功能,请参阅 Adobe Experience Manager Forms docAssurance服务 ​。
您可以使用便携式保护库对文档应用策略,而无需通过网络传输文档。 只有安全凭据和保护策略详细信息才能通过网络传输。 实际文档永远不会离开客户端,保护策略将在客户端本地应用。

Reader扩展文档安全性受策略保护的PDF文档

受策略保护的文档是加密文档。 不能使用标准Reader扩展API应用、删除和检索受策略保护的PDF文档的使用权限。 只有可移植保护库的Reader Extensions服务提供API来应用、删除和检索受文档安全策略保护的PDF文档的使用权限。

Reader Extensions服务

Reader扩展服务将使用权限添加到受策略保护的PDF文档,激活使用Adobe Acrobat reader打开PDF文档时不正常的功能。 它还具有用于删除和检索受策略保护文档的使用权限的API。
Reader Extensions服务完全支持基于PDF标准1.6及更高版本的PDF文档。 除了Acrobat Reader,第三方用户不需要任何其他软件或插件即可使用受策略保护的PDF文档。
您可以使用Reader Extensions服务完成以下任务:
  • 对受策略保护的PDF文档应用使用权限。
  • 删除受策略保护的PDF文档的使用权限。
  • 检索应用于受策略保护的PDF文档的使用权限。

将使用权限应用于受文档安全性策略保护的PDF文档

您可以使用 applyUsageRights Java API将使用权限应用于受策略保护的PDF文档。 使用权限与Acrobat默认提供但Adobe reader不提供的功能有关,例如向表单添加注释或填写表单字段并保存表单的功能。 对其应用了使用权限的PDF文档称为支持权限的文档。 在Adobe Reader中打开启用了权限的文档的用户可以执行为该特定文档启用的操作。
语法: InputStream applyUsageRights(InputStream inputFile, File certFile, String credentialPassword, UsageRights usageRights)
参数
描述
inputFile
指定表示要应用使用权限的PDF文档的InputStream。 您可以使用LiveCycle Rights Management或AEM Forms文档安全保护文档。
certFile
指定表示。jks文件的File对象。 .jks文件是密钥库文件。 它指向授予使用权限的证书。
credentialPassword
指定密钥库的密码。
usageRights
指定UsageRights类型的 对象 。 usageRights对象表示可应用于受策略保护的PDF文档的个人权限。

检索应用于受策略保护的PDF文档的使用权限。  

您可以使用 getDocumentUsageRights Java API检索应用于受策略保护的PDF文档的Reader扩展使用权限。 通过检索有关使用权限的信息,您可以了解受策略保护的PDF文档的Reader扩展功能。
语法: public GetUsageRightsResult getDocumentUsageRights(InputStream inDoc)
参数
描述
inDoc
指定表示要从中检索使用权限的PDF文档的InputStream。 您可以使用LiveCycle Rights Management或AEM Forms文档安全保护文档。

代码示例

//Create a ServiceClientFactory instance
ServiceClientFactory factory = ServiceClientFactory.createInstance(connectionProps);
//Create a RightsManagementClient object
RightsManagementClient2 rmClient2= new RightsManagementClient2(factory);

String inputFileName = "C:\\Sample\\protected.pdf"; //Input file can be RM protected or unprotected pdf file
File certFile = new File("C:\\Sample\\cert.jks"); //RE certificate file
String password = "password"; //password for RE certificate
UsageRights usageRights = getUsageRights(true,true,false,false,true,true,false,false,false,false,true);

//RE rights to be applied on the file : FormFillIn, FormDataImportExport, SubmitStandalone, OnlineForms, DynamicFormField, DynamicFormPages, BarcodeDecoding, DigitalSignatures, Comments, CommentsOnline, EmbeddedFiles

InputStream inputFileStream = new FileInputStream(inputFileName);
InputStream output = rmClient2.getRightsManagementReaderExtensionService().applyUsageRights(inputFileStream, certFile, credentialPassword, rights);

String outputFileName = "C:\\Sample\\ReAdded.pdf";
//Save the PDF document
File myFile = new File(outputFileName);
FileOutputStream outputStream = new FileOutputStream(myFile);

int read = 0;
byte[] bytes = new byte[1024];

while ((read = output.read(bytes)) != -1) {

    outputStream.write(bytes, 0, read);
}

System.out.println("UsageRights applied successfully to the document. ”);
 outputStream.close();
inputFileStream.close();

//Get Usage Rights for the output pdf document
InputStream fileWithRe = new FileInputStream(myFile);

GetUsageRightsResult usageRights = rmClient2.getRightsManagementReaderExtensionService().getDocumentUsageRights(fileWithRe);

UsageRights rights = usageRights.getRights();
String right1 = rights1.toString();
System.out.println("RE rights for the file are :\n"+right1);
 fileWithRe.close();

删除受策略保护的PDF文档的使用权限

您可以使用 removeUsageRights Java API从受策略保护的文档中删除使用权限。 要对文档执行其他AEM Forms操作,必须从受策略保护的PDF文档中删除使用权限。 例如,在设置使用权限之前,您必须对PDF文档进行数字签名(或验证)。 因此,如果要对受策略保护的文档执行操作,则必须从PDF文档中删除使用权限,执行其他操作,如对文档进行数字签名,然后对文档重新应用使用权限。
语法: InputStream removeUsageRights(InputStream inputFile)
参数
描述
inputFile
指定表示要从中删除使用权限的PDF文档 的InputStream。 您可以使用LiveCycle Rights Management或AEM Forms文档安全保护文档。

代码示例

//Create a ServiceClientFactory instance
ServiceClientFactory factory = ServiceClientFactory.createInstance(connectionProps);
//Create a RightsManagementClient object
RightsManagementClient2 rmClient2= new RightsManagementClient2(factory);

String inputFileName = "C:\\Sample\\fileWithRe.pdf"; //Input file can be RM protected or unprotected pdf file
InputStream inputFileStream = new FileInputStream(inputFileName);

InputStream fileStream = rmClient2.getRightsManagementReaderExtensionService().removeUsageRights(inputFileStream);

String outputFileName = "C:\\Sample\\ReRemoveded.pdf";
//Save the PDF document
File myFile = new File(outputFileName);
FileOutputStream outputStream = new FileOutputStream(myFile);

int read = 0;
byte[] bytes = new byte[1024];

while ((read = fileStream.read(bytes)) != -1) {

    outputStream.write(bytes, 0, read);
}
System.out.println("RE rights removed successfully from the document.”);
outputStream.close();
inputFileStream.close();