Utiliser des informations d’identification working-with-credentials
Les exemples et les échantillons de ce document sont réservés à l’environnement AEM Forms sur JEE.
À propos du service d’identification
Les informations d’identification contiennent les informations de clé privée dont vous avez besoin pour signer ou identifier des documents. Un certificat correspond aux informations de clé publique que vous configurez pour l’approbation. AEM Forms utilise des certificats et des informations d’identification à plusieurs fins :
- Les extensions d’Acrobat Reader DC utilisent des informations d’identification pour activer les droits Adobe Reader des documents PDF (Consultez la section Appliquer des droits d’utilisation aux documents PDF).
- Le service Signature accède aux certificats et aux informations d’identification lors d’opérations telles que la signature numérique de documents PDF. (Consultez la section Signer numériquement des documents PDF).
Vous pouvez interagir par programmation avec le service d’identification à l’aide de l’API Java Trust Manager. Vous pouvez effectuer les tâches suivantes :
Importer des informations d’identification à l’aide de l’API Trust Manager importing-credentials-by-using-the-trust-manager-api
Vous pouvez importer des informations d’identification par programmation dans AEM Forms à l’aide de l’API Trust Manager. Par exemple, vous pouvez importer des informations d’identification nécessaires pour signer un document PDF. (Consultez la section Signer numériquement des documents PDF).
Lors de l’importation d’informations d’identification, vous spécifiez un alias pour ces informations. Il est utilisé pour effectuer une opération dans AEM Forms nécessitant des informations d’identification. Une fois les informations d’identification importées, elles peuvent être affichées dans la console d’administration, comme illustré ci-dessous. Notez que l’alias des informations d’identification est Sécurisé.
Résumé des étapes summary-of-steps
Pour importer des informations d’identification dans AEM Forms, procédez comme suit :
- Incluez les fichiers de projet.
- Créez un client de service d’identification.
- Référencez les informations d’identification.
- Effectuez lʼopération dʼimportation.
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.
Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-truststore-client.jar
- adobe-utilities.jar (Requis si AEM Forms est déployé sur JBoss)
- jbossall-client.jar (Requis si AEM Forms est déployé sur JBoss)
Pour plus d’informations sur l’emplacement de ces fichiers JAR, consultez la section Inclure des fichiers de bibliothèque Java AEM Forms.
Créer un client de service d’identification
Avant de pouvoir importer des informations d’identification par programmation dans AEM Forms, vous devez créer un client de service d’identification. Pour plus d’informations, consultez la section Définir des propriétés de connexion.
Référencer les informations d’identification
Référencez les informations d’identification à importer dans AEM Forms. Le démarrage rapide correspondant à cette section fait référence à un fichier P12 situé dans le système de fichiers.
Effectuer lʼopération dʼimportation
Après avoir référencé les informations d’identification, importez-les dans AEM Forms. Si l’importation des informations d’identification échoue, une exception est générée. Lors de l’importation d’informations d’identification, vous spécifiez un alias pour ces informations.
Voir également
Importer des informations d’identification à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Didacticiels de mise en route de l’API Credential Service
Supprimer des informations d’identification à l’aide de l’API Trust Manager
Importer des informations d’identification à l’aide de l’API Java import-credentials-using-the-java-api
Importez des informations d’identification dans AEM Forms à l’aide de l’API Trust Manager (Java) :
-
Inclure les fichiers du projet
Incluez les fichiers JAR du client, tels que adobe-truststore-client.jar, dans le chemin d’accès aux classes de votre projet Java.
-
Créer un client de service d’identification
- Créez un objet
ServiceClientFactory
qui contient des propriétés de connexion. - Créez un objet
CredentialServiceClient
en utilisant son constructeur et en transmettant l’objetServiceClientFactory
.
- Créez un objet
-
Référencer des informations d’identification
- Créez un objet
java.io.FileInputStream
en utilisant son constructeur. Transmettez une valeur de chaîne qui spécifie l’emplacement des informations d’identification. - Créez un objet
com.adobe.idp.Document
qui stocke les informations d’identification à l’aide du constructeurcom.adobe.idp.Document
. Transmettez lʼobjetjava.io.FileInputStream
contenant les informations d’identification au constructeur.
- Créez un objet
-
Réaliser lʼopération dʼimportation
-
Créez un tableau de chaîne qui contient un élément. Attribuer la valeur
truststore.usage.type.sign
à l’élément. -
Appelez la méthode
importCredential
de lʼobjetCredentialServiceClient
et transmettez les valeurs suivantes :- Une valeur de chaîne qui spécifie la valeur de lʼalias pour les informations dʼidentification.
- Lʼinstance
com.adobe.idp.Document
qui stocke les informations d’identification. - Une valeur de chaîne qui spécifie le mot de passe associé aux informations d’identification.
- Le tableau de chaînes qui contient la valeur d’utilisation. Par exemple, vous pouvez spécifier la valeur suivante
truststore.usage.type.sign
. Pour importer des informations d’identification de Reader Extension, spécifieztruststore.usage.type.lcre
.
-
Voir également
Importer des informations d’identification à l’aide de l’API Trust Manager
Supprimer des informations d’identification à l’aide de l’API Trust Manager deleting-credentials-by-using-the-trust-manager-api
Vous pouvez supprimer des informations d’identification par programmation à l’aide de l’API Trust Manager. Lors de la suppression d’informations d’identification, vous devez spécifier un alias qui correspond à ces informations. Une fois supprimées, les informations d’identification ne peuvent pas être utilisées pour réaliser une opération.
Résumé des étapes summary_of_steps-1
Pour supprimer des informations d’identification, procédez comme suit :
- Incluez les fichiers de projet.
- Créez un client de service d’identification.
- Effectuez l’opération de suppression.
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. 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-truststore-client.jar
- adobe-utilities.jar (Requis si AEM Forms est déployé sur JBoss)
- jbossall-client.jar (Requis si AEM Forms est déployé sur JBoss)
Pour plus d’informations sur l’emplacement de ces fichiers JAR, consultez la section Inclure des fichiers de bibliothèque Java AEM Forms.
Créer un client de service d’identification
Avant de pouvoir supprimer des informations d’identification par programmation, créez un client de service d’intégration de données. Lors de la création d’un client de service, vous définissez les paramètres de connexion requis pour appeler un service. Pour plus d’informations, voir Définition des propriétés de connexion.
Exécuter l’opération de suppression
Pour supprimer des informations d’identification, indiquez l’alias correspondant à ces informations d’identification. Si vous indiquez un alias qui n’existe pas, une exception est générée.
Voir également
Importer des informations d’identification à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Importer des informations d’identification à l’aide de l’API Java
Supprimer des informations d’identification à l’aide de l’API Java deleting-credentials-using-the-java-api
Supprimez des informations d’identification d’AEM Forms à l’aide de l’API Trust Manager (Java) :
-
Inclure les fichiers du projet
Incluez les fichiers JAR du client, tels que adobe-truststore-client.jar, dans le chemin d’accès aux classes de votre projet Java.
-
Créer un client de service d’identification
- Créez un objet
ServiceClientFactory
qui contient des propriétés de connexion. - Créez un objet
CredentialServiceClient
en utilisant son constructeur et en transmettant l’objetServiceClientFactory
.
- Créez un objet
-
Exécuter l’opération de suppression
Appelez la méthode
deleteCredential
de l’objetCredentialServiceClient
et transmettez une valeur de chaîne qui spécifie la valeur d’alias.
Voir également
Supprimer des informations d’identification à l’aide de l’API Trust Manager
Démarrage rapide (mode SOAP) : supprimer des informations d’identification à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion