Recherche nouvelle et améliorée

Démarrages rapides de l’API du service Signature

Ajout de champs de signature à l’aide de l’API Java

Ajoutez un champ de signature à l’aide de l’API Signature (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Création d’un client Signature
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtention d’un document PDF auquel un champ de signature est ajouté
- Créez un objet java.io.FileInputStream qui représente le document PDF auquel un champ de signature est ajouté en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Ajouter un champ de signature
- Créez un objet PositionRectangle qui spécifie l’emplacement du champ de signature à l’aide de son constructeur. Dans le constructeur, spécifiez des valeurs de coordonnée.
- Si vous le souhaitez, créez un objet FieldMDPOptions qui spécifie les champs verrouillés lorsqu’une signature numérique est appliquée au champ de signature.
- Ajoutez un champ de signature à un document PDF en appelant la méthode addSignatureField de l’objet SignatureServiceClient et en transmettant les valeurs suivantes :
  - A com.adobe.idp. Document qui représente le document PDF auquel un champ de signature est ajouté.
  - Une valeur string qui spécifie le nom du champ de signature.
  - Valeur java.lang.Integer qui représente le numéro de page auquel un champ de signature est ajouté.
  - Objet PositionRectangle spécifiant l’emplacement du champ de signature.
  - Objet FieldMDPOptions spécifiant les champs du document PDF verrouillés après l’application d’une signature numérique au champ de signature. Cette valeur de paramètre est facultative et vous pouvez transmettre null.
- Objet PDFSeedValueOptions qui spécifie différentes valeurs d’exécution. Cette valeur de paramètre est facultative et vous pouvez transmettre null.
  
  La méthode addSignatureField renvoie une com.adobe.idp. Document qui représente un document PDF contenant un champ de signature.
REMARQUE

Vous pouvez appeler la méthode addInvisibleSignatureField de l’objet SignatureServiceClient pour ajouter un champ de signature invisible.
Enregistrement du document PDF en tant que fichier PDF
- Créez un objet java.io.File et assurez-vous que l’extension du fichier est .pdf.
- Appelez le com.adobe.idp. Document de la copyToFile méthode de l’objet pour copier le contenu de l’ Document objet dans le fichier. Assurez-vous d’utiliser la balise com.adobe.idp. Document qui a été renvoyé par la addSignatureField méthode .

Voir également

Ajout de champs de signature à l’aide de l’API de service Web

Pour ajouter un champ de signature à l’aide de l’API Signature (service Web) :

Inclure les 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/SignatureService?WSDL&lc_version=9.0.1.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Signature
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
Obtention d’un document PDF auquel un champ de signature est ajouté
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker le document PDF qui contiendra un champ de signature.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de flux en appelant la méthode 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.
- Renseignez l’objet BLOB en attribuant sa propriété MTOM avec le contenu du tableau d’octets.
Ajouter un champ de signature

Ajoutez un champ de signature au document PDF en appelant la méthode addSignatureField de l’objet SignatureServiceClient et en transmettant les valeurs suivantes :
- Objet BLOB représentant le document PDF auquel un champ de signature est ajouté.
- Une valeur string qui spécifie le nom du champ de signature.
- Une valeur entière qui représente le numéro de page auquel un champ de signature est ajouté.
- Objet PositionRect spécifiant l’emplacement du champ de signature.
- Objet FieldMDPOptions spécifiant les champs du document PDF verrouillés après l’application d’une signature numérique au champ de signature. Cette valeur de paramètre est facultative et vous pouvez transmettre null.
- Objet PDFSeedValueOptions qui spécifie différentes valeurs d’exécution. Cette valeur de paramètre est facultative et vous pouvez transmettre null.
La méthode addSignatureField renvoie un objet BLOB qui représente un document PDF contenant un champ de signature.
Enregistrement du document PDF en tant que fichier PDF
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF qui contiendra le champ de signature et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet BLOB renvoyé par la méthode addSignatureField. Renseignez le tableau d’octets en obtenant la valeur du membre de données binaryData de l’objet BLOB.
- Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
- Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également

Récupération des noms de champ de signature à l’aide de l’API Java

Récupération des noms des champs de signature

Vous pouvez récupérer les noms de tous les champs de signature d’un document PDF que vous souhaitez signer ou certifier. Si vous n’êtes pas certain de connaître les noms de champ de signature d’un document PDF ou si vous souhaitez vérifier leurs noms, vous pouvez programmer leur récupération. Le service Signature renvoie le nom qualifié complet du champ de signature, tel que form1[0].grantApplication[0].page1[0].SignatureField1[0].

REMARQUE

Pour plus d’informations sur le service Signature, voir Référence des services pour AEM Forms

Résumé des étapes

Pour récupérer les noms des champs de signature, effectuez les tâches suivantes :

Inclure les fichiers de projet.
Créez un client Signature.
Obtenez le document PDF contenant les champs de signature.
Récupérez les noms des champs de signature.

Inclure les fichiers de projet

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)

Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

Création d’un client Signature

Avant d’effectuer par programmation une opération du service Signature, vous devez créer un client du service Signature.

Obtention du document PDF contenant les champs de signature

Récupérez un document PDF contenant des champs de signature.

Récupération des noms des champs de signature

Vous pouvez récupérer les noms des champs de signature après avoir récupéré un document PDF contenant un ou plusieurs champs de signature.

Voir également

Récupération du champ de signature à l’aide de l’API de service Web

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Récupération des noms des champs de signature

Récupérer les noms des champs de signature à l’aide de l’API Java

Récupérez les noms des champs de signature à l’aide de l’API Signature (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Création d’un client Signature
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtention du document PDF contenant les champs de signature
- Créez un objet java.io.FileInputStream qui représente le document PDF contenant les champs de signature à l’aide de son constructeur et en transmettant une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Récupération des noms des champs de signature
- Récupérez les noms des champs de signature en appelant la méthode SignatureServiceClient de l’objet getSignatureFieldList et en transmettant l’objet com.adobe.idp.Document contenant le document PDF contenant les champs de signature. Cette méthode renvoie un objet java.util.List, dans lequel chaque élément contient un objet PDFSignatureField. Grâce à cet objet, vous pouvez obtenir des informations supplémentaires sur un champ de signature, telles que sa visibilité.
- Parcourez l’objet java.util.List pour déterminer s’il existe des noms de champ de signature. Pour chaque champ de signature du document PDF, vous pouvez obtenir un objet PDFSignatureField distinct. Pour obtenir le nom du champ de signature, appelez la méthode getName de l’objet PDFSignatureField. Cette méthode renvoie une valeur string qui spécifie le nom du champ de signature.

Voir également

Démarrage rapide (mode SOAP) : Récupération des noms de champ de signature à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Récupération des noms des champs de signature

Récupérer le champ de signature à l’aide de l’API de service Web

Récupérez les noms des champs de signature à l’aide de l’API Signature (service Web) :

Inclure les 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/SignatureService?WSDL&lc_version=9.0.1.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Signature
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
Obtention du document PDF contenant les champs de signature
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker le document PDF qui contient des champs de signature.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de flux en appelant la méthode 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.
- Renseignez l’objet BLOB en attribuant son champ MTOM au contenu du tableau d’octets.
Récupération des noms des champs de signature
- Récupérez les noms des champs de signature en appelant la méthode getSignatureFieldList de l’objet SignatureServiceClient et en transmettant l’objet BLOB contenant le document PDF contenant les champs de signature. Cette méthode renvoie un objet de collection MyArrayOfPDFSignatureField où chaque élément contient un objet PDFSignatureField.
- Parcourez l’objet MyArrayOfPDFSignatureField pour déterminer s’il existe des noms de champ de signature. Pour chaque champ de signature du document PDF, vous pouvez obtenir un objet PDFSignatureField. Pour obtenir le nom du champ de signature, appelez la méthode getName de l’objet PDFSignatureField. Cette méthode renvoie une valeur string qui spécifie le nom du champ de signature.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Modification des champs de signature

Vous pouvez modifier les champs de signature d’un document PDF à l’aide de l’API Java et de l’API du service Web. La modification d’un champ de signature implique de manipuler ses valeurs de dictionnaire de verrouillage des champs de signature ou ses valeurs du dictionnaire de valeur de départ.

Un dictionnaire de verrouillage de champ spécifie une liste de champs verrouillés lorsque le champ de signature est signé. Un champ verrouillé empêche les utilisateurs d’apporter des modifications au champ. Un dictionnaire de valeur de départ contient des informations contraignantes utilisées au moment de l’application de la signature. Par exemple, vous pouvez modifier les autorisations qui contrôlent les actions pouvant se produire sans invalider la signature.

En modifiant un champ de signature existant, vous pouvez apporter des modifications au document PDF en fonction des besoins de l’entreprise. Par exemple, une nouvelle exigence professionnelle peut nécessiter le verrouillage de tous les champs du document une fois le document signé.

Cette section explique comment modifier un champ de signature en modifiant les valeurs du dictionnaire de verrouillage de champ et du dictionnaire de valeur de départ. Les modifications apportées au dictionnaire de verrouillage des champs de signature entraînent le verrouillage de tous les champs du document PDF lorsqu’un champ de signature est signé. Les modifications apportées au dictionnaire des valeurs de départ interdisent des types spécifiques de modifications apportées au document.

REMARQUE

Pour plus d’informations sur le service Signature et la modification des champs de signature, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour modifier les champs de signature d’un document PDF, effectuez les tâches suivantes :

Inclure les fichiers de projet.
Créez un client Signature.
Obtenez le document PDF contenant le champ de signature à modifier.
Définissez les valeurs du dictionnaire.
Modifiez le champ de signature.
Enregistrez le document PDF au format PDF.

Inclure les fichiers de projet

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)

Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion des fichiers de bibliothèque Java LiveCycle.

Création d’un client Signature

Avant d’effectuer par programmation une opération du service Signature, vous devez créer un client du service Signature.

Obtention du document PDF contenant le champ de signature à modifier

Récupérez un document PDF contenant le champ de signature à modifier.

Définition des valeurs du dictionnaire

Pour modifier un champ de signature, affectez des valeurs à son dictionnaire de verrouillage de champ ou à son dictionnaire de valeur de départ. La spécification des valeurs du dictionnaire de verrouillage des champs de signature implique la spécification des champs de document PDF verrouillés lorsque le champ de signature est signé. (Cette section explique comment verrouiller tous les champs.)

Les valeurs du dictionnaire de valeurs de départ suivantes peuvent être définies :

