À propos du service Encryption
Le service Encryption vous permet de chiffrer et de déchiffrer des documents. Lorsqu’un document est chiffré, son contenu devient illisible. Un utilisateur autorisé peut déchiffrer le document pour accéder à son contenu. Si un document PDF est chiffré avec un mot de passe, l’utilisateur doit spécifier le mot de passe d’ouverture pour pouvoir visualiser le document dans Adobe Reader ou Adobe Acrobat. De même, si un document PDF est chiffré avec un certificat, l’utilisateur doit déchiffrer le document PDF avec la clé publique correspondant au certificat (clé privée) qui a été utilisé pour chiffrer le document PDF.
Vous pouvez exécuter ces tâches à l’aide du service Encryption :
Chiffrez un document PDF avec un mot de passe. (Voir Chiffrement des Documents PDF avec un mot de passe.)
Chiffrez un document PDF avec un certificat. (Voir Chiffrement des Documents PDF avec des certificats.)
Supprimez le chiffrement avec mot de passe d’un document PDF. (Voir Suppression du chiffrement du mot de passe.)
Supprimez le chiffrement avec certificat d’un document PDF. (Voir Suppression du chiffrement basé sur un certificat.)
Déverrouillez le document PDF pour effectuer d’autres opérations de service. Par exemple, après le déverrouillage d’un document PDF chiffré par mot de passe, vous pouvez lui appliquer une signature numérique. (Voir Déverrouillage des Documents PDF chiffrés.)
Déterminez le type de chiffrement d’un document PDF sécurisé. (Voir Détermination du type de chiffrement.)
Pour plus d’informations sur le service Encryption, voir Guide de référence des services pour AEM Forms.
Si vous chiffrez un document PDF avec un mot de passe, les utilisateurs devront indiquer ce même mot de passe pour pouvoir ouvrir le document PDF dans Adobe Reader ou Acrobat. Avant qu’une autre opération de pour AEM Forms (signer numérique un document PDF par exemple) puisse être exécutée sur le document, un document PDF chiffré par mot de passe doit être déverrouillé.
Si vous téléchargez un document PDF chiffré dans le référentiel AEM Forms, il ne peut pas déchiffrer le document PDF et extraire le contenu XDP. Il est recommandé de ne pas chiffrer un document avant de le télécharger dans le référentiel AEM Forms. (Voir Writing Resources.)
Pour plus d’informations sur le service Encryption, voir Guide de référence des services pour AEM Forms.
Pour chiffrer un document PDF avec un mot de passe, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Les fichiers JAR suivants doivent être ajoutés au chemin de classe de votre projet :
Création d’un objet API Client Encryption
Pour exécuter par programmation une opération du service Encryption, vous devez créer un client du service Encryption.
Obtenir un document PDF à chiffrer
Vous devez obtenir un document PDF non chiffré pour chiffrer le document avec un mot de passe. Si vous tentez de sécuriser un document PDF déjà chiffré, une exception s’affiche.
Définition des options d’exécution de chiffrement
Pour chiffrer un document PDF avec un mot de passe, vous spécifiez quatre valeurs, dont deux valeurs de mot de passe. La première valeur de mot de passe est utilisée pour chiffrer le document PDF et doit être spécifiée lors de l’ouverture du document PDF. La deuxième valeur de mot de passe, appelée valeur du mot de passe maître, est utilisée pour supprimer le chiffrement du document PDF. Les valeurs de mot de passe respectent la casse et ces deux valeurs de mot de passe ne peuvent pas être identiques.
Vous devez spécifier les ressources de document PDF à chiffrer. Vous pouvez chiffrer l’ensemble du document PDF, tout sauf les métadonnées du document ou simplement les pièces jointes du document. Si vous chiffrez uniquement les pièces jointes du document, un utilisateur est invité à saisir un mot de passe lorsqu’il tente d’accéder aux pièces jointes.
Lors du chiffrement d’un document PDF, vous pouvez spécifier les autorisations associées au document sécurisé. En spécifiant des autorisations, vous pouvez contrôler les actions qu’un utilisateur qui ouvre un document PDF chiffré par mot de passe est autorisé à effectuer. Par exemple, pour extraire les données de formulaire avec succès, vous devez définir les autorisations suivantes :
Les autorisations sont spécifiées en tant que valeurs de énumération PasswordEncryptionPermission
.
Ajouter le mot de passe
Après avoir récupéré un document PDF non sécurisé et défini les valeurs d’exécution du chiffrement, vous pouvez ajouter un mot de passe au document PDF.
Enregistrer le document PDF chiffré en tant que fichier PDF
Vous pouvez enregistrer le document PDF chiffré par mot de passe au format PDF.
Voir également
Chiffrement d’un document PDF à l’aide de l’API Java
Chiffrement d’un document PDF à l’aide de l’API du service Web
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Débuts rapides de l’API du service de chiffrement
Chiffrement des Documents PDF avec des certificats
Chiffrer un document PDF avec un mot de passe à l’aide de l’API de chiffrement (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-cryptclient.jar, dans le chemin de classe de votre projet Java.
Créez une API Client Encryption.
ServiceClientFactory
qui contient des propriétés de connexion.EncryptionServiceClient
en utilisant son constructeur et en transmettant l'objet ServiceClientFactory
.Obtenez un document PDF à chiffrer.
java.io.FileInputStream
représentant le document PDF à chiffrer à l’aide de son constructeur et en transmettant une valeur de chaîne indiquant l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Définissez les options d’exécution de chiffrement.
PasswordEncryptionOptionSpec
en appelant son constructeur.PasswordEncryptionOptionSpec
de l’objet setEncryptOption
et en transmettant une valeur de énumération PasswordEncryptionOption
qui spécifie les ressources de document à chiffrer. Par exemple, pour chiffrer l’ensemble du document PDF, y compris ses métadonnées et ses pièces jointes, spécifiez PasswordEncryptionOption.ALL
.java.util.List
qui stocke les autorisations de chiffrement en utilisant le constructeur ArrayList
.java.util.List
de l'objet add
et en transmettant une valeur de énumération correspondant à l'autorisation que vous souhaitez définir. Par exemple, pour définir l’autorisation permettant à un utilisateur de copier des données situées dans le document PDF, spécifiez PasswordEncryptionPermission.PASSWORD_EDIT_COPY
. (Répétez cette étape pour chaque autorisation à définir).PasswordEncryptionOptionSpec
de l’objet setCompatability
et en transmettant une valeur de énumération qui spécifie le niveau de compatibilité Acrobat. Par exemple, vous pouvez spécifier PasswordEncryptionCompatability.ACRO_7
.PasswordEncryptionOptionSpec
de l’objet setDocumentOpenPassword
et en transmettant une valeur de chaîne qui représente le mot de passe ouvert.PasswordEncryptionOptionSpec
de l’objet setPermissionPassword
et en transmettant une valeur de chaîne qui représente le mot de passe maître.Ajoutez le mot de passe.
Chiffrez le document PDF en appelant la méthode EncryptionServiceClient
de l’objet encryptPDFUsingPassword
et en transmettant les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF à chiffrer avec le mot de passe.PasswordEncryptionOptionSpec
contenant les options d'exécution de chiffrement.La méthode encryptPDFUsingPassword
renvoie un objet com.adobe.idp.Document
contenant un document PDF chiffré par mot de passe.
Enregistrez le document PDF chiffré au format PDF.
java.io.File
et assurez-vous que l’extension du fichier est .pdf.com.adobe.idp.Document
de l'objet copyToFile
pour copier le contenu de l'objet com.adobe.idp.Document
dans le fichier. Assurez-vous d’utiliser l’objet com.adobe.idp.Document
qui a été retourné par la méthode encryptPDFUsingPassword
.Voir également
Début rapide (mode SOAP) : Chiffrement d’un document PDF à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Chiffrer un document PDF avec un mot de passe à l’aide de l’API Encryption (service Web) :
Incluez des fichiers de projet.
Créez un projet Microsoft .NET qui utilise MTOM. Assurez-vous d’utiliser la définition WSDL suivante : http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client Encryption.
Créez un objet EncryptionServiceClient
en utilisant son constructeur par défaut.
Créez un objet EncryptionServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/EncryptionService?WSDL
). Vous n'avez pas besoin d'utiliser l'attribut lc_version
. Cet attribut est utilisé lorsque vous créez une référence de service.)
Créez un objet System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champ EncryptionServiceClient.Endpoint.Binding
. Convertissez la valeur de retour en BasicHttpBinding
.
Définissez le champ MessageEncoding
de l’objet System.ServiceModel.BasicHttpBinding
sur WSMessageEncoding.Mtom
. Cette valeur garantit l’utilisation de MTOM.
Activez l’authentification HTTP de base en exécutant les tâches suivantes :
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Obtenez un document PDF à chiffrer.
BLOB
en utilisant son constructeur. L’objet BLOB
permet de stocker un document PDF chiffré avec un mot de passe.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF à chiffrer et le mode d’ouverture du fichier.System.IO.FileStream
. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en affectant le contenu du tableau d’octets au membre de données MTOM
de l’objet BLOB
.Définissez les options d’exécution de chiffrement.
PasswordEncryptionOptionSpec
en utilisant son constructeur.PasswordEncryptionOption
au membre de données PasswordEncryptionOptionSpec
de l’objet encryptOption
. Pour chiffrer l’intégralité du PDF, y compris ses métadonnées et ses pièces jointes, affectez PasswordEncryptionOption.ALL
à ce membre de données.PasswordEncryptionCompatability
au membre de données PasswordEncryptionOptionSpec
de l’objet compatability
. Par exemple, affectez PasswordEncryptionCompatability.ACRO_7
à ce membre de données.documentOpenPassword
de l’objet PasswordEncryptionOptionSpec
.permissionPassword
de l’objet PasswordEncryptionOptionSpec
.Ajoutez le mot de passe.
Chiffrez le document PDF en appelant la méthode EncryptionServiceClient
de l’objet encryptPDFUsingPassword
et en transmettant les valeurs suivantes :
BLOB
contenant le document PDF à chiffrer avec le mot de passe.PasswordEncryptionOptionSpec
contenant les options d'exécution de chiffrement.La méthode encryptPDFUsingPassword
renvoie un objet BLOB
contenant un document PDF chiffré par mot de passe.
Enregistrez le document PDF chiffré au format PDF.
System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF sécurisé.BLOB
renvoyé par la méthode encryptPDFUsingPassword
. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM
de l’objet BLOB
.System.IO.BinaryWriter
en appelant son constructeur et en transmettant l'objet System.IO.FileStream
.System.IO.BinaryWriter
de l’objet Write
et en transmettant le tableau d’octets.Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Le chiffrement avec certificat vous permet de chiffrer un document pour des destinataires spécifiques au moyen de la technologie de clé publique. Différents destinataires peuvent recevoir différents droits pour le document. De nombreux aspects de chiffrement sont possibles grâce à la technologie de clé publique. Un algorithme est utilisé pour générer deux grands nombres, appelés clés, qui ont les propriétés suivantes :
L’une des clés agit comme la clé privée d’un utilisateur. Il est important que seul l’utilisateur ait accès à cette clé. L’autre clé est la clé publique de l’utilisateur, qui peut être partagée avec d’autres personnes.
Un certificat de clé publique contient la clé publique d’un utilisateur et des informations d’identification. Le format X.509 est utilisé pour le stockage de certificats. Les certificats sont généralement émis et signés numériquement par une autorité de certification, qui est une entité reconnue qui garantit la validité du certificat. Les certificats comportent une date d’expiration ; au-delà de cette date, ils ne sont plus valides. En outre, les listes de révocation des certificats (CRL) fournissent des informations sur les certificats révoqués avant leur date d’expiration. Les listes CRL sont modifiées régulièrement par des autorités de certification. Vous pouvez également récupérer l’état de révocation d’un certificat par l’intermédiaire du protocole OCSP (Online Certificate Status Protocol, protocole d’état de certificat en ligne) sur le réseau.
Si vous téléchargez un document PDF chiffré dans le référentiel AEM Forms, il ne peut pas déchiffrer le document PDF et extraire le contenu XDP. Il est recommandé de ne pas chiffrer un document avant de le télécharger dans le référentiel AEM Forms. (Voir Writing Resources.)
Avant de chiffrer un document PDF avec un certificat, vous devez vous assurer d’ajouter le certificat à AEM Forms. Un certificat est ajouté à l’aide d’Administration Console ou par programmation à l’aide de l’API Trust Manager. (Voir Importation des informations d’identification à l’aide de l’API Trust Manager.)
Pour plus d’informations sur le service Encryption, voir Guide de référence des services pour AEM Forms.
Pour chiffrer un document PDF avec un certificat, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Les fichiers JAR suivants doivent être ajoutés au chemin de classe de votre projet :
Création d’un objet API Client Encryption
Pour exécuter par programmation une opération du service Encryption, vous devez créer un client du service Encryption. Si vous utilisez l’API Java Encryption Service, créez un objet EncrytionServiceClient
. Si vous utilisez l’API du service Web Encryption Service, créez un objet EncryptionServiceService
.
Obtenir un document PDF à chiffrer
Pour chiffrer, vous devez obtenir un document PDF non chiffré. Si vous tentez de sécuriser un document PDF déjà chiffré, une exception est générée.
Référence au certificat
Pour chiffrer un document PDF avec un certificat, référencez un certificat utilisé pour chiffrer un document PDF. Le certificat est un fichier .cer, un fichier .crt ou un fichier .pem. Un fichier PKCS#12 est utilisé pour stocker des clés privées avec les certificats correspondants.
Lors du chiffrement d’un document PDF avec un certificat, spécifiez les autorisations associées au document sécurisé. En spécifiant des autorisations, vous pouvez contrôler les actions qu’un utilisateur qui ouvre un document PDF chiffré par certificat peut effectuer.
Définition des options d’exécution de chiffrement
Spécifiez les ressources de document PDF à chiffrer. Vous pouvez chiffrer l’ensemble du document PDF, tout sauf les métadonnées du document ou uniquement les pièces jointes du document.
Création d’un document PDF chiffré par certificat
Après avoir récupéré un document PDF non sécurisé, fait référence au certificat et défini les options d’exécution, vous pouvez créer un document PDF chiffré par certificat. Une fois le document PDF chiffré, vous avez besoin de la clé publique correspondante pour le déchiffrer.
Enregistrer le document PDF chiffré en tant que fichier PDF
Vous pouvez enregistrer le document PDF chiffré au format PDF.
Voir également
Chiffrer un document PDF avec un certificat à l’aide de l’API Java
Chiffrer un document PDF avec un certificat à l’aide de l’API du service Web
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Débuts rapides de l’API du service de chiffrement
Chiffrement de Documents PDF avec un mot de passe
Chiffrer un document PDF avec un certificat à l’aide de l’API de chiffrement (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-cryptclient.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client Encryption.
ServiceClientFactory
qui contient des propriétés de connexion.EncryptionServiceClient
en utilisant son constructeur et en transmettant l'objet ServiceClientFactory
.Obtenez un document PDF à chiffrer.
java.io.FileInputStream
représentant le document PDF à chiffrer à l’aide de son constructeur et en transmettant une valeur de chaîne indiquant l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Référencez le certificat.
java.util.List
qui stocke les informations d'autorisation à l'aide de son constructeur.java.util.List
de l’objet add
et en transmettant une valeur de énumération CertificateEncryptionPermissions
qui représente les autorisations accordées à l’utilisateur qui ouvre le document PDF sécurisé. Par exemple, pour spécifier toutes les autorisations, transmettez CertificateEncryptionPermissions.PKI_ALL_PERM
.Recipient
en utilisant son constructeur.java.io.FileInputStream
qui représente le certificat utilisé pour chiffrer le document PDF à l’aide de son constructeur et transmettez une valeur de chaîne indiquant l’emplacement du certificat.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l'objet java.io.FileInputStream
qui représente le certificat.Recipient
de l'objet setX509Cert
et transmettez l'objet com.adobe.idp.Document
qui contient le certificat. (En outre, l’objet Recipient
peut avoir un alias de certificat Truststore ou une URL LDAP comme source de certificat.)CertificateEncryptionIdentity
qui stocke les informations d’autorisation et de certificat à l’aide de son constructeur.CertificateEncryptionIdentity
de l'objet setPerms
et transmettez l'objet java.util.List
qui stocke les informations d'autorisation.CertificateEncryptionIdentity
de l'objet setRecipient
et transmettez l'objet Recipient
qui stocke les informations de certificat.java.util.List
qui stocke les informations de certificat à l'aide de son constructeur.java.util.List
et transmettez l'objet CertificateEncryptionIdentity
. (Cet objet java.util.List
est transmis en tant que paramètre à la méthode encryptPDFUsingCertificates
.)Définissez les options d’exécution de chiffrement.
CertificateEncryptionOptionSpec
en appelant son constructeur.CertificateEncryptionOptionSpec
de l’objet setOption
et en transmettant une valeur de énumération CertificateEncryptionOption
qui spécifie les ressources de document à chiffrer. Par exemple, pour chiffrer l’ensemble du document PDF, y compris ses métadonnées et ses pièces jointes, spécifiez CertificateEncryptionOption.ALL
.CertificateEncryptionOptionSpec
de l’objet setCompat
et en transmettant une valeur de énumération CertificateEncryptionCompatibility
qui spécifie le niveau de compatibilité Acrobat. Par exemple, vous pouvez spécifier CertificateEncryptionCompatibility.ACRO_7
.Créez un document PDF chiffré par certificat.
Chiffrez le document PDF avec un certificat en appelant la méthode encryptPDFUsingCertificates
de l’objet EncryptionServiceClient
et en transmettant les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF à chiffrer.java.util.List
qui stocke les informations de certificat.CertificateEncryptionOptionSpec
contenant les options d'exécution de chiffrement.La méthode encryptPDFUsingCertificates
renvoie un objet com.adobe.idp.Document
contenant un document PDF chiffré par certificat.
Enregistrez le document PDF chiffré au format PDF.
java.io.File
et assurez-vous que l’extension de nom de fichier est .pdf.com.adobe.idp.Document
de l'objet copyToFile
pour copier le contenu de l'objet com.adobe.idp.Document
dans le fichier. Assurez-vous d’utiliser l’objet com.adobe.idp.Document
qui a été retourné par la méthode encryptPDFUsingCertificates
.Voir également
Début rapide (mode SOAP) : Chiffrement d’un document PDF avec un certificat à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Chiffrer un document PDF avec un certificat à l’aide de l’API Encryption (service Web) :
Incluez des fichiers de projet.
Créez un projet Microsoft .NET qui utilise MTOM. Assurez-vous d’utiliser la définition WSDL suivante : http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client Encryption.
Créez un objet EncryptionServiceClient
en utilisant son constructeur par défaut.
Créez un objet EncryptionServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/EncryptionService?WSDL
). Vous n'avez pas besoin d'utiliser l'attribut lc_version
. Cet attribut est utilisé lorsque vous créez une référence de service.)
Créez un objet System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champ EncryptionServiceClient.Endpoint.Binding
. Convertissez la valeur de retour en BasicHttpBinding
.
Définissez le champ MessageEncoding
de l’objet System.ServiceModel.BasicHttpBinding
sur WSMessageEncoding.Mtom
. Cette valeur garantit l’utilisation de MTOM.
Activez l’authentification HTTP de base en exécutant les tâches suivantes :
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Obtenez un document PDF à chiffrer.
BLOB
en utilisant son constructeur. L’objet BLOB
est utilisé pour stocker un document PDF chiffré avec un certificat.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF à chiffrer et le mode d’ouverture du fichier.System.IO.FileStream
. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en attribuant sa propriété MTOM
au contenu du tableau d’octets.Référencez le certificat.
Recipient
en utilisant son constructeur. Cet objet stocke les informations de certificat.BLOB
en utilisant son constructeur. Cet objet BLOB
stockera le certificat qui chiffre le document PDF.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l'emplacement du fichier du certificat et le mode d'ouverture du fichier.System.IO.FileStream
. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en affectant le contenu du tableau d’octets au membre de données MTOM
de l’objet BLOB
.BLOB
qui stocke le certificat au membre de données x509Cert
de l’objet Recipient
.CertificateEncryptionIdentity
qui stocke les informations de certificat à l'aide de son constructeur.Recipient
qui stocke le certificat au membre de données destinataire de l'objet CertificateEncryptionIdentity
.Object
et affectez l'objet CertificateEncryptionIdentity
au premier élément du tableau Object
. Ce tableau Object
est transmis en tant que paramètre à la méthode encryptPDFUsingCertificates
.Définissez les options d’exécution de chiffrement.
CertificateEncryptionOptionSpec
en utilisant son constructeur.CertificateEncryptionOption
au membre de données CertificateEncryptionOptionSpec
de l’objet option
. Pour chiffrer l’intégralité du document PDF, y compris ses métadonnées et ses pièces jointes, affectez CertificateEncryptionOption.ALL
à ce membre de données.CertificateEncryptionCompatibility
au membre de données CertificateEncryptionOptionSpec
de l’objet compat
. Par exemple, affectez CertificateEncryptionCompatibility.ACRO_7
à ce membre de données.Créez un document PDF chiffré par certificat.
Chiffrez le document PDF avec un certificat en appelant la méthode encryptPDFUsingCertificates
de l’objet EncryptionServiceService
et en transmettant les valeurs suivantes :
BLOB
contenant le document PDF à chiffrer.Object
contenant les informations de certificat.CertificateEncryptionOptionSpec
contenant les options d'exécution de chiffrement.La méthode encryptPDFUsingCertificates
renvoie un objet BLOB
contenant un document PDF chiffré par certificat.
Enregistrez le document PDF chiffré au format PDF.
System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF sécurisé.BLOB
renvoyé par la méthode encryptPDFUsingCertificates
. Renseignez le tableau d’octets en obtenant la valeur du membre de données binaryData
de l’objet BLOB
.System.IO.BinaryWriter
en appelant son constructeur et en transmettant l'objet System.IO.FileStream
.System.IO.BinaryWriter
de l’objet Write
et en transmettant le tableau d’octets.Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Le chiffrement avec certificat peut être supprimé d’un document PDF afin que les utilisateurs puissent ouvrir le document PDF dans Adobe Reader ou Acrobat. Pour supprimer le chiffrement d’un document PDF chiffré avec un certificat, une clé publique doit être référencée. Une fois le chiffrement supprimé d’un document PDF, il n’est plus sécurisé.
Pour plus d’informations sur le service Encryption, voir Guide de référence des services pour AEM Forms.
Pour supprimer le chiffrement avec certificat d’un document PDF, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Les fichiers JAR suivants doivent être ajoutés au chemin de classe de votre projet :
Créer un client de service de chiffrement
Pour exécuter par programmation une opération du service Encryption, vous devez créer un client du service Encryption. Si vous utilisez l’API Java Encryption Service, créez un objet EncrytionServiceClient
. Si vous utilisez l’API du service Web Encryption Service, créez un objet EncryptionServiceService
.
Obtention du document PDF chiffré
Vous devez obtenir un document PDF chiffré pour supprimer le chiffrement avec certificat. Si vous tentez de supprimer le chiffrement d’un document PDF non chiffré, une exception est générée. De même, si vous tentez de supprimer le chiffrement avec certificat d’un document chiffré par mot de passe, une exception est générée.
Supprimer le chiffrement
Pour supprimer le chiffrement avec certificat d’un document PDF chiffré, vous devez disposer à la fois d’un document PDF chiffré et de la clé privée qui correspond à la clé utilisée pour chiffrer le document PDF. La valeur d’alias de la clé privée est spécifiée lors de la suppression du chiffrement avec certificat d’un document PDF chiffré. Pour plus d’informations sur la clé publique, voir Chiffrement de Documents PDF avec des certificats.
Une clé privée est stockée dans le Trust Store d’AEM Forms. Lorsqu’un certificat y est placé, une valeur d’alias est spécifiée.
Enregistrer le document PDF
Une fois le chiffrement avec certificat supprimé d’un document PDF chiffré, vous pouvez enregistrer le document PDF en tant que fichier PDF. Les utilisateurs peuvent ouvrir le document PDF dans Adobe Reader ou Acrobat.
Voir également
Suppression du chiffrement avec certificat à l’aide de l’API Java
Suppression du chiffrement avec certificat à l’aide de l’API du service Web
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Débuts rapides de l’API du service de chiffrement
Supprimez le chiffrement avec certificat d’un document PDF à l’aide de l’API de chiffrement (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-cryptclient.jar, dans le chemin de classe de votre projet Java.
Créez un client de service de chiffrement.
ServiceClientFactory
qui contient des propriétés de connexion.EncryptionServiceClient
en utilisant son constructeur et en transmettant l'objet ServiceClientFactory
.Obtenez le document PDF chiffré.
java.io.FileInputStream
qui représente le document PDF chiffré en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF chiffré.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Supprimez le chiffrement.
Supprimez le chiffrement avec certificat du document PDF en appelant la méthode EncryptionServiceClient
de l’objet removePDFCertificateSecurity
et en transmettant les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF chiffré.La méthode removePDFCertificateSecurity
renvoie un objet com.adobe.idp.Document
contenant un document PDF non sécurisé.
Enregistrez le document PDF.
java.io.File
et assurez-vous que l’extension du fichier est .pdf.com.adobe.idp.Document
de l'objet copyToFile
pour copier le contenu de l'objet Document
dans le fichier. Assurez-vous d’utiliser l’objet com.adobe.idp.Document
qui a été retourné par la méthode removePDFCredentialSecurity
.Voir également
Début rapide (mode SOAP) : Suppression du chiffrement avec certificat à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Supprimez le chiffrement avec certificat à l’aide de l’API Encryption (service Web) :
Incluez des fichiers de projet.
Créez un projet Microsoft .NET qui utilise MTOM. Assurez-vous d’utiliser la définition WSDL suivante : http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un client de service de chiffrement.
Créez un objet EncryptionServiceClient
en utilisant son constructeur par défaut.
Créez un objet EncryptionServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/EncryptionService?WSDL
). Vous n'avez pas besoin d'utiliser l'attribut lc_version
. Cet attribut est utilisé lorsque vous créez une référence de service.)
Créez un objet System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champ EncryptionServiceClient.Endpoint.Binding
. Convertissez la valeur de retour en BasicHttpBinding
.
Définissez le champ MessageEncoding
de l’objet System.ServiceModel.BasicHttpBinding
sur WSMessageEncoding.Mtom
. Cette valeur garantit l’utilisation de MTOM.
Activez l’authentification HTTP de base en exécutant les tâches suivantes :
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Obtenez le document PDF chiffré.
BLOB
en utilisant son constructeur. L’objet BLOB
est utilisé pour stocker le document PDF chiffré.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF chiffré et le mode d’ouverture du fichier.System.IO.FileStream
. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en affectant le contenu du tableau d’octets au membre de données MTOM
de l’objet BLOB
.Supprimez le chiffrement.
Appelez la méthode removePDFCertificateSecurity
de l’objet EncryptionServiceClient
et transmettez les valeurs suivantes :
BLOB
contenant des données de flux de fichiers qui représentent un document PDF chiffré.La méthode removePDFCredentialSecurity
renvoie un objet BLOB
contenant un document PDF non sécurisé.
Enregistrez le document PDF.
System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF non sécurisé.BLOB
renvoyé par la méthode removePDFPasswordSecurity
. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM
de l’objet BLOB
.System.IO.BinaryWriter
en appelant son constructeur et en transmettant l'objet System.IO.FileStream
.System.IO.BinaryWriter
de l’objet Write
et en transmettant le tableau d’octets.Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Le chiffrement avec mot de passe peut être supprimé d’un document PDF afin que les utilisateurs puissent ouvrir le document PDF dans Adobe Reader ou Acrobat sans avoir à spécifier de mot de passe. Une fois le chiffrement avec mot de passe supprimé d’un document PDF, le document n’est plus sécurisé.
Pour plus d’informations sur le service Encryption, voir Guide de référence des services pour AEM Forms.
Pour supprimer le chiffrement avec mot de passe d’un document PDF, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Les fichiers JAR suivants doivent être ajoutés au chemin de classe de votre projet :
Créer un client de service de chiffrement
Pour exécuter par programmation une opération du service Encryption, vous devez créer un client du service Encryption. Si vous utilisez l’API Java Encryption Service, créez un objet EncrytionServiceClient
. Si vous utilisez l’API du service Web Encryption Service, créez un objet EncryptionServiceService
.
Obtention du document PDF chiffré
Vous devez obtenir un document PDF chiffré pour supprimer le chiffrement avec mot de passe. Si vous tentez de supprimer le chiffrement d’un document PDF non chiffré, une exception est générée.
Supprimer le mot de passe
Pour supprimer le chiffrement avec mot de passe d’un document PDF chiffré, vous devez disposer à la fois d’un document PDF chiffré et d’une valeur de mot de passe maître utilisée pour supprimer le chiffrement du document PDF. Le mot de passe utilisé pour ouvrir un document PDF chiffré par mot de passe ne peut pas être utilisé pour supprimer le chiffrement. Un mot de passe maître est spécifié lorsque le document PDF est chiffré avec un mot de passe. (Voir Chiffrement des Documents PDF avec un mot de passe.)
Enregistrer le document PDF
Une fois que le service Encryption a supprimé le chiffrement avec mot de passe d’un document PDF, vous pouvez enregistrer le document PDF en tant que fichier PDF. Les utilisateurs peuvent ouvrir le document PDF dans Adobe Reader ou Acrobat sans spécifier de mot de passe.
Voir également
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Débuts rapides de l’API du service de chiffrement
Chiffrement de Documents PDF avec un mot de passe
Supprimez le chiffrement avec mot de passe d’un document PDF à l’aide de l’API de chiffrement (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-cryptclient.jar, dans le chemin de classe de votre projet Java.
Créez un client de service de chiffrement.
ServiceClientFactory
qui contient des propriétés de connexion.EncryptionServiceClient
en utilisant son constructeur et en transmettant l'objet ServiceClientFactory
.Obtenez le document PDF chiffré.
java.io.FileInputStream
qui représente le document PDF chiffré en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Supprimez le mot de passe.
Supprimez le chiffrement avec mot de passe du document PDF en appelant la méthode EncryptionServiceClient
de l’objet removePDFPasswordSecurity
et en transmettant les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF chiffré.La méthode removePDFPasswordSecurity
renvoie un objet com.adobe.idp.Document
contenant un document PDF non sécurisé.
Enregistrez le document PDF.
java.io.File
et assurez-vous que l’extension de nom de fichier est .pdf.com.adobe.idp.Document
de l'objet copyToFile
pour copier le contenu de l'objet Document
dans le fichier. Assurez-vous d’utiliser l’objet Document
qui a été retourné par la méthode removePDFPasswordSecurity
.Voir également
Début rapide (mode SOAP) : Suppression du chiffrement avec mot de passe à l’aide de l’API Java
Supprimez le chiffrement avec mot de passe à l’aide de l’API Encryption (service Web) :
Incluez des fichiers de projet.
Créez un projet Microsoft .NET qui utilise MTOM. Assurez-vous d’utiliser la définition WSDL suivante : http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un client de service de chiffrement.
Créez un objet EncryptionServiceClient
en utilisant son constructeur par défaut.
Créez un objet EncryptionServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/EncryptionService?WSDL
). Vous n'avez pas besoin d'utiliser l'attribut lc_version
. Cet attribut est utilisé lorsque vous créez une référence de service.)
Créez un objet System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champ EncryptionServiceClient.Endpoint.Binding
. Convertissez la valeur de retour en BasicHttpBinding
.
Définissez le champ MessageEncoding
de l’objet System.ServiceModel.BasicHttpBinding
sur WSMessageEncoding.Mtom
. Cette valeur garantit l’utilisation de MTOM.
Activez l’authentification HTTP de base en exécutant les tâches suivantes :
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Obtenez le document PDF chiffré.
BLOB
en utilisant son constructeur. L’objet BLOB
permet de stocker un document PDF chiffré par mot de passe.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF chiffré et le mode d’ouverture du fichier.System.IO.FileStream
. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en affectant le contenu du tableau d’octets au membre de données MTOM
de l’objet BLOB
.Supprimez le mot de passe.
Appelez la méthode removePDFPasswordSecurity
de l’objet EncryptionServiceService
et transmettez les valeurs suivantes :
BLOB
contenant des données de flux de fichiers qui représentent un document PDF chiffré.La méthode removePDFPasswordSecurity
renvoie un objet BLOB
contenant un document PDF non sécurisé.
Enregistrez le document PDF.
System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF non sécurisé.BLOB
renvoyé par la méthode removePDFPasswordSecurity
. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM
de l’objet BLOB
.System.IO.BinaryWriter
en appelant son constructeur et en transmettant l'objet System.IO.FileStream
.System.IO.BinaryWriter
de l’objet Write
et en transmettant le tableau d’octets.Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Un document PDF chiffré par mot de passe ou par certificat doit être déverrouillé avant qu’une autre opération AEM Forms ne puisse être effectuée sur celui-ci. Si vous tentez d’effectuer une opération sur un document PDF chiffré, vous allez générer une exception. Après avoir déverrouillé un document PDF chiffré, vous pouvez y effectuer une ou plusieurs opérations. Ces opérations peuvent appartenir à d’autres services, tels que le service d’extensions Acrobat Reader DC.
Pour plus d’informations sur le service Encryption, voir Guide de référence des services pour AEM Forms.
Pour déverrouiller un document PDF chiffré, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Les fichiers JAR suivants doivent être ajoutés au chemin de classe de votre projet :
Créer un client de service de chiffrement
Pour exécuter par programmation une opération du service Encryption, vous devez créer un client du service Encryption. Si vous utilisez l’API Java Encryption Service, créez un objet EncrytionServiceClient
. Si vous utilisez l’API du service Web Encryption Service, créez un objet EncryptionServiceService
.
Obtention du document PDF chiffré
Vous devez obtenir un document PDF chiffré pour le déverrouiller. Si vous tentez de déverrouiller un document PDF non chiffré, une exception est générée.
Déverrouiller le document
Pour déverrouiller un document PDF chiffré par mot de passe, vous devez disposer à la fois d’un document PDF chiffré et d’une valeur de mot de passe utilisée pour ouvrir un document PDF chiffré par mot de passe. Cette valeur est spécifiée lors du chiffrement du document PDF avec un mot de passe. (Voir Chiffrement des Documents PDF avec un mot de passe.)
Pour déverrouiller un document PDF chiffré par certificat, vous devez disposer à la fois d’un document PDF chiffré et de la valeur d’alias de la clé publique correspondant à la clé privée utilisée pour chiffrer le document PDF.
Exécution d’une opération AEM Forms
Une fois qu’un document PDF chiffré est déverrouillé, vous pouvez y effectuer une autre opération de service, par exemple lui appliquer des droits d’utilisation. Cette opération appartient au service Acrobat Reader DC Extensions.
Voir également
Déverrouiller un document PDF chiffré à l’aide de l’API Java ;
Déverrouiller un document PDF chiffré à l’aide de l’API du service Web ;
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Débuts rapides de l’API du service de chiffrement
Déverrouillez un document PDF chiffré à l’aide de l’API de chiffrement (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-cryptclient.jar, dans le chemin de classe de votre projet Java.
Créez un client de service de chiffrement.
ServiceClientFactory
qui contient des propriétés de connexion.EncryptionServiceClient
en utilisant son constructeur et en transmettant l'objet ServiceClientFactory
.Obtenez le document PDF chiffré.
java.io.FileInputStream
qui représente le document PDF chiffré en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF chiffré.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Déverrouillez le document.
Déverrouillez un document PDF chiffré en appelant la méthode EncryptionServiceClient
de l’objet unlockPDFUsingPassword
ou unlockPDFUsingCredential
.
Pour déverrouiller un document PDF chiffré avec un mot de passe, appelez la méthode unlockPDFUsingPassword
et transmettez les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF chiffré par mot de passe.Pour déverrouiller un document PDF chiffré avec un certificat, appelez la méthode unlockPDFUsingCredential
et transmettez les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF chiffré par certificat.Les méthodes unlockPDFUsingPassword
et unlockPDFUsingCredential
renvoient toutes deux un objet com.adobe.idp.Document
que vous transmettez à une autre méthode Java AEM Forms pour effectuer une opération.
Exécutez une opération AEM Forms.
Effectuez une opération AEM Forms sur le document PDF déverrouillé pour répondre aux besoins de votre entreprise. Par exemple, si vous souhaitez appliquer des droits d’utilisation à un document PDF déverrouillé, transmettez l’objet com.adobe.idp.Document
renvoyé par les méthodes unlockPDFUsingPassword
ou unlockPDFUsingCredential
à la méthode ReaderExtensionsServiceClient
de l’objet applyUsageRights
.
Voir également
Début rapide (mode SOAP) : Déverrouillage d’un document PDF chiffré à l’aide de l’API Java (mode SOAP)
Application des droits d’utilisation aux Documents PDF
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Déverrouillez un document PDF chiffré à l’aide de l’API Encryption (service Web) :
Incluez des fichiers de projet.
Créez un projet Microsoft .NET qui utilise MTOM. Assurez-vous d’utiliser la définition WSDL suivante : http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un client de service de chiffrement.
Créez un objet EncryptionServiceClient
en utilisant son constructeur par défaut.
Créez un objet EncryptionServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/EncryptionService?WSDL
). Vous n'avez pas besoin d'utiliser l'attribut lc_version
. Cet attribut est utilisé lorsque vous créez une référence de service.)
Créez un objet System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champ EncryptionServiceClient.Endpoint.Binding
. Convertissez la valeur de retour en BasicHttpBinding
.
Définissez le champ MessageEncoding
de l’objet System.ServiceModel.BasicHttpBinding
sur WSMessageEncoding.Mtom
. Cette valeur garantit l’utilisation de MTOM.
Activez l’authentification HTTP de base en exécutant les tâches suivantes :
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Obtenez un document PDF chiffré.
BLOB
en utilisant son constructeur.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF chiffré et le mode d’ouverture du fichier.System.IO.FileStream
. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en affectant le contenu du tableau d’octets au membre de données MTOM
de l’objet BLOB
.Déverrouillez le document.
Déverrouillez un document PDF chiffré en appelant la méthode EncryptionServiceClient
de l’objet unlockPDFUsingPassword
ou unlockPDFUsingCredential
.
Pour déverrouiller un document PDF chiffré avec un mot de passe, appelez la méthode unlockPDFUsingPassword
et transmettez les valeurs suivantes :
BLOB
contenant le document PDF chiffré par mot de passe.Pour déverrouiller un document PDF chiffré avec un certificat, appelez la méthode unlockPDFUsingCredential
et transmettez les valeurs suivantes :
BLOB
contenant le document PDF chiffré par certificat.Les méthodes unlockPDFUsingPassword
et unlockPDFUsingCredential
renvoient toutes deux un objet com.adobe.idp.Document
que vous transmettez à une autre méthode AEM Forms pour effectuer une opération.
Exécutez une opération AEM Forms.
Effectuez une opération AEM Forms sur le document PDF déverrouillé pour répondre aux besoins de votre entreprise. Par exemple, si vous souhaitez appliquer des droits d’utilisation au document PDF déverrouillé, transmettez l’objet BLOB
renvoyé par les méthodes unlockPDFUsingPassword
ou unlockPDFUsingCredential
à la méthode ReaderExtensionsServiceClient
de l’objet applyUsageRights
.
Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Vous pouvez déterminer par programmation le type de chiffrement qui protège un document PDF à l’aide de l’API Java Encryption Service ou de l’API Web Service Encryption Service. Il est parfois nécessaire de déterminer de manière dynamique si un document PDF est chiffré et, le cas échéant, le type de chiffrement. Par exemple, vous pouvez déterminer si un document PDF est protégé par un chiffrement avec mot de passe ou par une stratégie de Rights Management.
Un document PDF peut être protégé par les types de chiffrement suivants :
Pour plus d’informations sur le service Encryption, voir Guide de référence des services pour AEM Forms.
Pour déterminer le type de chiffrement qui protège un document PDF, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Les fichiers JAR suivants doivent être ajoutés au chemin de classe de votre projet :
Création d’un client de service
Pour exécuter par programmation une opération du service Encryption, vous devez créer un client du service Encryption. Si vous utilisez l’API Java Encryption Service, créez un objet EncrytionServiceClient
. Si vous utilisez l’API du service Web Encryption Service, créez un objet EncryptionServiceService
.
Obtention du document PDF chiffré
Vous devez obtenir un document PDF pour déterminer le type de chiffrement qui le protège.
Détermination du type de chiffrement
Vous pouvez déterminer le type de chiffrement qui protège un document PDF. Si le document PDF n’est pas protégé, le service Encryption vous informe que le document PDF n’est pas sécurisé.
Voir également
Détermination du type de chiffrement à l’aide de l’API Java
Détermination du type de chiffrement à l’aide de l’API du service Web
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Débuts rapides de l’API du service de chiffrement
Protection des Documents avec des stratégies
Déterminez le type de chiffrement qui protège un document PDF à l’aide de l’API de chiffrement (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-cryptclient.jar, dans le chemin de classe de votre projet Java.
Créez un client de service.
ServiceClientFactory
qui contient des propriétés de connexion.EncryptionServiceClient
en utilisant son constructeur et en transmettant l'objet ServiceClientFactory
.Obtenez le document PDF chiffré.
java.io.FileInputStream
qui représente le document PDF en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Déterminez le type de chiffrement.
EncryptionServiceClient
de l’objet getPDFEncryption
et en transmettant l’objet com.adobe.idp.Document
contenant le document PDF. Cette méthode renvoie un objet EncryptionTypeResult
.EncryptionTypeResult
de l’objet getEncryptionType
. Cette méthode renvoie une valeur d'énumération EncryptionType
qui spécifie le type de chiffrement. Par exemple, si le document PDF est protégé par un chiffrement avec mot de passe, cette méthode renvoie EncryptionType.PASSWORD
.Voir également
Début rapide (mode SOAP) : Détermination du type de chiffrement à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Déterminez le type de chiffrement qui protège un document PDF à l’aide de l’API Encryption (service Web) :
Incluez des fichiers de projet.
Créez un projet Microsoft .NET qui utilise MTOM. Assurez-vous d’utiliser la définition WSDL suivante : http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un client de service.
Créez un objet EncryptionServiceClient
en utilisant son constructeur par défaut.
Créez un objet EncryptionServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/EncryptionService?WSDL
). Vous n'avez pas besoin d'utiliser l'attribut lc_version
. Cet attribut est utilisé lorsque vous créez une référence de service.)
Créez un objet System.ServiceModel.BasicHttpBinding
en obtenant la valeur du champ EncryptionServiceClient.Endpoint.Binding
. Convertissez la valeur de retour en BasicHttpBinding
.
Définissez le champ MessageEncoding
de l’objet System.ServiceModel.BasicHttpBinding
sur WSMessageEncoding.Mtom
. Cette valeur garantit l’utilisation de MTOM.
Activez l’authentification HTTP de base en exécutant les tâches suivantes :
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.Obtenez le document PDF chiffré.
BLOB
en utilisant son constructeur.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF chiffré et le mode d’ouverture du fichier.System.IO.FileStream
. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en affectant le contenu du tableau d’octets au membre de données MTOM
de l’objet BLOB
.Déterminez le type de chiffrement.
EncryptionServiceClient
de l’objet getPDFEncryption
et transmettez l’objet BLOB
contenant le document PDF. Cette méthode renvoie un objet EncryptionTypeResult
.encryptionType
de l’objet EncryptionTypeResult
. Par exemple, si le document PDF est protégé par un chiffrement avec mot de passe, la valeur de ce membre de données est EncryptionType.PASSWORD
.Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef