Utilisation des informations d'identification

Les exemples et exemples de ce document ne concernent que l’environnement AEM Forms on JEE.

À propos du service d’informations 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 :

Vous pouvez interagir par programmation avec le service d’informations d’identification à l’aide de l’API Java Trust Manager. Vous pouvez effectuer les tâches suivantes :

REMARQUE

Vous pouvez également importer et supprimer des certificats à l’aide d’Administration Console. (Voir Aide à l'administration.)

Importation des informations d’identification à l’aide de l’API Trust Manager

Vous pouvez importer par programmation des informations d’identification dans AEM Forms à l’aide de l’API Trust Manager. Par exemple, vous pouvez importer des informations d’identification utilisées pour signer un document PDF. (Voir Signature numérique de Documents PDF).

Lors de l’importation d’informations d’identification, vous spécifiez un alias pour ces informations d’identification. L’alias est utilisé pour effectuer une opération Forms nécessitant des informations d’identification. Une fois importé, les informations d’identification peuvent être affichées dans Administration Console, comme le montre l’illustration suivante. Notez que l’alias des informations d’identification est Secure.

ww_ww_truststore

REMARQUE

Vous ne pouvez pas importer d’informations d’identification dans AEM Forms à l’aide de services Web.

Résumé des étapes

Pour importer des informations d’identification dans AEM Forms, procédez comme suit :

  1. Incluez des fichiers de projet.
  2. Créez un client de service d’informations d’identification.
  3. Référencez les informations d’identification.
  4. 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 de classe 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, voir Inclusion de fichiers de bibliothèque Java AEM Forms.

Création d’un client de service d’informations d’identification

Avant de pouvoir importer par programmation des informations d’identification dans AEM Forms, créez un client de service d’informations d’identification. Pour plus d’informations, voir Définition des propriétés de connexion.

Référence aux informations d’identification

Référencez les informations d’identification que vous souhaitez importer dans AEM Forms. Le début rapide associé à cette section fait référence à un fichier P12 situé dans le système de fichiers.

Exécution de 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 levée. Lors de l’importation d’informations d’identification, vous spécifiez un alias pour ces informations d’identification.

Voir également

Importation des informations d’identification à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Débuts rapides de l’API Credential Service

Suppression des informations d’identification à l’aide de l’API Trust Manager

Importer des informations d’identification à l’aide de l’API Java

Importez des informations d’identification dans AEM Forms à l’aide de l’API Trust Manager (Java) :

  1. Inclure les fichiers de projet

    Incluez des fichiers JAR client, tels que adobe-truststore-client.jar, dans le chemin de classe de votre projet Java.

  2. Création d’un client de service d’informations 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’objet ServiceClientFactory.
  3. Référence aux 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 constructeur com.adobe.idp.Document. Transmettez l'objet java.io.FileInputStream contenant les informations d'identification au constructeur.
  4. Exécution de l’opération d’importation

    • Créez un tableau de chaînes contenant un élément. Affectez la valeur truststore.usage.type.sign à l’élément.

    • Appelez la méthode importCredential de l’objet CredentialServiceClient et transmettez les valeurs suivantes :

      • Valeur de chaîne qui spécifie la valeur d’alias pour les informations d’identification.
      • Instance com.adobe.idp.Document qui stocke les informations d’identification.
      • Valeur de chaîne qui spécifie le mot de passe associé aux informations d’identification.
      • Tableau de chaînes contenant la valeur d’utilisation. Par exemple, vous pouvez spécifier cette valeur truststore.usage.type.sign. Pour importer des informations d’identification d’extension de Reader, spécifiez truststore.usage.type.lcre.

Voir également

Importation des informations d’identification à l’aide de l’API Trust Manager

Début rapide (mode SOAP) : Importation des informations d’identification à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Suppression des informations d’identification à l’aide de l’API Trust Manager

Vous pouvez supprimer par programmation des informations d’identification à l’aide de l’API Trust Manager. Lors de la suppression d’informations d’identification, vous spécifiez un alias correspondant aux informations d’identification. Une fois supprimée, les informations d’identification ne peuvent plus être utilisées pour effectuer une opération.

REMARQUE

Vous ne pouvez pas supprimer d’informations d’identification dans AEM Forms à l’aide de services Web.

Résumé des étapes

Pour supprimer des informations d’identification, procédez comme suit :

  1. Incluez des fichiers de projet.
  2. Créez un client de service d’informations d’identification.
  3. 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 de classe 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, voir Inclusion de fichiers de bibliothèque Java AEM Forms.

Création d’un client de service d’informations d’identification

Avant de pouvoir supprimer par programmation des informations d’identification, 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écution de l’opération de suppression

Pour supprimer des informations d’identification, spécifiez l’alias correspondant aux informations d’identification. Si vous spécifiez un alias qui n’existe pas, une exception est générée.

Voir également

Importation des informations d’identification à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Importation des informations d’identification à l’aide de l’API Java

Suppression des informations d’identification à l’aide de l’API Java

Supprimez des informations d’identification d’AEM Forms à l’aide de l’API Trust Manager (Java) :

  1. Inclure les fichiers de projet

    Incluez des fichiers JAR client, tels que adobe-truststore-client.jar, dans le chemin de classe de votre projet Java.

  2. Création d’un client de service d’informations 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’objet ServiceClientFactory.
  3. Exécution de l’opération de suppression

    Appelez la méthode CredentialServiceClient de l’objet deleteCredential et transmettez une valeur de chaîne qui spécifie la valeur d’alias.

Voir également

Suppression des informations d’identification à l’aide de l’API Trust Manager

Début rapide (mode SOAP) : Suppression des informations d’identification à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Sur cette page