Vérification des révisions : Indique si la vérification de révocation est effectuée lorsqu’une signature est appliquée au champ de signature.
Options de certificat : Attribue des valeurs au dictionnaire de valeurs de départ de certificat. Avant de spécifier des options de certificat, il est recommandé de vous familiariser avec un dictionnaire de valeur de départ de certificat. (Voir Référence PDF.)
Options de prétraitement : Attribue des algorithmes digest utilisés pour la signature. Les valeurs valides sont SHA1, SHA256, SHA384, SHA512 et RIPEMD160.
Filtre : Indique le filtre utilisé avec le champ de signature. Par exemple, vous pouvez utiliser le filtre Adobe.PPKLite . (Voir Référence PDF.)
Options d’indicateur : Indique les valeurs d’indicateur associées à ce champ de signature. Une valeur de 1 signifie qu’un signataire ne doit utiliser que les valeurs spécifiées pour l’entrée. Une valeur de 0 signifie que d’autres valeurs sont autorisées. Voici les positions Bit :
- 1 (Filtre) : gestionnaire de signatures à utiliser pour signer le champ de signature.
- 2 (SubFilter) : tableau de noms indiquant les encodages acceptables à utiliser lors de la signature.
- 3 (V) : Numéro de version minimum requis du gestionnaire de signatures à utiliser pour signer le champ de signature.
- 4 (Raisons) : tableau de chaînes spécifiant les motifs possibles de signature d’un document.
- 5 (PDFLegalWarnings) : tableau de chaînes spécifiant les attestations juridiques possibles.
attestations juridiques : Lorsqu’un document est certifié, il est automatiquement analysé à la recherche de types de contenu spécifiques qui peuvent rendre le contenu visible d’un document ambigu ou trompeur. Par exemple, une annotation peut masquer du texte important pour comprendre ce qui est certifié. Le processus d’analyse génère des avertissements indiquant la présence de ce type de contenu. Il fournit également une explication supplémentaire du contenu susceptible d’avoir généré des avertissements.
Autorisations : Spécifie les autorisations pouvant être utilisées sur un document PDF sans invalider la signature.
Raisons : Indique les raisons pour lesquelles ce document doit être signé.
Horodatage : Spécifie les options d’horodatage. Vous pouvez, par exemple, définir l’URL du serveur d’horodatage utilisé.
Version : Indique le numéro de version minimum du gestionnaire de signatures à utiliser pour signer le champ de signature.

Modification du champ de signature

Après avoir créé un client de service Signature, récupérez le document PDF qui contient le champ de signature à modifier et définissez les valeurs du dictionnaire, vous pouvez demander au service Signature de modifier le champ de signature. Le service Signature renvoie ensuite un document PDF contenant le champ de signature modifié. Le document PDF d’origine n’est pas affecté.

Enregistrement du document PDF en tant que fichier PDF

Enregistrez le document PDF qui contient le champ de signature modifié au format PDF afin que les utilisateurs puissent l’ouvrir dans Acrobat ou Adobe Reader.

Voir également

Démarrages rapides de l’API du service Signature

Modifier les champs de signature à l’aide de l’API Java

Modifiez un champ de signature à l’aide de l’API Signature (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar, dans le chemin de classe de votre projet Java.
Création d’un client Signature
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtention du document PDF contenant le champ de signature à modifier
- Créez un objet java.io.FileInputStream qui représente le document PDF contenant le champ de signature à modifier à l’aide de son constructeur et en transmettant une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Définition des valeurs du dictionnaire
- Créez un objet PDFSignatureFieldProperties en utilisant son constructeur. Un objet PDFSignatureFieldProperties stocke les informations du dictionnaire de verrouillage de champ de signature et du dictionnaire de valeur de départ.
- Créez un objet PDFSeedValueOptionSpec en utilisant son constructeur. Cet objet vous permet de définir les valeurs du dictionnaire de valeurs de départ.
- Interdire les modifications apportées au document PDF en appelant la méthode PDFSeedValueOptionSpec de l’objet setMdpValue et en transmettant la valeur de l’énumération MDPPermissions.NoChanges.
- Créez un objet FieldMDPOptionSpec en utilisant son constructeur. Cet objet vous permet de définir les valeurs du dictionnaire de verrouillage des champs de signature.
- Verrouillez tous les champs du document PDF en appelant la méthode FieldMDPOptionSpec de l’objet setMdpValue et en transmettant la valeur de l’énumération FieldMDPAction.ALL.
- Définissez les informations du dictionnaire des valeurs de départ en appelant la méthode setSeedValue de l’objet PDFSignatureFieldProperties et en transmettant l’objet PDFSeedValueOptionSpec.
- Définissez les informations du dictionnaire de verrouillage des champs de signature en appelant la méthode setFieldMDP de l’objet et en transmettant l’objet FieldMDPOptionSpec.PDFSignatureFieldProperties
REMARQUE

Pour afficher toutes les valeurs du dictionnaire de valeurs de départ que vous pouvez définir, consultez la référence de classe PDFSeedValueOptionSpec. (Voir Référence de l’API AEM Forms.)
Modification du champ de signature

Modifiez le champ de signature en appelant la méthode modifySignatureField de l’objet SignatureServiceClient et en transmettant les valeurs suivantes :
- Objet com.adobe.idp.Document qui stocke le document PDF contenant le champ de signature à modifier.
- Une valeur string qui spécifie le nom du champ de signature
- Objet PDFSignatureFieldProperties qui stocke les informations du dictionnaire de verrouillage de champ de signature et du dictionnaire de valeur de départ
La méthode modifySignatureField renvoie un objet com.adobe.idp.Document qui stocke un document PDF contenant le champ de signature modifié.
Enregistrement du document PDF en tant que fichier PDF
- Créez un objet java.io.File et assurez-vous que l’extension de nom de fichier est .pdf.
- Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier. Assurez-vous d’utiliser l’objet com.adobe.idp.Document renvoyé par la méthode modifySignatureField.

Modifier les champs de signature à l’aide de l’API de service Web

Modifiez un champ de signature à l’aide de l’API Signature (service Web) :

Inclure les 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/SignatureService?WSDL&lc_version=9.0.1.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Signature
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
Obtention du document PDF contenant le champ de signature à modifier
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker le document PDF qui contient le champ de signature à modifier.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de flux en appelant la méthode 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.
- Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.
Définition des valeurs du dictionnaire
- Créez un objet PDFSignatureFieldProperties en utilisant son constructeur. Cet objet stocke les informations du dictionnaire de verrouillage de champ de signature et du dictionnaire de valeur de départ.
- Créez un objet PDFSeedValueOptionSpec en utilisant son constructeur. Cet objet vous permet de définir les valeurs du dictionnaire de valeurs de départ.
- Interdire les modifications apportées au document PDF en affectant la valeur d’énumération MDPPermissions.NoChanges au membre de données mdpValue de l’objet PDFSeedValueOptionSpec.
- Créez un objet FieldMDPOptionSpec en utilisant son constructeur. Cet objet vous permet de définir les valeurs du dictionnaire de verrouillage des champs de signature.
- Verrouillez tous les champs du document PDF en attribuant la valeur d’énumération FieldMDPAction.ALL au membre de données mdpValue de l’objet FieldMDPOptionSpec.
- Définissez les informations du dictionnaire de valeur de départ en attribuant l’objet PDFSeedValueOptionSpec au membre de données seedValue de l’objet PDFSignatureFieldProperties.
- Définissez les informations du dictionnaire de verrouillage des champs de signature en attribuant l’objet FieldMDPOptionSpec au membre de données fieldMDP de l’objet PDFSignatureFieldProperties.
REMARQUE

Pour afficher toutes les valeurs du dictionnaire de valeurs de départ que vous pouvez définir, consultez la référence de classe PDFSeedValueOptionSpec. (Voir Référence de l’API AEM Forms).
Modification du champ de signature

Modifiez le champ de signature en appelant la méthode modifySignatureField de l’objet SignatureServiceClient et en transmettant les valeurs suivantes :
- Objet BLOB qui stocke le document PDF contenant le champ de signature à modifier.
- Une valeur string qui spécifie le nom du champ de signature
- Objet PDFSignatureFieldProperties qui stocke les informations du dictionnaire de verrouillage de champ de signature et du dictionnaire de valeur de départ
La méthode modifySignatureField renvoie un objet BLOB qui stocke un document PDF contenant le champ de signature modifié.
Enregistrement du document PDF en tant que fichier PDF
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF qui contiendra le champ de signature et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet BLOB renvoyé par la méthode addSignatureField. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
- Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
- Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également

Signature numérique de documents PDF à l’aide de l’API Java

Signature numérique de documents PDF

Les signatures numériques peuvent être appliquées aux documents PDF pour fournir un niveau de sécurité. Les signatures numériques, tout comme les signatures manuscrites, permettent aux signataires de s’identifier et d’effectuer des instructions sur le document. La technologie utilisée pour signer numériquement des documents permet de s’assurer que le signataire et les destinataires se sont accordés sur ce qui a été signé et croient en la non-altération du document signé.

Les documents PDF sont signés au moyen de la technologie de clé publique. Le signataire a deux clés : une clé publique et une clé privée. La clé privée est stockée dans les informations d’identification d’un utilisateur qui doivent être disponibles au moment de la signature. La clé publique est stockée dans le certificat de l’utilisateur et doit être accessible aux destinataires pour valider la signature. Les informations relatives aux certificats révoqués se trouvent dans les listes de révocation des certificats et les réponses OCSP (Online Certificate Status Protocol) distribuées par les autorités de certification (CA). L’heure de la signature peut être obtenue d’une source approuvée appelée Autorité de d’horodatage.

REMARQUE

Avant de pouvoir signer numériquement un document PDF, 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.)

Vous pouvez signer numériquement des documents PDF par programmation. Lors de la signature numérique d’un document PDF, vous devez référencer des informations d’identification de sécurité qui existent dans AEM Forms. Les informations d’identification sont la clé privée utilisée pour la signature.

Le service Signature effectue les étapes suivantes lorsqu’un document PDF est signé :

Le service Signature récupère les informations d’identification de Truststore en transmettant l’alias spécifié dans la requête.
Truststore recherche les informations d’identification spécifiées.
Les informations d’identification sont renvoyées au service Signature et sont utilisées pour signer le document. Les informations d’identification sont également mises en cache par rapport à l’alias pour les futures demandes.

Pour plus d’informations sur la gestion des informations d’identification de sécurité, consultez le guide d’installation et de déploiement d’AEM Forms* correspondant à votre serveur d’applications.

REMARQUE

Il existe des différences entre la signature et la certification de documents. (Voir Certification de documents PDF.)

REMARQUE

Tous les documents PDF ne prennent pas en charge la signature. Pour plus d’informations sur le service Signature et les documents de signature numérique, voir Référence des services pour AEM Forms.

REMARQUE

Le service Signature ne prend pas en charge les fichiers XDP contenant des données PDF incorporées en tant qu’entrée d’une opération, telle que la certification d’un document. Cette action entraîne le lancement par le service Signature d’une balise PDFOperationException. Pour résoudre ce problème, convertissez le fichier XDP en fichier PDF à l’aide du service PDF Utilities, puis transmettez le fichier PDF converti en opération de service Signature. (Voir Utilisation des utilitaires PDF.)

