資格情報の操作

秘密鍵証明書サービスについて

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

  • Acrobat Reader DC Extensions では、秘密鍵証明書を使用して、PDF ドキュメントで Adobe Reader の使用権限を有効にします。(「PDFドキュメントへの使用権限の適用」を参照)。
  • Signatureサービスは、PDFドキュメントのデジタル署名などの操作を実行する際に、証明書と秘密鍵証明書にアクセスします。 (「PDFドキュメントのデジタル署名」を参照)。

Trust Manager Java APIを使用して、プログラムによって秘密鍵証明書サービスを操作できます。 次のタスクを実行できます。

メモ

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

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 FormsJavaライブラリファイルを含める」を参照してください。

秘密鍵証明書サービスクライアントの作成

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

秘密鍵証明書の参照

AEM Formsに読み込む秘密鍵証明書を参照します。 このセクションに関連付けられたクイック開始は、ファイルシステム内のP12ファイルを参照します。

インポート操作の実行

秘密鍵証明書を参照した後、秘密鍵証明書をAEM Formsに読み込みます。 秘密鍵証明書が正常に読み込まれない場合は、例外が発生します。 秘密鍵証明書を読み込む場合は、秘密鍵証明書のエイリアスを指定します。

関連トピック

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

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

接続プロパティの設定

Credential Service 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 FormsJavaライブラリファイルを含める」を参照してください。

秘密鍵証明書サービスクライアントの作成

プログラムで秘密鍵証明書を削除する前に、Data Integration Serviceクライアントを作成します。 サービスクライアントを作成する場合、サービスの呼び出しに必要な接続設定を定義します。 詳しくは、接続プロパティの設定を参照してください。

削除操作の実行

秘密鍵証明書を削除するには、秘密鍵証明書に対応するエイリアスを指定します。 存在しないエイリアスを指定すると、例外が発生します。

関連トピック

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 ライブラリファイルを含める

接続プロパティの設定

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now