Utilisation des informations d’identification

À 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 :

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 des informations d’identification par programmation dans AEM Forms à l’aide de l’API Trust Manager. Par exemple, vous pouvez importer les 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. L’alias est utilisé pour effectuer une opération 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 Secure.

www_www_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. Inclure les fichiers de projet.
  2. Créez un client de service d’identification.
  3. Référencez les informations d’identification.
  4. Effectuez l'opération d'import.

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-utility.jar (Obligatoire 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 des fichiers de bibliothèque Java AEM Forms.

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

Avant de pouvoir importer des informations d’identification par programmation 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 des informations d’identification

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

Effectuer l'opération d'import

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

Importation 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

Démarrages rapides de l’API Credential Service

Suppression d’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 les 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’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 des informations d’identification

    • Créez un objet java.io.FileInputStream en utilisant son constructeur. Transmettez une valeur string 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. Effectuer l'opération d'import

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

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

      • Une valeur string qui spécifie la valeur alias pour les informations d’identification.
      • Instance com.adobe.idp.Document qui stocke les informations d’identification.
      • Une valeur string 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émarrage rapide (mode SOAP) : Importation 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

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

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 spécifiez un alias correspondant à ces informations. Une fois supprimées, les informations d’identification ne peuvent pas ê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. Inclure les fichiers de projet.
  2. Créez un client de service 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 d’accès aux classes de votre projet :

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utility.jar (Obligatoire 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 des fichiers de bibliothèque Java AEM Forms.

Création d’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é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 d’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 les 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’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 deleteCredential de l’objet CredentialServiceClient et transmettez une valeur string qui spécifie la valeur d’alias.

Voir également

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

Démarrage rapide (mode SOAP) : Suppression 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

Sur cette page