Informations d’identification nShield HSM

Lors de l’utilisation d’informations d’identification HSM InShield pour signer ou certifier un document PDF, les nouvelles informations d’identification ne peuvent pas être utilisées tant que le serveur d’applications J2EE sur lequel AEM Forms est déployé n’a pas été redémarré. Cependant, vous pouvez définir une valeur de configuration, ce qui entraîne le fonctionnement de l’opération de signature ou de certification sans redémarrer le serveur d’applications J2EE.

Vous pouvez ajouter la valeur de configuration suivante dans le fichier cknfastrc, qui se trouve sous /opt/nfast/cknfastrc (ou c:\nfast\cknfastrc) :

 CKNFAST_ASSUME_SINGLE_PROCESS=0

Après avoir ajouté cette valeur de configuration au fichier .cknfastrc, les nouvelles informations d’identification peuvent être utilisées sans redémarrer le serveur d’applications J2EE.

Signature non approuvée

Lors de la certification et de la signature du même document PDF, si la signature de certification n’est pas approuvée, un triangle jaune apparaît sur la première signature lors de l’ouverture du document PDF dans Acrobat ou Adobe Reader. Pour éviter cette situation, la signature de certification doit être fiable.

Signature de documents qui sont des formulaires XFA

Si vous tentez de signer un formulaire basé sur XFA à l’aide de l’API du service Signature, les données peuvent ne pas figurer dans la balise View Signed Version située dans Acrobat. Prenons l’exemple du workflow suivant :

A l’aide d’un fichier XDP créé à l’aide de Designer, vous fusionnez une conception de formulaire contenant un champ de signature et des données XML contenant des données de formulaire. Vous utilisez le service Forms pour générer un document PDF interactif.
Vous signez le document PDF à l’aide de l’API du service Signature.

Résumé des étapes

Pour signer numériquement un document PDF, effectuez les tâches suivantes :

Inclure les fichiers de projet.
Créez un client de service Signature.
Obtenez le document PDF à signer.
Signez le document PDF.
Enregistrez le document PDF signé au format PDF.

Inclure les fichiers de projet

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)

Création d’un client Signatures

Avant d’effectuer par programmation une opération du service Signature, vous devez créer un client du service Signature.

Obtenir le document PDF à signer

Pour signer un document PDF, vous devez obtenir un document PDF contenant un champ de signature. Si un document PDF ne contient pas de champ de signature, il ne peut pas être signé. Vous pouvez ajouter un champ de signature à l’aide de Designer ou par programmation.

Signature du document PDF

Lors de la signature d’un document PDF, vous pouvez définir les options d’exécution utilisées par le service Signature. Vous pouvez configurer les options suivantes :

Options d’aspect
Vérification de révocation
Valeurs d’horodatage

Vous définissez les options d’aspect à l’aide d’un objet PDFSignatureAppearanceOptionSpec. Par exemple, vous pouvez afficher la date dans une signature en appelant la méthode setShowDate de l’objet et en transmettant true.PDFSignatureAppearanceOptionSpec

Vous pouvez également indiquer si une vérification de révocation doit être effectuée afin de déterminer si le certificat utilisé pour signer numériquement un document PDF a été révoqué. Pour effectuer une vérification de révocation, vous pouvez spécifier l’une des valeurs suivantes :

NoCheck : N’effectuez pas de vérification de révocation.
BestEffort : Essayez toujours de vérifier la révocation de tous les certificats de la chaîne. Si un problème se produit lors de la vérification, la révocation est supposée être valide. En cas d’échec, supposons que le certificat n’est pas révoqué.
CheckIfAvailable : vérifiez la révocation de tous les certificats de la chaîne si les informations de révocation sont disponibles. En cas de problème lors de la vérification, la révocation est considérée comme non valide. En cas d’échec, supposons que le certificat soit révoqué et non valide. (Il s’agit de la valeur par défaut.)
AlwaysCheck : Vérifiez la révocation de tous les certificats de la chaîne. Si les informations de révocation ne figurent dans aucun certificat, la révocation est considérée comme non valide.

Pour effectuer une vérification de révocation sur un certificat, vous pouvez spécifier une URL vers un serveur de liste de révocation des certificats (CRL) à l’aide d’un objet CRLOptionSpec. Cependant, si vous souhaitez effectuer une vérification de révocation et que vous ne spécifiez pas d’URL vers un serveur CRL, le service Signature obtient l’URL à partir du certificat.

Au lieu d’utiliser un serveur CRL, vous pouvez utiliser un serveur OCSP (Online Certificate Status Protocol) lors de la vérification de révocation. En règle générale, lorsque vous utilisez un serveur OCSP plutôt qu’un serveur CRL, la vérification de révocation est effectuée plus rapidement. (Voir "Protocole d’état du certificat en ligne" à l’adresse https://tools.ietf.org/html/rfc2560.)

Vous pouvez définir l’ordre de la CRL et du serveur OCSP que le service Signature utilise à l’aide des applications et services Adobe. Par exemple, si le serveur OCSP est d’abord défini dans Applications et services Adobe, alors le serveur OCSP est coché, suivi du serveur CRL. (Voir "Gestion des certificats et des informations d’identification à l’aide de Trust Store" dans l’aide d’AAC).

Si vous indiquez de ne pas effectuer de vérification de révocation, le service Signature ne vérifie pas si le certificat utilisé pour signer ou certifier un document a été révoqué. En d’autres termes, les informations de CRL et du serveur OCSP sont ignorées.

REMARQUE

Bien qu’une CRL ou un serveur OCSP puisse être spécifié dans le certificat, vous pouvez remplacer l’URL spécifiée dans le certificat à l’aide d’un objet CRLOptionSpec et d’un objet OCSPOptionSpec. Par exemple, pour remplacer le serveur CRL, vous pouvez appeler la méthode CRLOptionSpec de l’objet setLocalURI.

L’horodatage fait référence au processus de suivi de l’heure de modification d’un document signé ou certifié. Une fois signé, le document ne doit pas être modifié, même par son propriétaire. L’horodatage permet d’assurer la validité d’un document signé ou certifié. Vous pouvez définir des options d’horodatage à l’aide d’un objet TSPOptionSpec. Par exemple, vous pouvez spécifier l’URL d’un serveur de fournisseur d’horodatage (TSP).

REMARQUE

Dans les sections Java et service Web, la vérification de révocation est utilisée, ainsi que les démarrages rapides correspondants. Comme aucune information de CRL ou de serveur OCSP n’est spécifiée, les informations du serveur sont obtenues à partir du certificat utilisé pour signer numériquement le document PDF.

Pour réussir la signature d’un document PDF, vous pouvez spécifier le nom qualifié complet du champ de signature qui contiendra la signature numérique, tel que form1[0].#subform[1].SignatureField3[3]. Lors de l’utilisation d’un champ de formulaire XFA, le nom partiel du champ de signature peut également être utilisé : SignatureField3[3].

Vous devez également référencer des informations d’identification de sécurité pour signer numériquement un document PDF. Pour référencer des informations d’identification de sécurité, vous spécifiez un alias. L’alias est une référence à des informations d’identification réelles qui peuvent se trouver dans un fichier PKCS#12 (avec une extension .pfx) ou un module de sécurité matérielle (HSM). Pour plus d’informations sur les informations d’identification de sécurité, consultez le guide d’installation et de déploiement d’AEM Forms* correspondant à votre serveur d’applications.

Enregistrement du document PDF signé

Une fois que le service Signature a signé numériquement le document PDF, vous pouvez l’enregistrer au format PDF afin que les utilisateurs puissent l’ouvrir dans Acrobat ou Adobe Reader.

Voir également

Signature numérique de documents PDF à l’aide de l’API du service Web

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Récupération des noms des champs de signature

Signature numérique de documents PDF à l’aide de l’API Java

Signer numériquement un document PDF à l’aide de l’API Signature (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Création d’un client Signatures
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtenir le document PDF à signer
- Créez un objet java.io.FileInputStream qui représente le document PDF à signer numériquement en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Signature du document PDF

Signez le document PDF en appelant la méthode SignatureServiceClient de l’objet sign et en transmettant les valeurs suivantes :
- Objet com.adobe.idp.Document représentant le document PDF à signer.
- Une valeur string qui représente le nom du champ de signature qui contiendra la signature numérique.
- Objet Credential représentant les informations d’identification utilisées pour signer numériquement le document PDF. Créez un objet Credential en appelant la méthode getInstance statique de l’objet Credential et en transmettant une valeur string qui spécifie la valeur alias qui correspond aux informations d’identification de sécurité.
- Objet HashAlgorithm spécifiant un membre de données statique qui représente l’algorithme de hachage à utiliser pour condenser le document PDF. Par exemple, vous pouvez spécifier HashAlgorithm.SHA1 pour utiliser l’algorithme SHA1.
- Une valeur string qui représente la raison pour laquelle le document PDF a été signé numériquement.
- Une valeur string qui représente les informations de contact du signataire.
- Objet PDFSignatureAppearanceOptions contrôlant l’aspect de la signature numérique. Vous pouvez, par exemple, utiliser cet objet pour ajouter un logo personnalisé à une signature numérique.
- Objet java.lang.Boolean qui spécifie s’il faut effectuer une vérification de révocation sur le certificat du signataire.
- Objet OCSPOptionSpec qui stocke les préférences pour la prise en charge du protocole OCSP (Online Certificate Status Protocol). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet CRLPreferences qui stocke les préférences de liste de révocation des certificats (CRL). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet TSPPreferences qui stocke les préférences pour la prise en charge du fournisseur d’horodatage (TSP). Ce paramètre est facultatif et peut être null. Pour plus d’informations, voir Référence de l’API AEM Forms.
La méthode sign renvoie un objet com.adobe.idp.Document représentant le document PDF signé.
Enregistrement du document PDF signé
- Créez un objet java.io.File et assurez-vous que l’extension du fichier est .pdf.
- Appelez la méthode copyToFile de l’objet com.adobe.idp.Document et transmettez java.io.Filepour 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 sign.

Voir également

Démarrage rapide (mode SOAP) : Signature numérique d’un document PDF à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Signature numérique de documents PDF à l’aide de l’API de service Web

Pour signer numériquement un document PDF à l’aide de l’API Signature (service Web) :

Inclure les 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/SignatureService?WSDL&lc_version=9.0.1.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Signatures
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
Obtenir le document PDF à signer
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF signé.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF à signer, ainsi que le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de flux en appelant la méthode 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.
- Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.
Signature du document PDF

Signez le document PDF en appelant la méthode SignatureServiceClient de l’objet sign et en transmettant les valeurs suivantes :
- Objet BLOB représentant le document PDF à signer.
- Une valeur string qui représente le nom du champ de signature qui contiendra la signature numérique.
- Objet Credential représentant les informations d’identification utilisées pour signer numériquement le document PDF. Créez un objet Credential à l’aide de son constructeur et indiquez l’alias en attribuant une valeur à la propriété alias de l’objet Credential.
- Objet HashAlgorithm spécifiant un membre de données statique qui représente l’algorithme de hachage à utiliser pour condenser le document PDF. Par exemple, vous pouvez spécifier HashAlgorithm.SHA1 pour utiliser l’algorithme SHA1.
- Valeur boolean qui spécifie si l’algorithme de hachage est utilisé.
- Une valeur string qui représente la raison pour laquelle le document PDF a été signé numériquement.
- Une valeur string qui représente l’emplacement du signataire.
- Une valeur string qui représente les informations de contact du signataire.
- Objet PDFSignatureAppearanceOptions contrôlant l’aspect de la signature numérique. Vous pouvez, par exemple, utiliser cet objet pour ajouter un logo personnalisé à une signature numérique.
- Objet System.Boolean qui spécifie s’il faut effectuer une vérification de révocation sur le certificat du signataire. Si cette vérification de révocation est effectuée, elle est incorporée dans la signature. La valeur par défaut est de false.
- Objet OCSPOptionSpec qui stocke les préférences pour la prise en charge du protocole OCSP (Online Certificate Status Protocol). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null. Pour plus d’informations sur cet objet, voir Référence de l’API AEM Forms.
- Objet CRLPreferences qui stocke les préférences de liste de révocation des certificats (CRL). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet TSPPreferences qui stocke les préférences pour la prise en charge du fournisseur d’horodatage (TSP). Ce paramètre est facultatif et peut être null.
La méthode sign renvoie un objet BLOB représentant le document PDF signé.
Enregistrement du document PDF signé
- Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur string qui représente l’emplacement du fichier du document PDF signé et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet BLOB renvoyé par la méthode sign. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
- Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
- Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également

Signer numériquement un formulaire interactif à l’aide de l’API Java

Signature numérique d’un Forms interactif

Vous pouvez signer un formulaire interactif que le service Forms crée. Prenons l’exemple du workflow suivant :

Vous fusionnez un formulaire PDF basé sur XFA créé à l’aide de Designer et des données de formulaire situées dans un document XML à l’aide du service Forms. Le serveur Forms effectue le rendu d’un formulaire interactif.
Vous pouvez signer le formulaire interactif à l’aide de l’API du service Signature.

Le résultat est un formulaire PDF interactif signé numériquement. Lors de la signature d’un formulaire PDF basé sur un formulaire XFA, veillez à enregistrer le fichier PDF en tant que formulaire PDF statique Adobe. Si vous tentez de signer un formulaire PDF enregistré en tant que formulaire PDF dynamique Adobe, une exception se produit. Puisque vous signez le formulaire renvoyé par le service Forms, assurez-vous que le formulaire contient un champ de signature.

REMARQUE

Avant de pouvoir signer numériquement un formulaire interactif, 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.)

Lors de l’utilisation de l’API Forms Service, définissez l’option d’exécution GenerateServerAppearance sur true. Cette option d’exécution garantit que l’aspect du formulaire généré sur le serveur reste valide lorsqu’il est ouvert dans Acrobat ou Adobe Reader. Il est recommandé de définir cette option d’exécution lors de la génération d’un formulaire interactif à signer à l’aide de l’API Forms.

REMARQUE

Avant de lire Digital Signing Interactive Forms, il est recommandé de bien maîtriser la signature de documents PDF. (Voir Signature numérique de documents PDF.)

Résumé des étapes

Pour signer numériquement un formulaire interactif que le service Forms renvoie, effectuez les tâches suivantes :

Inclure les fichiers de projet.
Créez un client Forms et Signatures.
Obtenez le formulaire interactif à l’aide du service Forms.
Signez le formulaire interactif.
Enregistrez le document PDF signé au format PDF.

Inclure les fichiers de projet

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-forms-client.jar
adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)

Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

