Documents PDF protégés par une stratégie Reader Extension à l’aide de la bibliothèque de protection portable

Dernière mise à jour : 2023-05-04
  • Créé pour :
  • User
ATTENTION

AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

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 stratégie de sécurité documentaire.

Vous pouvez utiliser Document Security pour restreindre l’accès de documents de PDF spécifiques à des utilisateurs autorisés uniquement. Vous pouvez également déterminer comment un 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 stratégie Document Security. Pour en savoir plus sur Document Security, voir à propos de Document Security.

Vous pouvez utiliser des extensions Reader pour activer des fonctionnalités interactives dans le document Adobe PDF via Acrobat Reader. Ces fonctionnalités interactives, qui 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 stratégies à des documents, sans avoir recours aux document transitant par le réseau. Seules les informations d’identification de sécurité et les stratégies de protection transitent sur le réseau. Le document ne quitte jamais le client et les stratégies de protection sont appliquées localement sur le client.

Reader de l’extension de documents de PDF protégés par une stratégie de sécurité documentaire

Les documents protégés par une stratégie sont des documents chiffrés. Vous ne pouvez pas utiliser d’API Reader-extension standard pour appliquer, supprimer et récupérer des droits d’utilisation d’un document PDF protégé par une stratégie. 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 Reader Extensions

Le service d’extension Reader ajoute des droits d’utilisation à un document de PDF protégé par une stratégie, activant des fonctionnalités qui ne sont pas normalement disponibles lors de l’ouverture d’un document de PDF à l’aide de 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 stratégie.

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

Vous pouvez accomplir les tâches suivantes avec le service Reader Extensions :

  • Appliquez des droits d’utilisation à un document de PDF protégé par une stratégie.
  • Suppression des droits d’utilisation d’un document de PDF protégé par une stratégie.
  • Rechercher les droits d’utilisation appliqués à un document PDF protégé par une stratégie.

Appliquer les droits d’utilisation à un document PDF protégé par une stratégie de sécurité documentaire.

Vous pouvez utiliser l’API Java applyUsageRights pour appliquer des droits d’utilisation aux documents PDF protégés par une stratégie. 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 de PDF auxquels des droits d’utilisation sont appliqués sont appelés des documents dont les droits sont activés. Un utilisateur qui ouvre un document dont les droits sont activés dans Adobe Reader peut effectuer des opérations qui sont activées pour ce document spécifique.

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

Paramètre

Description

inputFile

Spécifiez InputStream représentant le document du 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 des clés.

usageRights

Spécifie un objet de type UsageRights. L’objet usageRights représente les droits individuels pouvant être appliqués à un document de PDF protégé par une stratégie.

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

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 stratégie. 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 stratégie.

Syntaxe : public GetUsageRightsResult getDocumentUsageRights(InputStream inDoc)

Paramètre

Description

inDoc

Spécifiez InputStream représentant le document du PDF à partir duquel les droits d’utilisation doivent être récupérés. Vous pouvez utiliser LiveCycle Rights Management ou des documents protégés par AEM Forms Document Security.

Exemple de code

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

Suppression des droits d’utilisation d’un document de PDF protégé par une stratégie

Vous pouvez utiliser l’API Java removeUsageRights pour supprimer des droits d’utilisation d’un document protégé par une stratégie. La suppression des droits d’utilisation d’un document PDF protégé par une stratégie 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, si vous souhaitez effectuer des opérations sur un document protégé par une stratégie, vous devez supprimer les droits d’utilisation du document du PDF, effectuer les autres opérations, telles que la signature numérique du document, puis réappliquer les droits d’utilisation au document.

Syntaxe : InputStream removeUsageRights(InputStream inputFile)

Paramètre

Description

inputFile

Spécifiez InputStream représentant le document du PDF à partir duquel l’utilisation
Les droits doivent être supprimés. Vous pouvez utiliser LiveCycle Rights Management ou des documents protégés par AEM Forms Document Security.

Exemple de code

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

Sur cette page