資格情報の操作

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

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

Trust Manager Java APIを使用して、プログラムによってCredentialサービスとやり取りできます。 次のタスクを実行できます。

メモ

管理コンソールを使用して証明書を読み込んだり、削除したりすることもできます。 (管理ヘルプを参照)。

Trust Manager APIを使用した秘密鍵証明書の読み込み

Trust Manager APIを使用して、プログラムによって秘密鍵証明書をAEM Formsに読み込むことができます。 例えば、PDFドキュメントへの署名に使用する秘密鍵証明書を読み込むことができます。 (PDFドキュメントのデジタル署名を参照)。

秘密鍵証明書を読み込む際に、秘密鍵証明書のエイリアスを指定します。 エイリアスは、秘密鍵証明書を必要とするForms操作を実行するために使用されます。 次の図に示すように、読み込まれた秘密鍵証明書は、管理コンソールで表示できます。 秘密鍵証明書のエイリアスは​Secure​です。

ww_ww_truststore

メモ

Webサービスを使用して秘密鍵証明書をAEM Formsに読み込むことはできません。

手順の概要

秘密鍵証明書を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 ライブラリファイルを含める

接続プロパティの設定

資格情報サービスAPIのクイックスタート

Trust Manager APIを使用した秘密鍵証明書の削除

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

Trust Manager API(Java)を使用して、秘密鍵証明書をAEM Formsに読み込みます。

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

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

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

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

    • コンストラクタを使用して java.io.FileInputStream オブジェクトを作成します。秘密鍵証明書の場所を指定するstring値を渡します。
    • com.adobe.idp.Documentコンストラクターを使用して、秘密鍵証明書を保存するcom.adobe.idp.Documentオブジェクトを作成します。 秘密鍵証明書を含むjava.io.FileInputStreamオブジェクトをコンストラクターに渡します。
  4. インポート操作の実行

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

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

      • 秘密鍵証明書のエイリアス値を指定するstring値。
      • 秘密鍵証明書を保存するcom.adobe.idp.Documentインスタンス。
      • 秘密鍵証明書に関連付けられているパスワードを指定するstring値です。
      • 使用の値を含む文字列配列。 例えば、この値truststore.usage.type.signを指定できます。 Reader拡張の秘密鍵証明書を読み込むには、truststore.usage.type.lcreを指定します。

関連トピック

Trust Manager APIを使用した秘密鍵証明書の読み込み

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

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

接続プロパティの設定

Trust Manager APIを使用した秘密鍵証明書の削除

秘密鍵証明書は、Trust Manager APIを使用してプログラムで削除できます。 秘密鍵証明書を削除する場合は、秘密鍵証明書に対応するエイリアスを指定します。 削除した秘密鍵証明書は操作の実行に使用できません。

メモ

Webサービスを使用してAEM Formsに秘密鍵証明書を削除することはできません。

手順の概要

秘密鍵証明書を削除するには、次の手順を実行します。

  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を使用した認証情報の削除

Trust Manager API(Java)を使用してAEM Formsから秘密鍵証明書を削除します。

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

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

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

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

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

関連トピック

Trust Manager APIを使用した秘密鍵証明書の削除

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

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

接続プロパティの設定

このページ