Création d’un client Forms et Signatures

Comme ce workflow appelle les services Forms et Signature, créez un client de service Forms et un client de service Signature.

Obtention du formulaire interactif à l’aide du service Forms

Vous pouvez utiliser le service Forms pour obtenir le formulaire PDF interactif à signer. Depuis AEM Forms, vous pouvez transmettre un objet com.adobe.idp.Document au service Forms qui contient le formulaire à rendre. Le nom de cette méthode est renderPDFForm2. Cette méthode renvoie un objet com.adobe.idp.Document contenant le formulaire à signer. Vous pouvez transmettre cette instance com.adobe.idp.Document au service Signature.

De même, si vous utilisez des services Web, vous pouvez transmettre l’instance BLOB que le service Forms renvoie au service Signature.

REMARQUE

Le démarrage rapide associé à la section Signer numériquement le Forms interactif appelle la méthode renderPDFForm2 .

Signez le formulaire interactif

Lors de la signature d’un document PDF, vous pouvez définir les options d’exécution utilisées par le service Signature. Vous pouvez configurer les options suivantes :

Options d’aspect
Vérification de révocation
Valeurs d’horodatage

Enregistrement du document PDF signé

Une fois que le service Signature a signé numériquement le document PDF, vous pouvez l’enregistrer en tant que fichier PDF. Le fichier PDF peut être ouvert dans Acrobat ou Adobe Reader.

Voir également

Signer numériquement un formulaire interactif à l’aide de l’API du service Web

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Rendu des PDF forms interactifs

Signer numériquement un formulaire interactif à l’aide de l’API Java

