Documents PDF protégés par une politique Reader Extension à l’aide de la bibliothèque de protection portable reader-extending-policy-protected-pdf-documents-using-portable-protection-library

Vous devez vous familiariser avec les concepts de sécurité documentaire, d’extensions Reader et de langage de programmation Java afin d’étendre Reader aux documents PDF protégés par une politique de Document Security.

Vous pouvez utiliser Document Security pour réserver l’accès à des documents PDF spécifiques à quelques personnes autorisées. Vous pouvez également déterminer la façon dont un ou une destinataire peut utiliser un document protégé. Par exemple, vous pouvez spécifier si les destinataires peuvent imprimer, copier ou modifier le texte d’un document protégé par une politique Document Security. Pour plus d’informations sur Document Security, voir À propos de Document Security.

Vous pouvez utiliser des extensions Reader pour activer des fonctionnalités interactives dans un document Adobe PDF via Acrobat Reader. Ces fonctionnalités interactives sont normalement disponibles uniquement via Adobe Acrobat Professional et Standard. Pour en savoir plus sur les fonctions interactives que l’extension Reader peut activer, voir Service DocAssurance Adobe Experience Manager Forms.

Vous pouvez utiliser la bibliothèque portable de protection pour appliquer des politiques à des documents, sans avoir recours aux document transitant par le réseau. Seules les informations d’identification de sécurité et les politiques de protection transitent sur le réseau. Le document ne quitte jamais le client et les politiques de protection sont appliquées localement sur le client.

Documents PDF protégés par une politique Document Security avec extension Reader reader-extending-document-security-policy-protected-pdf-documents

Les documents protégés par une politique sont des documents chiffrés. Vous ne pouvez pas utiliser d’API avec une extension Reader standard pour appliquer, supprimer et récupérer des droits d’utilisation d’un document PDF protégé par une politique. Seul le service Reader Extensions de la bibliothèque portable de protection fournit des API nécessaires à l’exécution d’une telle tâche.

Service Extensions Reader reader-extensions-service

Le service Extensions Reader dote un document PDF protégé par une politique de droits d’utilisation qui activent des fonctionnalités généralement indisponibles à l’ouverture d’un document PDF dans Adobe Acrobat Reader. Il dispose également d’API pour supprimer et récupérer les droits d’utilisation d’un document protégé par une politique.

Le service Extensions Reader prend entièrement en charge les documents PDF basés sur la norme PDF 1.6 et versions ultérieures. Outre Acrobat Reader, les utilisateurs et utilisatrices tiers n’ont pas besoin de logiciels ou de modules externes supplémentaires pour utiliser les documents PDF protégés par une politique.

Vous pouvez exécuter les tâches suivantes à l’aide du service Extensions Reader :

  • Appliquer les droits d’utilisation à un document PDF protégé par une politique.
  • Supprimer les droits d’utilisation d’un document PDF protégé par une politique.
  • Rechercher les droits d’utilisation appliqués à un document PDF protégé par une politique.

Appliquer les droits d’utilisation à un document PDF protégé par une politique de sécurité documentaire. apply-usage-rights-to-a-document-security-policy-protected-pdf-document

Vous pouvez utiliser l’API Java applyUsageRights pour appliquer des droits d’utilisation aux documents PDF protégés par une politique. Les droits d’utilisation appartiennent à la fonctionnalité disponible par défaut dans Acrobat mais non dans Adobe Reader, telle que la capacité à ajouter des commentaires à un formulaire ou à remplir des champs de formulaire et enregistrer ce dernier. Les documents PDF dotés de droits d’utilisation sont appelés documents avec droits d’utilisation activés. Un utilisateur ou une utilisatrice qui ouvre un document dont les droits sont activés dans Adobe Reader peut effectuer les opérations autorisées pour ce document spécifique.

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

Paramètre
Description
inputFile
Spécifiez InputStream correspondant au document PDF auquel des droits d’utilisation doivent être appliqués. Vous pouvez utiliser LiveCycle Rights Management ou des documents protégés par AEM Forms Document Security.
certFile
Spécifiez l’objet File représentant un fichier .jks. Le fichier .jks est un fichier de stockage de clés. Il pointe vers un certificat qui accorde des droits d’utilisation.
credentialPassword
Indiquez le mot de passe du fichier de stockage de clés.
usageRights
Spécifie un objet de type UsageRights. L’objet usageRights représente les droits individuels pouvant être appliqués à un document PDF protégé par une politique.

Rechercher les droits d’utilisation appliqués à un document PDF protégé par une politique.   retrieve-usage-rights-applied-to-a-policy-protected-pdf-document-nbsp

Vous pouvez utiliser l’API Java getDocumentUsageRights pour récupérer les droits d’utilisation de l’extension Reader appliqués à un document PDF protégé par une politique. En récupérant des informations sur les droits d’utilisation, vous pourrez en savoir davantage sur les fonctionnalités Reader Extension activées pour le document PDF protégé par une politique.

Syntaxe : public GetUsageRightsResult getDocumentUsageRights(InputStream inDoc)

Paramètre
Description
inDoc
Spécifiez InputStream correspondant au document PDF duquel des droits d’utilisation doivent être supprimés. Vous pouvez utiliser LiveCycle Rights Management ou des documents protégés par AEM Forms Document Security.

Exemple de code code-sample

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

Supprimer les droits d’utilisation d’un document PDF protégé par une politique remove-usage-rights-of-a-policy-protected-pdf-document

Vous pouvez utiliser l’API Java removeUsageRights pour supprimer des droits d’utilisation d’un document protégé par une politique. La suppression des droits d’utilisation d’un document PDF protégé par une politique est nécessaire avant d’exécuter d’autres opérations AEM Forms sur le document. Vous devez par exemple signer numériquement (ou certifier) un document PDF avant de définir ses droits d’utilisation. Par conséquent, pour effectuer des opérations sur un document défini avec des droits d’utilisation, vous devez supprimer les droits du document PDF, effectuer les autres opérations, comme la signature numérique d’un document, puis réappliquer des droits d’utilisation à ce document.

Syntaxe : InputStream removeUsageRights(InputStream inputFile)

Paramètre
Description
inputFile
Spécifiez InputStream correspondant au document PDF duquel des droits d’utilisation
doivent être supprimés. Vous pouvez utiliser LiveCycle Rights Management ou des documents protégés par AEM Forms Document Security.

Exemple de code code-sample-1

//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();
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2