資格情報の操作 working-with-credentials
このドキュメントのサンプルと例は、JEE 環境の AEM Forms のみを対象としています。
資格情報サービスについて
資格情報には、ドキュメントへの署名や識別に必要な秘密鍵情報が格納されています。 証明書は、信頼のために設定する公開鍵情報です。 AEM Forms が証明書と資格情報を使用する目的はいくつかあります。
- Acrobat Reader DC Extensions では、資格情報を使用して、PDF ドキュメントで Adobe Reader の使用権限を有効にします。 (PDF ドキュメントへの使用権限の適用を参照。)
- Signature サービスは、PDF ドキュメントへのデジタル署名などの操作を実行しながら、証明書および資格情報にアクセスします。 (PDF ドキュメントへのデジタル署名を参照。)
Trust Manager Java API を使用して、Credential サービスとプログラム経由で対話を行うことができます。 次のタスクを実行できます。
Trust Manager API を使用した資格情報の読み込み importing-credentials-by-using-the-trust-manager-api
Trust Manager API を使用して、プログラム経由で資格情報を AEM Forms に読み込むことができます。 例えば、PDF ドキュメントへの署名に使用する資格情報を読み込むことができます。 (PDF ドキュメントへのデジタル署名を参照。)
資格情報を読み込む際は、資格情報のエイリアスを指定します。 エイリアスは、資格情報を必要とする Forms 操作を実行する際に使用されます。 次の図に示すように、読み込んだ資格情報は管理コンソールで表示できます。 資格情報のエイリアスは「Secure」です。
手順の概要 summary-of-steps
資格情報を AEM Forms に読み込むには、次の手順を実行します。
- プロジェクトファイルを含めます。
- 資格情報サービスクライアントを作成します。
- 資格情報を参照します。
- 読み込み操作を実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 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 を使用した資格情報の読み込み import-credentials-using-the-java-api
Trust Manager API(Java)を使用して、資格情報を AEM Forms に読み込みます。
-
プロジェクトファイルを含める
adobe-truststore-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
-
資格情報サービスクライアントの作成
- 接続プロパティを含む
ServiceClientFactoryオブジェクトを作成します。 - コンストラクタを使用して
ServiceClientFactoryオブジェクトを渡すことによって、CredentialServiceClientオブジェクトを作成します。
- 接続プロパティを含む
-
資格情報の参照
- コンストラクタを使用して
java.io.FileInputStreamオブジェクトを作成します。 資格情報の場所を指定する文字列値を渡します。 com.adobe.idp.Documentコンストラクターを使用して、資格情報を保存するcom.adobe.idp.Documentオブジェクトを作成します。 コンストラクターの資格情報が格納されたjava.io.FileInputStreamオブジェクトを渡します。
- コンストラクタを使用して
-
読み込み操作の実行
-
1 つの要素を持つ文字列配列を作成します。 値
truststore.usage.type.signを要素に割り当てます。 -
CredentialServiceClientオブジェクトのimportCredentialメソッドを呼び出して、次の値を渡します。- 資格情報のエイリアス値を指定する文字列値です。
- 資格情報を保存する
com.adobe.idp.Documentインスタンス。 - 資格情報に関連付けられるパスワードを指定する文字列値です。
- 使用量値を含む文字列配列です。 例えば、この値として
truststore.usage.type.signを指定します。 Reader Extension 資格情報をインポートするには、truststore.usage.type.lcreを指定します。
-
関連トピック
Trust Manager API を使用した資格情報の読み込み
Trust Manager API を使用した資格情報の削除 deleting-credentials-by-using-the-trust-manager-api
Trust Manager API を使用すると、プログラムにより資格情報を削除できます。 資格情報を削除する際には、資格情報に対応するエイリアスを指定します。 削除した後は、資格情報を使用して操作を実行できません。
手順の概要 summary_of_steps-1
資格情報を削除するには、以下の手順を実行します。
- プロジェクトファイルを含めます。
- 資格情報サービスクライアントを作成します。
- 削除操作を実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 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 を使用した資格情報の削除 deleting-credentials-using-the-java-api
Trust Manager API(Java)を使用して、AEM Forms から資格情報を削除します。
-
プロジェクトファイルを含める
adobe-truststore-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
-
資格情報サービスクライアントの作成
- 接続プロパティを含む
ServiceClientFactoryオブジェクトを作成します。 - コンストラクタを使用して
ServiceClientFactoryオブジェクトを渡すことによって、CredentialServiceClientオブジェクトを作成します。
- 接続プロパティを含む
-
削除操作の実行
CredentialServiceClientオブジェクトのdeleteCredentialメソッドを呼び出して、エイリアス値を指定する文字列値を渡します。
関連トピック
Trust Manager API を使用した資格情報の削除
クイックスタート(SOAP モード):Java API を使用した資格情報の削除