Signer numériquement un formulaire interactif à l’aide de l’API Forms et Signature (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar et adobe-forms-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Création d’un client Forms et Signatures
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
- Créez un objet FormsServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtention du formulaire interactif à l’aide du service Forms
- Créez un objet java.io.FileInputStream qui représente le document PDF à transmettre au service Forms à l’aide de son constructeur. Transmettez une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
- Créez un objet java.io.FileInputStream qui représente le document XML contenant les données de formulaire à transmettre au service Forms à l’aide de son constructeur. Transmettez une valeur string qui spécifie l’emplacement du fichier XML.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
- Créez un objet PDFFormRenderSpec utilisé pour définir les options d’exécution. Appelez la méthode setGenerateServerAppearance de l’objet PDFFormRenderSpec et transmettez true.
- Appelez la méthode renderPDFForm2 de l’objet FormsServiceClient et transmettez les valeurs suivantes :
  - Objet com.adobe.idp.Document contenant le formulaire PDF à rendre.
  - Objet com.adobe.idp.Document contenant les données à fusionner avec le formulaire.
  - Objet PDFFormRenderSpec qui stocke les options d’exécution.
  - Objet URLSpec contenant des valeurs URI requises par le service Forms. Vous pouvez spécifier null pour cette valeur de paramètre.
  - Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif qui vous permet de spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.
  La méthode renderPDFForm2 renvoie un objet FormsResult contenant un flux de données de formulaire.
- Récupérez le formulaire PDF en appelant la méthode FormsResult de l’objet getOutputContent. Cette méthode renvoie un objet com.adobe.idp.Document représentant le formulaire interactif.
Signez le formulaire interactif

Signez le document PDF en appelant la méthode SignatureServiceClient de l’objet sign et en transmettant les valeurs suivantes :
- Objet com.adobe.idp.Document représentant le document PDF à signer. Assurez-vous que cet objet est l’objet com.adobe.idp.Document obtenu à partir du service Forms.
- Une valeur string qui représente le nom du champ de signature signé.
- Objet Credential représentant les informations d’identification utilisées pour signer numériquement le document PDF. Créez un objet Credential en appelant la méthode Credential statique de l’objet getInstance. Transmettez une valeur string qui spécifie la valeur alias qui correspond aux informations d’identification de sécurité.
- Objet HashAlgorithm spécifiant un membre de données statique qui représente l’algorithme de hachage à utiliser pour condenser le document PDF. Par exemple, vous pouvez spécifier HashAlgorithm.SHA1 pour utiliser l’algorithme SHA1.
- Une valeur string qui représente la raison pour laquelle le document PDF a été signé numériquement.
- Une valeur string qui représente les informations de contact du signataire.
- Objet PDFSignatureAppearanceOptions contrôlant l’aspect de la signature numérique. Vous pouvez, par exemple, utiliser cet objet pour ajouter un logo personnalisé à une signature numérique.
- Objet java.lang.Boolean qui spécifie s’il faut effectuer une vérification de révocation sur le certificat du signataire.
- Objet OCSPPreferences qui stocke les préférences pour la prise en charge du protocole OCSP (Online Certificate Status Protocol). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet CRLPreferences qui stocke les préférences de liste de révocation des certificats (CRL). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet TSPPreferences qui stocke les préférences pour la prise en charge du fournisseur d’horodatage (TSP). Ce paramètre est facultatif et peut être null.
La méthode sign renvoie un objet com.adobe.idp.Document représentant le document PDF signé.
Enregistrement du document PDF signé
- Créez un objet java.io.File et assurez-vous que l’extension du nom de fichier est .pdf.
- Appelez la méthode copyToFile de l’objet com.adobe.idp.Document et transmettez java.io.Filepour copier le contenu de l’objet Document dans le fichier. Assurez-vous d’utiliser l’objet com.adobe.idp.Document renvoyé par la méthode sign.

Voir également

Signature numérique d’un Forms interactif

Démarrage rapide (mode SOAP) : Signature numérique d’un document PDF à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Signature numérique d’un Forms interactif

Signer numériquement un formulaire interactif à l’aide de l’API de service Web

Signer numériquement un formulaire interactif à l’aide de l’API Forms et Signature (service Web) :

Inclure les fichiers de projet

Créez un projet Microsoft .NET qui utilise MTOM. Comme cette application cliente appelle deux services AEM Forms, créez deux références de service. Utilisez la définition WSDL suivante pour la référence de service associée au service Signature : http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

Utilisez la définition WSDL suivante pour la référence de service associée au service Forms : http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

Comme le type de données BLOB est commun aux deux références de service, qualifiez complètement le type de données BLOB lors de son utilisation. Dans le démarrage rapide du service Web correspondant, toutes les instances BLOB sont entièrement qualifiées.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Forms et Signatures
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
- Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
REMARQUE

Répétez ces étapes pour le client de service Forms.
Obtention du formulaire interactif à l’aide du service Forms
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF signé.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF à signer, ainsi que le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de flux en appelant la méthode 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.
- Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker des données de formulaire.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier XML contenant les données du formulaire, ainsi que le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de flux en appelant la méthode 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.
- Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.
- Créez un objet PDFFormRenderSpec utilisé pour définir les options d’exécution. Attribuez la valeur true au champ generateServerAppearance de l’objet PDFFormRenderSpec.
- Appelez la méthode renderPDFForm2 de l’objet FormsServiceClient et transmettez les valeurs suivantes :
  - Objet BLOB contenant le formulaire PDF à rendre.
  - Objet BLOB contenant les données à fusionner avec le formulaire.
  - Objet PDFFormRenderSpec qui stocke les options d’exécution.
  - Objet URLSpec contenant des valeurs URI requises par le service Forms. Vous pouvez spécifier null pour cette valeur de paramètre.
  - Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif qui vous permet de spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.
  - Paramètre de sortie long utilisé pour stocker le nombre de pages dans le formulaire.
  - Paramètre de sortie string utilisé pour la valeur locale.
  - Une valeur FormResult qui est un paramètre de sortie utilisé pour stocker le formulaire interactif.
- Supprimez le formulaire PDF en appelant le champ outputContent de l’objet FormsResult. Ce champ stocke un objet BLOB qui représente le formulaire interactif.
Signez le formulaire interactif

Signez le document PDF en appelant la méthode SignatureServiceClient de l’objet sign et en transmettant les valeurs suivantes :
- Objet BLOB représentant le document PDF à signer. Utilisez l’instance BLOB renvoyée par le service Forms.
- Une valeur string qui représente le nom du champ de signature signé.
- Objet Credential représentant les informations d’identification utilisées pour signer numériquement le document PDF. Créez un objet Credential à l’aide de son constructeur et indiquez l’alias en attribuant une valeur à la propriété alias de l’objet Credential.
- Objet HashAlgorithm spécifiant un membre de données statique qui représente l’algorithme de hachage à utiliser pour condenser le document PDF. Par exemple, vous pouvez spécifier HashAlgorithm.SHA1 pour utiliser l’algorithme SHA1.
- Valeur boolean qui spécifie si l’algorithme de hachage est utilisé.
- Une valeur string qui représente la raison pour laquelle le document PDF a été signé numériquement.
- Une valeur string qui représente l’emplacement du signataire.
- Une valeur string qui représente les informations de contact du signataire.
- Objet PDFSignatureAppearanceOptions contrôlant l’aspect de la signature numérique. Vous pouvez, par exemple, utiliser cet objet pour ajouter un logo personnalisé à une signature numérique.
- Objet System.Boolean qui spécifie s’il faut effectuer une vérification de révocation sur le certificat du signataire. Si cette vérification de révocation est effectuée, elle est incorporée dans la signature. La valeur par défaut est de false.
- Objet OCSPPreferences qui stocke les préférences pour la prise en charge du protocole OCSP (Online Certificate Status Protocol). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null. Pour plus d’informations sur cet objet, voir Référence de l’API AEM Forms.
- Objet CRLPreferences qui stocke les préférences de liste de révocation des certificats (CRL). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet TSPPreferences qui stocke les préférences pour la prise en charge du fournisseur d’horodatage (TSP). Ce paramètre est facultatif et peut être null.
La méthode sign renvoie un objet BLOB représentant le document PDF signé.
Enregistrement du document PDF signé
- Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur string qui représente l’emplacement du fichier du document PDF signé et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet BLOB renvoyé par la méthode sign. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
- Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
- Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également

Certification de documents PDF à l’aide de l’API Java

Certification de documents PDF

Vous pouvez définir un document PDF en le certifiant avec un type de signature particulier appelé signature certifiée. Une signature certifiée se différencie d’une signature numérique de plusieurs manières :

Elle doit être la première signature appliquée au document PDF ; cela veut dire que lorsque la signature certifiée est appliquée, tous les autres champs de signature du document doivent être non signés. Une seule signature certifiée est autorisée dans un document PDF. Si vous souhaitez signer ou certifier un document PDF, vous devez le certifier avant de le signer. Après avoir certifié un document PDF, vous pouvez signer numériquement les champs de signature supplémentaires.
L’auteur ou l’expéditeur du document peut indiquer que le document peut être modifié de certaines manières sans invalider la signature certifiée. Par exemple, le document peut autoriser le remplissage de formulaires ou de commentaires. Si l’auteur spécifie qu’une modification spécifique est autorisée, Acrobat limite ainsi les utilisateurs dans la modification du document. Si ces modifications sont effectuées, à l’aide d’une autre application par exemple, la signature certifiée est alors non valide et Acrobat affiche un avertissement à l’ouverture du document. (Avec des signatures non certifiées, les modifications ne sont pas empêchées et les opérations normales de modification n’invalident pas la signature d’origine.)
Au moment de la signature, les différents types de contenus du document susceptibles de rendre le document ambigu ou trompeur sont analysés. Par exemple, une annotation peut assombrir du texte sur une page qui est essentiel pour comprendre ce qui est certifié. Une explication (attestation légale) peut être fournie pour un type de contenu.

Vous pouvez certifier des documents PDF par programmation à l’aide de l’API Java du service Signature ou de l’API du service Web de signature. Lors de la certification d’un document PDF, vous devez référencer des informations d’identification de sécurité qui existent dans le service d’informations d’identification. Pour plus d’informations sur les informations d’identification de sécurité, consultez le guide Installation et déploiement d’AEM Forms correspondant à votre serveur d’applications.

REMARQUE

Lors de la certification et de la signature du même document PDF, si la signature de certification n’est pas approuvée, un triangle jaune s’affiche en regard de la signature du premier signe lorsque vous ouvrez le document PDF dans Acrobat ou Adobe Reader. La signature de certification doit être fiable pour éviter cette situation.

REMARQUE

Lors de l’utilisation d’informations d’identification HSM nShield pour signer ou certifier un document PDF, les nouvelles informations d’identification ne peuvent pas être utilisées tant que le serveur d’applications J2EE sur lequel AEM Forms est déployé n’a pas été redémarré. Cependant, vous pouvez définir une valeur de configuration, ce qui entraîne le fonctionnement de l’opération de signature ou de certification sans redémarrer le serveur d’applications J2EE.

Vous pouvez ajouter la valeur de configuration suivante dans le fichier cknfastrc, qui se trouve sous /opt/nfast/cknfastrc (ou c:\nfast\cknfastrc) :

             CKNFAST_ASSUME_SINGLE_PROCESS=0

Après avoir ajouté cette valeur de configuration au fichier .cknfastrc, les nouvelles informations d’identification peuvent être utilisées sans redémarrer le serveur d’applications J2EE.

REMARQUE

Pour plus d’informations sur le service Signature et la certification d’un document, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour certifier un document PDF, effectuez les tâches suivantes :

Inclure les fichiers de projet.
Créez un client Signature.
Obtenez le document PDF à certifier.
Certifiez le document PDF.
Enregistrez le document PDF certifié au format PDF.

Inclure les fichiers de projet

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)

Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

Création d’un client Signature

Avant d’effectuer par programmation une opération Signature, vous devez créer un client Signature.

Obtention du document PDF à certifier

Pour certifier un document PDF, vous devez obtenir un document PDF contenant un champ de signature. Si un document PDF ne contient pas de champ de signature, il ne peut pas être certifié. Vous pouvez ajouter un champ de signature à l’aide de Designer ou par programmation. Pour plus d’informations sur l’ajout par programmation d’un champ de signature, voir Ajout de champs de signature.

Certifier le document PDF

Pour certifier correctement un document PDF, vous avez besoin des valeurs d’entrée suivantes utilisées par le service Signature pour certifier un document PDF :

Document PDF : Un document PDF contenant un champ de signature, qui est un champ de formulaire contenant une représentation graphique de la signature certifiée. Un document PDF doit contenir un champ de signature pour pouvoir être certifié. Vous pouvez ajouter un champ de signature à l’aide de Designer ou par programmation. (Voir Ajout de champs de signature.)
Nom du champ de signature : Nom qualifié complet du champ de signature certifié. La valeur suivante est un exemple : form1[0].#subform[1].SignatureField3[3]. Lors de l’utilisation d’un champ de formulaire XFA, le nom partiel du champ de signature peut également être utilisé : SignatureField3[3]. Si une valeur null est transmise pour le nom du champ, un champ de signature invisible est créé et certifié dynamiquement.
Informations d’identification de sécurité : Informations d’identification utilisées pour certifier le document PDF. Ces informations d’identification de sécurité contiennent un mot de passe et un alias, qui doivent correspondre à un alias qui apparaît dans les informations d’identification situées dans le service d’informations d’identification. L’alias est une référence à des informations d’identification réelles qui peuvent se trouver dans un fichier PKCS#12 (avec une extension .pfx) ou un module de sécurité matérielle (HSM).
Algorithme de hachage : Algorithme de hachage à utiliser pour condenser le document PDF.
Motif de la signature : Une valeur qui s’affiche dans Acrobat ou Adobe Reader afin que d’autres utilisateurs connaissent la raison pour laquelle le document PDF a été certifié.
Emplacement du signataire : Emplacement du signataire spécifié par les informations d’identification.
Coordonnées : Les informations de contact, telles que l’adresse et le numéro de téléphone, du signataire.
Informations d’autorisation : Autorisations qui contrôlent les actions qu’un utilisateur final peut effectuer sur un document sans que la signature certifiée ne soit invalide. Par exemple, vous pouvez définir l’autorisation de sorte que toute modification apportée au document PDF entraîne l’invalidation de la signature certifiée.
Explication juridique : Lorsqu’un document est certifié, il est automatiquement analysé à la recherche de types de contenu spécifiques susceptibles de rendre le contenu d’un document ambigu ou trompeur. Par exemple, une annotation peut assombrir du texte sur une page qui est essentiel pour comprendre ce qui est certifié. Le processus d’analyse génère des avertissements concernant ces types de contenu. Cette valeur fournit une explication supplémentaire du contenu susceptible d’avoir généré des avertissements.
Options d’aspect : Options qui contrôlent l’aspect de la signature certifiée. Par exemple, la signature certifiée peut afficher des informations sur la date.
Vérification de révocation : Cette valeur indique si la vérification de révocation est effectuée pour le certificat du signataire. Le paramètre par défaut false signifie que la vérification de révocation n’est pas effectuée.
Paramètres OCSP : Paramètres de prise en charge du protocole OCSP (Online Certificate Status Protocol), qui fournit des informations sur l’état des informations d’identification utilisées pour certifier le document PDF. Vous pouvez, par exemple, spécifier l’URL du serveur qui fournit des informations sur les informations d’identification que vous utilisez pour vous connecter au document PDF.
Paramètres CRL : Paramètres des préférences de liste de révocation des certificats (CRL) si la vérification de révocation est effectuée. Par exemple, vous pouvez spécifier de toujours vérifier si des informations d’identification ont été révoquées.
Horodatage : Paramètres qui définissent les informations d’horodatage appliquées à la signature certifiée. Un horodatage indique que des données spécifiques ont été établies avant une certaine période. Ces connaissances contribuent à établir une relation de confiance entre le signataire et le vérificateur.

Enregistrement du document PDF certifié en tant que fichier PDF

