Reader che estende i documenti PDF protetti tramite criterio utilizzando la libreria Protezione portatile

Per estendere i documenti PDF protetti tramite criterio, è necessario avere familiarità con i concetti di protezione dei documenti, estensione dei lettori e linguaggio di programmazione Java.

È possibile utilizzare la protezione dei documenti per limitare l'accesso a documenti PDF specifici solo agli utenti autorizzati. È inoltre possibile determinare in che modo un destinatario può utilizzare un documento protetto. Ad esempio, è possibile specificare se i destinatari possono stampare, copiare o modificare il testo di un documento protetto tramite criterio. Per ulteriori informazioni sulla protezione dei documenti, vedere informazioni sulla protezione dei documenti.

È possibile utilizzare le estensioni dei lettori per abilitare le funzioni interattive in documento Adobe PDF tramite Acrobat Reader. Queste funzioni interattive normalmente disponibili solo tramite Adobe Acrobat Professional e Standard. Per informazioni sulle funzioni interattive che possono essere abilitate dall'estensione del lettore, vedere servizio Adobe Experience Manager Forms DocAssurance .

È possibile utilizzare la libreria di protezione portatile per applicare criteri al documento senza che sia necessario che il documento viaggia in rete. Solo le credenziali di sicurezza e i dettagli relativi alle politiche di protezione viaggiano sulla rete. Il documento effettivo non lascia mai il client e i criteri di protezione vengono applicati localmente sul client.

Reader estensione dei documenti PDF protetti tramite criterio di protezione documento

I documenti protetti tramite criterio sono documenti crittografati. Non è possibile utilizzare le API standard per l'estensione dei lettori per applicare, rimuovere e recuperare i diritti di utilizzo di documenti PDF protetti tramite criterio. Solo il servizio Estensioni di Reader della libreria Protezione portatile consente alle API di applicare, rimuovere e recuperare i diritti di utilizzo di documenti PDF protetti tramite criterio.

Servizio Estensioni Reader

Il servizio di estensione del lettore aggiunge diritti di utilizzo a un documento PDF protetto tramite criterio, attivando funzioni normalmente non disponibili quando un documento PDF viene aperto tramite Reader Adobe Acrobat. Dispone inoltre di API per rimuovere e recuperare i diritti di utilizzo di un documento protetto tramite criterio.

Il servizio Estensioni Reader supporta completamente i documenti PDF basati sullo standard PDF 1.6 e versioni successive. A parte Acrobat Reader, gli utenti di terze parti non richiedono software o plug-in aggiuntivi per utilizzare i documenti PDF protetti tramite criterio.

Con il servizio Estensioni di Reader potete eseguire le seguenti attività:

  • Applicare diritti di utilizzo a un documento PDF protetto tramite criterio.
  • Rimuovere i diritti di utilizzo di un documento PDF protetto tramite criterio.
  • Ottenete i diritti di utilizzo applicati a un documento PDF protetto tramite criterio.

Applicazione dei diritti di utilizzo a un documento PDF protetto tramite criterio

È possibile utilizzare l'API applyUsageRightsJava per applicare i diritti di utilizzo ai documenti PDF protetti tramite criterio. I diritti di utilizzo si riferiscono a funzionalità disponibili per impostazione predefinita in Acrobat ma non in Adobe Reader, ad esempio la possibilità di aggiungere commenti a un modulo o di compilare campi modulo e salvare il modulo. I documenti PDF a cui sono stati applicati diritti di utilizzo sono denominati documenti abilitati per i diritti. Un utente che apre un documento con diritti in Adobe Reader può eseguire operazioni abilitate per tale documento specifico.

Sintassi: InputStream applyUsageRights(InputStream inputFile, File certFile, String credentialPassword, UsageRights usageRights)

Parametro

Descrizione

inputFile

Specificare InputStream che rappresenta il documento PDF a cui applicare i diritti di utilizzo. È possibile utilizzare Rights Management di LiveCycle o documenti AEM Forms protetti per la protezione dei documenti.

certFile

Specificate l'oggetto File che rappresenta un file .jks. Il file .jks è un file keystore. Indica un certificato che concede diritti di utilizzo.

credentialPassword

Specificate la password dell'archivio di chiavi.

usageRights

Specifica un oggetto di tipo UsageRights. L'oggetto usageRights rappresenta diritti individuali che possono essere applicati a un documento PDF protetto tramite criterio.

Ottenete i diritti di utilizzo applicati a un documento PDF protetto tramite criterio.  

È possibile utilizzare l'API getDocumentUsageRightsJava per recuperare i diritti di utilizzo dell'estensione del lettore applicati a un documento PDF protetto tramite criterio. Ottenendo informazioni sui diritti di utilizzo, è possibile ottenere informazioni sulle funzioni che l'estensione del lettore di funzioni ha attivato per il documento PDF protetto tramite criterio.

Sintassi: public GetUsageRightsResult getDocumentUsageRights(InputStream inDoc)

Parametro

Descrizione

inDoc

Specificare InputStream che rappresenta il documento PDF da cui recuperare i diritti di utilizzo. È possibile utilizzare Rights Management di LiveCycle o documenti AEM Forms protetti per la protezione dei documenti.

Esempio di codice

//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();

Rimozione dei diritti di utilizzo di un documento PDF protetto tramite criterio

Potete utilizzare l'API removeUsageRightsJava per rimuovere i diritti di utilizzo da un documento protetto tramite criterio. La rimozione dei diritti di utilizzo da un documento PDF protetto tramite criterio è necessaria per eseguire altre operazioni AEM Forms documento. Ad esempio, è necessario firmare (o certificare) digitalmente un documento PDF prima di impostare i diritti di utilizzo. Pertanto, se si desidera eseguire operazioni su un documento protetto tramite criterio, è necessario rimuovere i diritti di utilizzo dal documento PDF, eseguire altre operazioni, ad esempio la firma digitale del documento e quindi riapplicare i diritti di utilizzo al documento.

Sintassi: InputStream removeUsageRights(InputStream inputFile)

Parametro

Descrizione

inputFile

Specificare InputStream che rappresenta il documento PDF da cui rimuovere i diritti di utilizzo
. È possibile utilizzare Rights Management di LiveCycle o documenti AEM Forms protetti per la protezione dei documenti.

Esempio di codice

//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();

In questa pagina