資格情報の操作 working-with-credentials

このドキュメントのサンプルと例は、JEE 環境の AEM Forms のみを対象としています。

資格情報サービスについて

資格情報には、ドキュメントへの署名や識別に必要な秘密鍵情報が格納されています。証明書は、信頼のために設定する公開鍵情報です。AEM Forms が証明書と資格情報を使用する目的はいくつかあります。

Trust Manager Java API を使用して、Credential サービスとプログラム経由で対話を行うことができます。次のタスクを実行できます。

NOTE
管理コンソールを使用して証明書の読み込みおよび削除を行うこともできます。(管理ヘルプを参照。)

Trust Manager API を使用した資格情報の読み込み importing-credentials-by-using-the-trust-manager-api

Trust Manager API を使用して、プログラム経由で資格情報を AEM Forms に読み込むことができます。例えば、PDF ドキュメントへの署名に使用する資格情報を読み込むことができます。(PDF ドキュメントへのデジタル署名を参照。)

資格情報を読み込む際は、資格情報のエイリアスを指定します。エイリアスは、資格情報を必要とする Forms 操作を実行する際に使用されます。次の図に示すように、読み込んだ資格情報は管理コンソールで表示できます。資格情報のエイリアスは「Secure」です。

ww_ww_truststore

NOTE
Web サービスを使用して AEM Forms に資格情報を読み込むことはできません。

手順の概要 summary-of-steps

資格情報を AEM Forms に読み込むには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. 資格情報サービスクライアントを作成します。
  3. 資格情報を参照します。
  4. 読み込み操作を実行します。

プロジェクトファイルのインクルード

必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、プロキシファイルを必ず含めるようにします。

次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar(AEM Forms を JBoss にデプロイする場合に必要)
  • jbossall-client.jar(AEM Forms が JBoss にデプロイされている場合に必要)

これらの JAR ファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。

資格情報サービスクライアントの作成

プログラム経由で資格情報を AEM Forms に読み込む前に、資格情報サービスクライアントを作成します。詳しくは、接続プロパティの設定を参照してください。

資格情報の参照

AEM Forms に読み込む資格情報を参照します。このセクションに関連するクイックスタートは、ファイルシステム内の P12 ファイルを参照します。

読み込み操作の実行

資格情報を参照した後、その資格情報を AEM Forms に読み込みます。資格情報が正常に読み込まれない場合は、例外がスローされます。資格情報を読み込む際は、資格情報のエイリアスを指定します。

関連トピック

Java API を使用した資格情報の読み込み

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Credential Service API のクイックスタート

Trust Manager API を使用した資格情報の削除

Java API を使用した資格情報の読み込み import-credentials-using-the-java-api

Trust Manager API(Java)を使用して、資格情報を AEM Forms に読み込みます。

  1. プロジェクトファイルを含める

    adobe-truststore-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

  2. 資格情報サービスクライアントの作成

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して CredentialServiceClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。
  3. 資格情報の参照

    • コンストラクタを使用して java.io.FileInputStream オブジェクトを作成します。資格情報の場所を指定する文字列値を渡します。
    • com.adobe.idp.Document コンストラクターを使用して、資格情報を保存する com.adobe.idp.Document オブジェクトを作成します。コンストラクターの資格情報が格納された java.io.FileInputStream オブジェクトを渡します。
  4. 読み込み操作の実行

    • 1 つの要素を持つ文字列配列を作成します。値 truststore.usage.type.sign を要素に割り当てます。

    • CredentialServiceClient オブジェクトの importCredential メソッドを呼び出して、次の値を渡します。

      • 資格情報のエイリアス値を指定する文字列値です。
      • 資格情報を保存する com.adobe.idp.Document インスタンス。
      • 資格情報に関連付けられるパスワードを指定する文字列値です。
      • 使用量値を含む文字列配列です。例えば、この値として truststore.usage.type.sign を指定します。Reader Extension 資格情報をインポートするには、truststore.usage.type.lcre を指定します。

関連トピック

Trust Manager API を使用した資格情報の読み込み

クイックスタート(SOAP モード):Java API を使用した資格情報のインポート

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Trust Manager API を使用した資格情報の削除 deleting-credentials-by-using-the-trust-manager-api

Trust Manager API を使用すると、プログラムにより資格情報を削除できます。資格情報を削除する際には、資格情報に対応するエイリアスを指定します。削除した後は、資格情報を使用して操作を実行できません。

NOTE
Web サービスを使用して AEM Forms の資格情報を削除することはできません。

手順の概要 summary_of_steps-1

資格情報を削除するには、以下の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. 資格情報サービスクライアントを作成します。
  3. 削除操作を実行します。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar(AEM Forms を JBoss にデプロイする場合に必要)
  • jbossall-client.jar(AEM Forms が JBoss にデプロイされている場合に必要)

これらの JAR ファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。

資格情報サービスクライアントの作成

プログラムによって資格情報を削除する前に、Data Integration サービスクライアントを作成します。サービスクライアントを作成する際は、サービスを呼び出すために必要な接続設定を定義します。詳しくは、接続プロパティの設定を参照してください。

削除操作の実行

資格情報を削除するには、資格情報に対応するエイリアスを指定します。存在しないエイリアスを指定すると、例外が発生します。

関連トピック

Java API を使用した資格情報の読み込み

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java API を使用した資格情報の読み込み

Java API を使用した資格情報の削除 deleting-credentials-using-the-java-api

Trust Manager API(Java)を使用して、AEM Forms から資格情報を削除します。

  1. プロジェクトファイルを含める

    adobe-truststore-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

  2. 資格情報サービスクライアントの作成

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して CredentialServiceClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。
  3. 削除操作の実行

    CredentialServiceClient オブジェクトの deleteCredential メソッドを呼び出して、エイリアス値を指定する文字列値を渡します。

関連トピック

Trust Manager API を使用した資格情報の削除

クイックスタート(SOAP モード):Java API を使用した資格情報の削除

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2