Une fois que le service Signature a certifié le document PDF, vous pouvez l’enregistrer au format PDF afin que les utilisateurs puissent l’ouvrir dans Acrobat ou Adobe Reader.

Voir également

Certification de documents PDF à l’aide de l’API du service Web

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Certification de documents PDF

Certifier des documents PDF à l’aide de l’API Java

Certifier un document PDF à l’aide de l’API Signature (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar, dans le chemin de classe de votre projet Java.
Création d’un client Signature
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtention du document PDF à certifier
- Créez un objet java.io.FileInputStream qui représente le document PDF à certifier en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Certifier le document PDF

Certifiez le document PDF en appelant la méthode certify de l’objet SignatureServiceClient et en transmettant les valeurs suivantes :
- Objet com.adobe.idp.Document représentant le document PDF à certifier.
- Une valeur string qui représente le nom du champ de signature qui contiendra la signature.
- Objet Credential représentant les informations d’identification utilisées pour certifier le document PDF. Créez un objet Credential en appelant la méthode getInstance statique de l’objet Credential et en transmettant une valeur string qui spécifie la valeur alias qui correspond aux informations d’identification de sécurité.
- Objet HashAlgorithm spécifiant un membre de données statique qui représente l’algorithme de hachage utilisé pour condenser le document PDF. Par exemple, vous pouvez spécifier HashAlgorithm.SHA1 pour utiliser l’algorithme SHA1.
- Une valeur string qui représente la raison pour laquelle le document PDF a été certifié.
- Une valeur string qui représente les informations de contact du signataire.
- Objet MDPPermissions qui spécifie les actions pouvant être effectuées sur le document PDF qui invalide la signature.
- Objet PDFSignatureAppearanceOptions contrôlant l’aspect de la signature certifiée. Si vous le souhaitez, modifiez l’aspect de la signature en appelant une méthode, telle que setShowDate.
- Une valeur string qui fournit une explication des actions qui invalident la signature.
- Objet java.lang.Boolean qui spécifie s’il faut effectuer une vérification de révocation sur le certificat du signataire. Si cette vérification de révocation est effectuée, elle est incorporée dans la signature. La valeur par défaut est de false.
- Objet java.lang.Boolean qui spécifie si le champ de signature en cours de certification est verrouillé. Si le champ est verrouillé, le champ de signature est marqué comme en lecture seule, ses propriétés ne peuvent pas être modifiées et il ne peut pas être effacé par quiconque ne dispose pas des autorisations requises. La valeur par défaut est de false.
- Objet OCSPPreferences qui stocke les préférences pour la prise en charge du protocole OCSP (Online Certificate Status Protocol). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null. Pour plus d’informations sur cet objet, voir Référence de l’API AEM Forms.
- Objet CRLPreferences qui stocke les préférences de liste de révocation des certificats (CRL). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet TSPPreferences qui stocke les préférences pour la prise en charge du fournisseur d’horodatage (TSP). Par exemple, après avoir créé un objet TSPPreferences, vous pouvez définir l’URL du serveur TSP en appelant la méthode setTspServerURL de l’objet TSPPreferences. Ce paramètre est facultatif et peut être null. Pour plus d’informations, voir Référence des services pour AEM Forms.
La méthode certify renvoie un objet com.adobe.idp.Document représentant le document PDF certifié.
Enregistrement du document PDF certifié en tant que fichier PDF
- Créez un objet java.io.File et assurez-vous que l’extension du fichier est .pdf.
- Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier.

Voir également

Démarrage rapide (mode SOAP) : Certification d’un document PDF à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Certification de documents PDF

Certifier des documents PDF à l’aide de l’API de service Web

Certifier un document PDF à l’aide de l’API Signature (service Web) :

Inclure les 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/SignatureService?WSDL&lc_version=9.0.1.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Signature
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
Obtention du document PDF à certifier
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF certifié.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF à certifier et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de flux en appelant la méthode 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.
- Renseignez l’objet BLOB en attribuant à son membre de données MTOM le contenu du tableau d’octets.
Certifier le document PDF

Certifiez le document PDF en appelant la méthode certify de l’objet SignatureServiceClient et en transmettant les valeurs suivantes :
- Objet BLOB représentant le document PDF à certifier.
- Une valeur string qui représente le nom du champ de signature qui contiendra la signature.
- Objet Credential représentant les informations d’identification utilisées pour certifier le document PDF. Créez un objet Credential à l’aide de son constructeur, puis spécifiez l’alias en attribuant une valeur à la propriété alias de l’objet Credential.
- Objet HashAlgorithm spécifiant un membre de données statique qui représente l’algorithme de hachage utilisé pour condenser le document PDF. Par exemple, vous pouvez spécifier HashAlgorithm.SHA1 pour utiliser l’algorithme SHA1.
- Valeur boolean qui spécifie si l’algorithme de hachage est utilisé.
- Une valeur string qui représente la raison pour laquelle le document PDF a été certifié.
- Une valeur string qui représente l’emplacement du signataire.
- Une valeur string qui représente les informations de contact du signataire.
- Un membre de données statique d’objet MDPPermissions qui spécifie les actions pouvant être effectuées sur le document PDF qui invalide la signature.
- Une valeur boolean qui spécifie s’il faut utiliser l’objet MDPPermissions qui a été transmis comme valeur de paramètre précédente.
- Une valeur string qui explique les actions qui invalident la signature.
- Objet PDFSignatureAppearanceOptions contrôlant l’aspect de la signature certifiée. Créez un objet PDFSignatureAppearanceOptions en utilisant son constructeur. Vous pouvez modifier l’aspect de la signature en définissant l’un de ses membres de données.
- Objet System.Boolean qui spécifie s’il faut effectuer une vérification de révocation sur le certificat du signataire. Si cette vérification de révocation est effectuée, elle est incorporée dans la signature. La valeur par défaut est de false.
- Objet System.Boolean qui spécifie si le champ de signature en cours de certification est verrouillé. Si le champ est verrouillé, le champ de signature est marqué comme en lecture seule, ses propriétés ne peuvent pas être modifiées et il ne peut pas être effacé par quiconque ne dispose pas des autorisations requises. La valeur par défaut est de false.
- Objet System.Boolean qui spécifie si le champ de signature est verrouillé. En d’autres termes, si vous transmettez true au paramètre précédent, transmettez true à ce paramètre.
- Objet OCSPPreferences qui stocke des préférences pour la prise en charge du protocole OCSP (Online Certificate Status Protocol), qui fournit des informations sur l’état des informations d’identification utilisées pour certifier le document PDF. Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet CRLPreferences qui stocke les préférences de liste de révocation des certificats (CRL). Si la vérification de révocation n’est pas effectuée, ce paramètre n’est pas utilisé et vous pouvez spécifier null.
- Objet TSPPreferences qui stocke les préférences pour la prise en charge du fournisseur d’horodatage (TSP). Par exemple, après avoir créé un objet TSPPreferences, vous pouvez définir l’URL du fournisseur de services de données en définissant le membre de données tspServerURL de l’objet TSPPreferences. Ce paramètre est facultatif et peut être null.
La méthode certify renvoie un objet BLOB représentant le document PDF certifié.
Enregistrement du document PDF certifié en tant que fichier PDF
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF qui contiendra le document PDF certifié et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet BLOB renvoyé par la méthode certify. Renseignez le tableau d’octets en obtenant la valeur du membre de données binaryData de l’objet BLOB.
- Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
- Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également

Vérification des signatures numériques à l’aide de l’API Java

Vérification des signatures numériques

Les signatures numériques peuvent être vérifiées pour vous assurer qu’un document PDF signé n’a pas été modifié et que la signature numérique est valide. Lors de la vérification d’une signature numérique, vous pouvez vérifier l’état de la signature et les propriétés de la signature, telles que l’identité du signataire. Avant d’approuver une signature numérique, il est recommandé de la vérifier. Lors de la vérification d’une signature numérique, référencez un document PDF contenant une signature numérique.

Supposons que l’identité du signataire soit inconnue. Lorsque vous ouvrez le document PDF dans Acrobat, un message d’avertissement indique que l’identité du signataire est inconnue, comme illustré ci-dessous.

vd_vd_verifysig

De même, lorsque vous vérifiez par programmation une signature numérique, vous pouvez déterminer l’état de l’identité du signataire. Par exemple, si vous vérifiez la signature numérique dans le document illustré ci-dessus, l’identité du signataire est inconnue.

REMARQUE

Pour plus d’informations sur le service Signature et la vérification des signatures numériques, voir Guide de référence des services pour AEM Forms.

Résumé des étapes

Pour vérifier une signature numérique, effectuez les tâches suivantes :

Inclure les fichiers de projet.
Créez un client Signature.
Obtenez le document PDF contenant la signature à vérifier.
Définissez les options d’exécution PKI.
Vérifiez la signature numérique.
Déterminez l’état de la signature.
Déterminez l’identité du signataire.

Inclure les fichiers de projet

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)

Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

Création d’un client Signature

Avant d’effectuer une opération de service Signature par programmation, créez un client de service Signature.

Obtention du document PDF contenant la signature à vérifier

Pour vérifier une signature utilisée pour signer ou certifier numériquement un document PDF, obtenez un document PDF contenant une signature.

Définition des options d’exécution PKI

Définissez les options d’exécution PKI que le service Signature utilise lors de la vérification des signatures dans un document PDF :

Heure de vérification
Vérification de révocation
Valeurs d’horodatage

Dans le cadre de la définition de ces options, vous pouvez spécifier l’heure de vérification. Par exemple, vous pouvez sélectionner l’heure actuelle (l’heure sur l’ordinateur du programme de validation), qui indique d’utiliser l’heure actuelle. Pour plus d’informations sur les différentes valeurs temporelles, voir la valeur de l’énumération VerificationTime dans Référence de l’API AEM Forms.

Vous pouvez également indiquer si la vérification de révocation doit être effectuée dans le cadre du processus de vérification. Par exemple, vous pouvez effectuer une vérification de révocation pour déterminer si le certificat est révoqué. Pour plus d’informations sur les options de vérification de révocation, voir la valeur de l’énumération RevocationCheckStyle dans Référence de l’API AEM Forms.

Pour effectuer une vérification de révocation sur un certificat, spécifiez une URL vers un serveur de liste de révocation des certificats (CRL) à l’aide d’un objet CRLOptionSpec . Cependant, si vous ne spécifiez pas d’URL vers le serveur CRL, le service Signature obtient l’URL à partir du certificat.

Au lieu d’utiliser un serveur CRL, vous pouvez utiliser un serveur OCSP (Online Certificate Status Protocol) lors de la vérification de révocation. En règle générale, lorsque vous utilisez un serveur OCSP plutôt qu’un serveur CRL, la vérification de révocation est plus rapide. (Voir Protocole d’état du certificat en ligne.)

Vous pouvez définir la liste de révocation des certificats et l’ordre du serveur OCSP que le service Signature utilise à l’aide des applications et services Adobe. Par exemple, si le serveur OCSP est d’abord défini dans Applications et services Adobe, alors le serveur OCSP est coché, suivi du serveur CRL.

Si vous n’effectuez pas de vérification de révocation, le service Signature ne vérifie pas si le certificat est révoqué. En d’autres termes, les informations de CRL et du serveur OCSP sont ignorées.

REMARQUE

Vous pouvez remplacer l’URL spécifiée dans le certificat à l’aide d’un objet CRLOptionSpec et OCSPOptionSpec. Par exemple, pour remplacer le serveur CRL, vous pouvez appeler la méthode CRLOptionSpec de l’objet setLocalURI.

L’horodatage est le processus de suivi de l’heure de modification d’un document signé ou certifié. Une fois le document signé, personne ne peut le modifier. L’horodatage permet d’assurer la validité d’un document signé ou certifié. Vous pouvez définir des options d’horodatage à l’aide d’un objet TSPOptionSpec. Par exemple, vous pouvez spécifier l’URL d’un serveur de fournisseur d’horodatage (TSP).

REMARQUE

Dans les démarrages rapides de Java et de service Web, l’heure de vérification est définie sur VerificationTime.CURRENT_TIME et la vérification de révocation sur RevocationCheckStyle.BestEffort. Comme aucune information de CRL ou de serveur OCSP n’est spécifiée, les informations du serveur sont obtenues à partir du certificat.

Vérification de la signature numérique

Pour vérifier une signature, indiquez le nom qualifié complet du champ de signature qui contient la signature, tel que form1[0].#subform[1].SignatureField3[3]. Lors de l’utilisation d’un champ de formulaire XFA, vous pouvez également utiliser le nom partiel du champ de signature : SignatureField3.

Par défaut, le service Signature limite à 65 minutes la durée pendant laquelle un document peut être signé après validation. Si un utilisateur tente de vérifier une signature à l’heure actuelle et que l’heure de signature est postérieure à l’heure actuelle et qu’elle est inférieure à 65 minutes, le service Signature ne crée pas d’erreur de vérification.

REMARQUE

Pour connaître les autres valeurs dont vous avez besoin lors de la vérification d’une signature, voir Référence de l’API AEM Forms.

Déterminer l’état de la signature

Dans le cadre de la vérification d’une signature numérique, vous pouvez vérifier l’état de la signature.

Détermination de l’identité du signataire

Vous pouvez déterminer l’identité du signataire, qui peut être l’une des valeurs suivantes :

Inconnu : Ce signataire est inconnu, car la vérification du signataire ne peut pas être effectuée.
Trusted : Ce signataire est fiable.
Non approuvé : Ce signataire n’est pas approuvé.

Voir également

Vérification des signatures numériques à l’aide de l’API de service Web

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Vérification des signatures numériques

Vérifier les signatures numériques à l’aide de l’API Java

Vérifiez une signature numérique à l’aide de l’API Signature Service (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Création d’un client Signature
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtention du document PDF contenant la signature à vérifier
- Créez un objet java.io.FileInputStream qui représente le document PDF contenant la signature à vérifier à l’aide de son constructeur. Transmettez une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Définition des options d’exécution PKI
- Créez un objet PKIOptions en utilisant son constructeur.
- Définissez l’heure de vérification en appelant la méthode PKIOptions de l’objet setVerificationTime et en transmettant une valeur d’énumération VerificationTime qui spécifie l’heure de vérification.
- Définissez l’option revocation-check en appelant la méthode setRevocationCheckStyle de l’objet PKIOptions et en transmettant une valeur d’énumération RevocationCheckStyle qui spécifie s’il est nécessaire d’effectuer une vérification de révocation.
Vérification de la signature numérique

Vérifiez la signature en appelant la méthode SignatureServiceClient de l’objet verify2 et en transmettant les valeurs suivantes :
- Objet com.adobe.idp.Document contenant un document PDF signé numériquement ou certifié.
- Une valeur string qui représente le nom du champ de signature qui contient la signature à vérifier.
- Objet PKIOptions contenant les options d’exécution PKI.
- Une instance VerifySPIOptions contenant des informations SPI. Vous pouvez spécifier null pour ce paramètre.
La méthode verify2 renvoie un objet PDFSignatureVerificationInfo contenant des informations qui peuvent être utilisées pour vérifier la signature numérique.
Déterminer l’état de la signature
- Déterminez l’état de la signature en appelant la méthode getStatus de l’objet PDFSignatureVerificationInfo. Cette méthode renvoie un objet SignatureStatus qui spécifie l’état de signature. Par exemple, si un document PDF signé n’est pas modifié, cette méthode renvoie SignatureStatus.DocumentSigNoChanges.
Détermination de l’identité du signataire
- Déterminez l’identité du signataire en appelant la méthode getSigner de l’objet PDFSignatureVerificationInfo. Cette méthode renvoie un objet IdentityInformation .
- Appelez la méthode getStatus de l’objet IdentityInformation pour déterminer l’identité du signataire. Cette méthode renvoie une valeur d’énumération IdentityStatus qui spécifie l’identité. Par exemple, si le signataire est approuvé, cette méthode renvoie IdentityStatus.TRUSTED.

Voir également

Démarrage rapide (mode SOAP) : Vérification d’une signature numérique à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Vérification des signatures numériques

Vérifier les signatures numériques à l’aide de l’API de service Web

Vérifiez une signature numérique à l’aide de l’API Signature Service (service Web) :

Inclure les 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/SignatureService?WSDL&lc_version=9.0.1.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Signature
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
Obtention du document PDF contenant la signature à vérifier
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF contenant une signature numérique ou certifiée à vérifier.
- Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur string qui représente l’emplacement du fichier du document PDF signé et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream. Transmettez le tableau d’octets, la position de départ et la longueur du flux à lire.
- Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.
Définition des options d’exécution PKI
- Créez un objet PKIOptions en utilisant son constructeur.
- Définissez l’heure de vérification en attribuant au membre de données verificationTime de l’objet PKIOptions une valeur d’énumération VerificationTime qui spécifie l’heure de vérification.
- Définissez l’option revocation-check en attribuant au membre de données revocationCheckStyle de l’objet PKIOptions une valeur d’énumération RevocationCheckStyle qui spécifie s’il faut effectuer une vérification de révocation.
Vérification de la signature numérique

Vérifiez la signature en appelant la méthode SignatureServiceClient de l’objet verify2 et en transmettant les valeurs suivantes :
- Objet BLOB contenant un document PDF signé numériquement ou certifié.
- Une valeur string qui représente le nom du champ de signature qui contient la signature à vérifier.
- Objet PKIOptions contenant les options d’exécution PKI.
- Une instance VerifySPIOptions contenant des informations SPI. Vous pouvez spécifier null pour ce paramètre.
La méthode verify2 renvoie un objet PDFSignatureVerificationInfo contenant des informations qui peuvent être utilisées pour vérifier la signature numérique.
Déterminer l’état de la signature

Déterminez l’état de la signature en obtenant la valeur du membre de données status de l’objet PDFSignatureVerificationInfo. Ce membre de données stocke un objet SignatureStatus qui spécifie l’état de la signature. Par exemple, si un document PDF signé est modifié, le membre de données status stocke la valeur SignatureStatus.DocumentSigNoChanges.
Détermination de l’identité du signataire
- Déterminez l’identité du signataire en récupérant la valeur du membre de données signer de l’objet PDFSignatureVerificationInfo. Ce membre renvoie un objet IdentityInformation.
- Récupérez le membre de données status de l’objet IdentityInformation pour déterminer l’identité du signataire. Ce membre de données renvoie une valeur d’énumération IdentityStatus qui spécifie l’identité. Par exemple, si le signataire est approuvé, ce membre renvoie IdentityStatus.TRUSTED.

Voir également

Vérification de plusieurs signatures numériques à l’aide de l’API Java

Vérification de plusieurs signatures numériques

AEM Forms permet de vérifier toutes les signatures numériques contenues dans un document PDF. Supposons qu’un document PDF contienne plusieurs signatures numériques suite à un processus d’entreprise qui requiert des signatures de plusieurs signataires. Prenons l’exemple d’une transaction financière qui requiert à la fois la signature d’un agent de prêt et celle d’un responsable. Vous pouvez utiliser l’API Java du service Signature ou l’API du service Web pour vérifier toutes les signatures du document PDF. Lors de la vérification de plusieurs signatures numériques, vous pouvez vérifier l’état et les propriétés de chaque signature. Avant de faire confiance à une signature numérique, il est recommandé de la vérifier. Il est recommandé de vous familiariser avec la vérification d’une signature numérique unique.

REMARQUE

Pour plus d’informations sur le service Signature et la vérification des signatures numériques, voir Guide de référence des services pour AEM Forms.

Résumé des étapes

Pour vérifier plusieurs signatures numériques, effectuez les tâches suivantes :

Inclure les fichiers de projet.
Créez un client Signature.
Obtenez le document PDF contenant les signatures à vérifier.
Définissez les options d’exécution PKI.
Récupérez toutes les signatures numériques.
Parcourez toutes les signatures.

Inclure les fichiers de projet

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)

Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

Création d’un client Signature

Avant d’effectuer une opération de service Signature par programmation, créez un client de service Signature.

Obtention du document PDF contenant les signatures à vérifier

Pour vérifier une signature utilisée pour signer ou certifier numériquement un document PDF, obtenez un document PDF contenant une signature.

Définition des options d’exécution PKI

Définissez les options d’exécution PKI que le service Signature utilise lors de la vérification de toutes les signatures d’un document PDF :

Heure de vérification
Vérification de révocation
Valeurs d’horodatage

Pour effectuer une vérification de révocation sur un certificat, spécifiez une URL vers un serveur de liste de révocation des certificats (CRL) à l’aide d’un objet CRLOptionSpec . Cependant, si vous ne spécifiez pas d’URL vers un serveur CRL, le service Signature obtient l’URL à partir du certificat.

Au lieu d’utiliser un serveur CRL, vous pouvez utiliser un serveur OCSP (Online Certificate Status Protocol) lors de la vérification de révocation. En règle générale, lorsque vous utilisez un serveur OCSP plutôt qu’un serveur CRL, la vérification de révocation est plus rapide. (Voir Protocole d’état du certificat en ligne.)

Vous pouvez définir la liste de révocation des certificats et l’ordre du serveur OCSP que le service Signature utilise à l’aide des applications et services Adobe. Par exemple, si le serveur OCSP est défini en premier dans les applications et services Adobe, le serveur OCSP est coché, suivi du serveur CRL.

REMARQUE

Récupération de toutes les signatures numériques

Pour vérifier toutes les signatures numériques présentes dans un document PDF, récupérez les signatures numériques du document PDF. Toutes les signatures sont renvoyées dans une liste. Dans le cadre de la vérification d’une signature numérique, vérifiez l’état de la signature.

REMARQUE

Contrairement à ce qui se passe lorsque vous vérifiez une signature numérique unique, lorsque vous vérifiez plusieurs signatures, vous n’êtes pas tenu de spécifier le nom du champ de signature.

Parcourir toutes les signatures

Effectuez une itération sur chaque signature. Autrement dit, pour chaque signature, vérifiez la signature numérique et vérifiez l’identité du signataire et l’état de chaque signature. (Voir Vérification des signatures numériques.)

REMARQUE

Vous n’avez pas besoin d’effectuer une itération sur toutes les signatures si l’exigence correspond à l’intégralité du document.

Voir également

Vérification de plusieurs signatures numériques à l’aide de l’API du service Web

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Vérification de plusieurs signatures numériques

Vérifier plusieurs signatures numériques à l’aide de l’API Java

Vérifiez plusieurs signatures numériques à l’aide de l’API Signature Service (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar, dans le chemin d’accès aux classes de votre projet Java.
Création d’un client Signature
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtention du document PDF contenant les signatures à vérifier
- Créez un objet java.io.FileInputStream qui représente le document PDF contenant plusieurs signatures numériques à vérifier à l’aide de son constructeur. Transmettez une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Définition des options d’exécution PKI
- Créez un objet PKIOptions en utilisant son constructeur.
- Définissez l’heure de vérification en appelant la méthode PKIOptions de l’objet setVerificationTime et en transmettant une valeur d’énumération VerificationTime qui spécifie l’heure de vérification.
- Définissez l’option de vérification de révocation en appelant la méthode PKIOptions de l’objet setRevocationCheckStyle et en transmettant une valeur d’énumération RevocationCheckStyle qui spécifie s’il est nécessaire d’effectuer une vérification de révocation.
Récupération de toutes les signatures numériques

Appelez la méthode verifyPDFDocument de l’objet SignatureServiceClient et transmettez les valeurs suivantes :
- Objet com.adobe.idp.Document contenant un document PDF contenant plusieurs signatures numériques.
- Objet PKIOptions contenant les options d’exécution PKI.
- Une instance VerifySPIOptions contenant des informations SPI. Vous pouvez spécifier null pour ce paramètre.
La méthode verifyPDFDocument renvoie un objet PDFDocumentVerificationInfo contenant des informations sur toutes les signatures numériques présentes dans le document PDF.
Parcourir toutes les signatures
- Parcourez toutes les signatures en appelant la méthode getVerificationInfos de l’objet PDFDocumentVerificationInfo. Cette méthode renvoie un objet java.util.List où chaque élément est un objet PDFSignatureVerificationInfo. Utilisez un objet java.util.Iterator pour effectuer une itération sur la liste des signatures.
- À l’aide de l’objet PDFSignatureVerificationInfo, vous pouvez effectuer des tâches, comme déterminer l’état de la signature en appelant la méthode getStatus de l’objet PDFSignatureVerificationInfo. Cette méthode renvoie un objet SignatureStatus dont le membre de données statique vous informe sur l’état de la signature. Par exemple, si la signature est inconnue, cette méthode renvoie SignatureStatus.DocumentSignatureUnknown.

Voir également

Démarrage rapide (mode SOAP) : Vérification de plusieurs signatures numériques à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Vérification des signatures numériques

Vérification de plusieurs signatures numériques

Vérification de plusieurs signatures numériques à l’aide de l’API de service Web

Vérifiez plusieurs signatures numériques à l’aide de l’API Signature Service (service Web) :

Inclure les 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/SignatureService?WSDL&lc_version=9.0.1.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Signature
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
Obtention du document PDF contenant les signatures à vérifier
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB stocke un document PDF contenant plusieurs signatures numériques à vérifier.
- Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur string qui représente l’emplacement du fichier du document PDF et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream. Transmettez le tableau d’octets, la position de départ et la longueur du flux à lire.
- Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.
Définition des options d’exécution PKI
- Créez un objet PKIOptions en utilisant son constructeur.
- Définissez l’heure de vérification en attribuant au membre de données verificationTime de l’objet PKIOptions une valeur d’énumération VerificationTime qui spécifie l’heure de vérification.
- Définissez l’option de vérification de révocation en attribuant au membre de données revocationCheckStyle de l’objet PKIOptions une valeur d’énumération RevocationCheckStyle qui spécifie s’il faut effectuer une vérification de révocation.
Récupération de toutes les signatures numériques

Appelez la méthode verifyPDFDocument de l’objet SignatureServiceClient et transmettez les valeurs suivantes :
- Objet BLOB contenant un document PDF contenant plusieurs signatures numériques.
- Objet PKIOptions contenant les options d’exécution PKI.
- Une instance VerifySPIOptions contenant des informations SPI. Vous pouvez spécifier null pour ce paramètre.
La méthode verifyPDFDocument renvoie un objet PDFDocumentVerificationInfo contenant des informations sur toutes les signatures numériques présentes dans le document PDF.
Parcourir toutes les signatures
- Parcourez toutes les signatures en obtenant le membre de données verificationInfos de l’objet PDFDocumentVerificationInfo. Ce membre de données renvoie un tableau Object où chaque élément est un objet PDFSignatureVerificationInfo.
- À l’aide de l’objet PDFSignatureVerificationInfo, vous pouvez effectuer des tâches comme déterminer l’état de la signature en obtenant le membre de données status de l’objet PDFSignatureVerificationInfo. Ce membre de données renvoie un objet SignatureStatus dont le membre de données statique vous informe sur l’état de la signature. Par exemple, si la signature est inconnue, cette méthode renvoie SignatureStatus.DocumentSignatureUnknown.

Voir également

Suppression des signatures numériques à l’aide de l’API Java

Suppression de signatures numériques

Les signatures numériques doivent être supprimées d’un champ de signature pour qu’une signature numérique plus récente puisse être appliquée. Une signature numérique ne peut pas être remplacée. Si vous tentez d’appliquer une signature numérique à un champ de signature contenant une signature, une exception se produit.

REMARQUE

Pour plus d’informations sur le service Signature, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour supprimer une signature numérique d’un champ de signature, effectuez les tâches suivantes :

Inclure les fichiers de projet.
Créez un client Signature.
Obtenez le document PDF contenant une signature à supprimer.
Supprimez la signature numérique du champ de signature.
Enregistrez le document PDF au format PDF.

Inclure les fichiers de projet

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utility.jar (obligatoire si AEM Forms est déployé sur JBoss)
jbossall-client.jar (obligatoire si AEM Forms est déployé sur JBoss)

Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

Création d’un client Signature

Avant d’effectuer par programmation une opération du service Signature, vous devez créer un client du service Signature.

Obtention du document PDF contenant une signature à supprimer

Pour supprimer une signature d’un document PDF, vous devez obtenir un document PDF contenant une signature.

Supprimer la signature numérique du champ de signature

Pour supprimer une signature numérique d’un document PDF, vous devez indiquer le nom du champ de signature qui contient la signature numérique. Vous devez également disposer des autorisations nécessaires pour supprimer la signature numérique ; dans le cas contraire, une exception se produit.

Enregistrement du document PDF en tant que fichier PDF

Une fois que le service Signature a supprimé une signature numérique d’un champ de signature, vous pouvez enregistrer le document PDF en tant que fichier PDF afin que les utilisateurs puissent l’ouvrir dans Acrobat ou Adobe Reader.

Voir également

Suppression des signatures numériques à l’aide de l’API de service Web

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Suppression de signatures numériques

Suppression des signatures numériques à l’aide de l’API Java

Supprimez une signature numérique à l’aide de l’API Signature (Java) :

Inclure les fichiers de projet

Incluez les fichiers JAR client, tels que adobe-signatures-client.jar, dans le chemin de classe de votre projet Java.
Créez un client Signature.
- Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
- Créez un objet SignatureServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.
Obtention du document PDF contenant une signature à supprimer
- Créez un objet java.io.FileInputStream qui représente le document PDF contenant la signature à supprimer à l’aide de son constructeur et en transmettant une valeur string qui spécifie l’emplacement du document PDF.
- Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
Supprimer la signature numérique du champ de signature

Supprimez une signature numérique d’un champ de signature en appelant la méthode clearSignatureField de l’objet SignatureServiceClient et en transmettant les valeurs suivantes :
- Objet com.adobe.idp.Document représentant le document PDF contenant la signature à supprimer.
- Une valeur string qui spécifie le nom du champ de signature qui contient la signature numérique.
La méthode clearSignatureField renvoie un objet com.adobe.idp.Document représentant le document PDF à partir duquel la signature numérique a été supprimée.
Enregistrement du document PDF en tant que fichier PDF
- Créez un objet java.io.File et assurez-vous que l’extension du fichier est .pdf.
- Appelez la méthode copyToFile de l’objet com.adobe.idp.Document. Transmettez l’objet java.io.File pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier. Assurez-vous d’utiliser l’objet Document qui a été retourné par la méthode clearSignatureField.

Voir également

Démarrage rapide (mode SOAP) : Suppression d’une signature numérique à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Suppression de signatures numériques

Suppression des signatures numériques à l’aide de l’API de service Web

Supprimez une signature numérique à l’aide de l’API Signature (service Web) :

Inclure les 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/SignatureService?WSDL&lc_version=9.0.1.

REMARQUE

Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un client Signature
- Créez un objet SignatureServiceClient à l’aide de son constructeur par défaut.
- Créez un objet SignatureServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/SignatureService?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 SignatureServiceClient.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 effectuant les tâches suivantes :
  - Attribuez le nom d’utilisateur AEM forms au champ SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Attribuez la valeur de mot de passe correspondante au champ SignatureServiceClient.ClientCredentials.UserName.Password.
  - Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
Obtention du document PDF contenant une signature à supprimer
- Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF contenant une signature numérique à supprimer.
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF signé et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet 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.
- Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream. Transmettez le tableau d’octets, la position de départ et la longueur du flux à lire.
- Renseignez l’objet BLOB en attribuant sa propriété MTOM avec le contenu du tableau d’octets.
Supprimer la signature numérique du champ de signature

Supprimez la signature numérique en appelant la méthode clearSignatureField de l’objet SignatureServiceClient et en transmettant les valeurs suivantes :
- Objet BLOB contenant le document PDF signé.
- Une valeur string qui représente le nom du champ de signature qui contient la signature numérique à supprimer.
La méthode clearSignatureField renvoie un objet BLOB représentant le document PDF à partir duquel la signature numérique a été supprimée.
Enregistrement du document PDF en tant que fichier PDF
- Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF qui contient un champ de signature vide et le mode d’ouverture du fichier.
- Créez un tableau d’octets qui stocke le contenu de l’objet BLOB renvoyé par la méthode sign. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
- Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.
- Ecrivez le contenu du tableau d’octets dans le fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également