使用権限の割り当て

このドキュメントのサンプルと例は、JEE環境上のAEM Formsに対してのみ提供されています。

Acrobat Reader DC拡張サービスについて

Acrobat Reader DC拡張サービスを使用すると、Adobe Readerの機能を拡張して、インタラクティブPDFドキュメントを簡単に共有できます。 Acrobat Reader DCエクステンションサービスは、PDF 1.7以降を含むすべてのPDFドキュメントを完全にサポートします。Adobe Reader7.0以降で機能します。 このサービスは、PDFドキュメントに使用権限を追加し、Adobe Readerを使用してPDFドキュメントを開いた場合に通常使用できない機能をアクティブ化します。 サードパーティユーザーは、使用権限を付与されたドキュメントを使用する場合に、追加のソフトウェアまたはプラグインを必要としません。

以下のタスクは、Acrobat Reader DCエクステンションサービスを使用して実行できます。

メモ

Acrobat Reader DC拡張サービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

PDFドキュメントへの使用権限の適用

Acrobat Reader DC拡張機能Java Client APIおよびWebサービスを使用して、PDFドキュメントに使用権限を適用できます。 使用権限は、Acrobat ではデフォルトで利用できるが Adobe Reader では利用できない機能(フォームにコメントを追加する機能や、フォームフィールドにデータを入力してフォームを保存する機能など)に関連しています。使用権限が与えられた PDF ドキュメントは、使用権限を付与されたドキュメントと呼ばれます。使用権限を付与されたドキュメントを Adobe Reader で開いたユーザーは、そのドキュメントで有効になっている操作を実行できます。

メモ

Java APIの一部であるapplyUsageRightsメソッドを使用してPDFドキュメントに使用権限を適用する場合、ReaderExtensionsOptionSpecオブジェクトのisModeFinalパラメーターをfalseに設定できます。 その結果、フォーム処理済みカウンターが更新されず、パフォーマンスが向上します。 フォーム処理済みカウンターの更新を心配しない場合は、isModeFinalパラメーターをfalseに設定することをお勧めします。

メモ

Acrobat Reader DC拡張サービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

手順の概要

PDFドキュメントに使用権限を適用するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。
  3. PDFドキュメントを取得します。
  4. 適用する使用権限を指定します。
  5. 使用権限をPDFドキュメントに適用します。
  6. 使用権限を付与されたPDFドキュメントを保存します。

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

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

Acrobat Reader DC拡張クライアントオブジェクトの作成

プログラムによってAcrobat Reader DC拡張サービスの操作を実行するには、Acrobat Reader DC拡張サービスクライアントオブジェクトを作成する必要があります。 Acrobat Reader DC拡張機能のJava APIを使用している場合は、ReaderExtensionsServiceClientオブジェクトを作成します。 Acrobat Reader DC拡張機能WebサービスAPIを使用している場合は、ReaderExtensionsServiceServiceオブジェクトを作成します。

PDFドキュメントの取得

使用権限を適用するには、PDFドキュメントを取得する必要があります。 使用権限を付与されたPDFドキュメントには、使用権限ディクショナリが含まれています。 このような辞書を含むドキュメントをAdobe Readerが開くと、そのドキュメントに対してのみ、辞書で指定されている使用権限が有効になります。 ドキュメントに使用権限ディクショナリが含まれていない場合、Acrobat Reader DC拡張サービスによって使用権限ディクショナリが作成されます。 既にディクショナリが含まれている場合、Acrobat Reader DC拡張サービスは、既存の使用権限を指定した使用権限で上書きします。 この辞書は、有効にする使用権限を指定します。 ユーザーがAdobe Readerでドキュメントを開くと、その辞書で指定されている使用権限のみが許可されます。

適用する使用権限の指定

設定できる使用権限は、Adobe Systems Incorporatedから購入した秘密鍵証明書によって決まります。 通常、資格情報は、インタラクティブフォームに関連する使用権限など、関連する使用権限のグループを設定する権限を与えます。 各秘密鍵証明書には、特定の数の権限を付与されたPDFドキュメントを作成する権限が与えられます。 評価用の秘密鍵証明書によって、無制限の数のドラフトドキュメントを作成する権利が与えられます。

メモ

秘密鍵証明書で許可されていない使用権限を割り当てようとすると、例外が発生します。

PDFドキュメントへの使用権限の適用

使用権限をPDFドキュメントに適用するには、使用権限の適用に使用する秘密鍵証明書のエイリアスを参照します(秘密鍵証明書は通常、AEM Formsのインストール時にインストールされます)。 また、使用権限を適用するPDFドキュメントを指定する必要があります。 秘密鍵証明書の設定について詳しくは、使用しているアプリケーションサーバー版のインストールおよびデプロイに関するガイドを参照してください。

使用権限を付与されたPDFドキュメントの保存

Acrobat Reader DC拡張機能サービスが使用権限をPDFドキュメントに適用した後、使用権限を付与されたPDFドキュメントをPDFファイルとして保存できます。

関連トピック

Java APIを使用した使用権限の適用

WebサービスAPIを使用した使用権限の適用

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

接続プロパティの設定

Acrobat Reader DC拡張サービスAPIクイック開始

Java APIを使用した使用権限の適用

Acrobat Reader DC拡張機能API(Java)を使用して、PDFドキュメントに使用権限を適用します。

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

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

  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して ReaderExtensionsServiceClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。
  3. PDFドキュメントを取得します。

    • コンストラクターを使用し、PDFドキュメントの場所を指定するstring値を渡して、PDFドキュメントを表すjava.io.FileInputStreamオブジェクトを作成します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。
  4. 適用する使用権限を指定します。

    • 使用権限を表すUsageRightsオブジェクトを作成するには、コンストラクタを使用します。
    • 適用する各使用権限について、UsageRightsオブジェクトに属する対応するメソッドを呼び出します。 例えば、enableFormFillIn使用権限を追加するには、UsageRightsオブジェクトのenableFormFillInメソッドを呼び出し、trueを渡します。 (適用する使用権限ごとに、この手順を繰り返します)。
  5. 使用権限をPDFドキュメントに適用します。

    • コンストラクタを使用して ReaderExtensionsOptionSpec オブジェクトを作成します。このオブジェクトには、Acrobat Reader DC拡張サービスで必要な実行時オプションが含まれます。 このコンストラクターを呼び出す場合、次の値を指定する必要があります。

      • ドキュメントに適用する使用権限が含まれているUsageRightsオブジェクト。
      • 使用権限を付与されたPDFドキュメントをAdobe Reader7.xで開いたときにユーザーに表示されるメッセージを指定するstring値です。このメッセージは、Adobe Reader8.0では表示されません。
    • ReaderExtensionsServiceClientオブジェクトのapplyUsageRightsメソッドを呼び出し、次の値を渡して、使用権限をPDFドキュメントに適用します。

      • 使用権限が適用されるPDFドキュメントが含まれるcom.adobe.idp.Documentオブジェクトです。
      • 使用権限の適用を可能にする秘密鍵証明書のエイリアスを指定するstring値。
      • 対応するパスワード値を指定する文字列値. (現在、このパラメーターは無視されます。 nullを渡すことができます)。
    • 実行時オプションを含むReaderExtensionsOptionSpecオブジェクトです。

    applyUsageRightsメソッドは、使用権限を付与されたPDFドキュメントを含むcom.adobe.idp.Documentオブジェクトを返します。

  6. 使用権限を付与されたPDFドキュメントを保存します。

    • java.io.File オブジェクトを作成し、ファイル拡張子が .pdf であることを確認します。
    • com.adobe.idp.DocumentオブジェクトのcopyToFileメソッドを呼び出して、com.adobe.idp.Documentオブジェクトの内容をファイルにコピーします(applyUsageRightsメソッドから返されたcom.adobe.idp.Documentオブジェクトを必ず使用してください)。

関連トピック

PDFドキュメントへの使用権限の適用

クイック開始(SOAPモード):Java APIを使用した使用権限の適用

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

接続プロパティの設定

WebサービスAPIを使用して使用権限を適用する

Acrobat Reader DC拡張機能API(Webサービス)を使用して、PDFドキュメントに使用権限を適用します。

  1. プロジェクトファイルを含めます。

    MTOMを使用するMicrosoft .NETプロジェクトを作成します。 次のWSDL定義を使用していることを確認します。http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

    メモ

    localhostを、AEM FormsをホストするサーバーのIPアドレスに置き換えます。

  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。

    • ReaderExtensionsServiceClientオブジェクトを作成するには、そのデフォルトのコンストラクタを使用します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してReaderExtensionsServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに指定するstring値を渡します(例:http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom)。 必ず?blob=mtomを指定してください)。

    • ReaderExtensionsServiceClient.Endpoint.Bindingフィールドの値を取得してSystem.ServiceModel.BasicHttpBindingオブジェクトを作成します。 戻り値を BasicHttpBinding にキャストします。

    • System.ServiceModel.BasicHttpBindingオブジェクトのMessageEncodingフィールドをWSMessageEncoding.Mtomに設定します。 この値により、MTOMが使用されます。

    • 次のタスクを実行して、基本的なHTTP認証を有効にします。

      • AEM formsユーザー名をフィールドReaderExtensionsServiceClient.ClientCredentials.UserName.UserNameに割り当てます。
      • 対応するパスワード値をフィールドReaderExtensionsServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • 定数値HttpClientCredentialType.BasicをフィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに割り当てます。
      • 定数値BasicHttpSecurityMode.TransportCredentialOnlyをフィールドBasicHttpBindingSecurity.Security.Modeに割り当てます。
  3. PDFドキュメントを取得します。

    • コンストラクタを使用して BLOB オブジェクトを作成します。BLOBオブジェクトは、使用権限が適用されるPDFドキュメントの保存に使用されます。
    • コンストラクターを呼び出し、PDFドキュメントーのファイルの場所とファイルを開くモードを表す文字列値を渡して、System.IO.FileStreamオブジェクトを作成します。
    • System.IO.FileStreamオブジェクトの内容を格納するバイト配列を作成します。 System.IO.FileStreamオブジェクトのLengthプロパティを取得して、バイト配列のサイズを決定できます。
    • System.IO.FileStreamオブジェクトのReadメソッドを呼び出して、バイト配列にストリームデータを入力します。 読み取るバイト配列、開始位置、ストリーム長を渡します。
    • BLOBオブジェクトにMTOMプロパティを割り当て、バイト配列の内容を指定します。
  4. 適用する使用権限を指定します。

    • 使用権限を表すUsageRightsオブジェクトを作成するには、コンストラクタを使用します。
    • 適用する使用権限ごとに、true値をUsageRightsオブジェクトに属する対応するデータメンバーに割り当てます。 例えば、enableFormFillIn使用権限を追加するには、trueUsageRightsオブジェクトのenableFormFillInデータメンバに割り当てます。 (適用する使用権限ごとに、この手順を繰り返します)。
  5. 使用権限をPDFドキュメントに適用します。

    • コンストラクタを使用して ReaderExtensionsOptionSpec オブジェクトを作成します。このオブジェクトには、Acrobat Reader DC拡張サービスで必要な実行時オプションが含まれます。

    • UsageRightsオブジェクトをReaderExtensionsOptionSpecオブジェクトのusageRightsデータメンバに割り当てます。

    • 使用権限を付与されたPDFドキュメントをAdobe ReaderでReaderExtensionsOptionSpecオブジェクトのmessageデータメンバーに開いたときにユーザーに表示されるメッセージを指定するstring値を割り当てます。

    • ReaderExtensionsServiceClientオブジェクトのapplyUsageRightsメソッドを呼び出し、次の値を渡して、使用権限をPDFドキュメントに適用します。

      • 使用権限が適用されるPDFドキュメントが含まれるBLOBオブジェクトです。
      • 使用権限の適用を可能にする秘密鍵証明書のエイリアスを指定するstring値。
      • 対応するパスワード値を指定する文字列値. (現在、このパラメーターは無視されます。 nullを渡すことができます)。
    • 実行時オプションを含むReaderExtensionsOptionSpecオブジェクトです。

    applyUsageRightsメソッドは、使用権限を付与されたPDFドキュメントを含むBLOBオブジェクトを返します。

  6. 使用権限を付与されたPDFドキュメントを保存します。

    • コンストラクターを呼び出して、System.IO.FileStreamオブジェクトを作成します。 使用権限を付与されたPDFドキュメントのファイルの場所を表すstring値を渡します。
    • applyUsageRightsメソッドから返されたBLOBオブジェクトのデータ内容を格納するバイト配列を作成します。 BLOBオブジェクトのMTOMデータメンバの値を取得して、バイト配列を入力します。
    • コンストラクターを呼び出してSystem.IO.FileStreamオブジェクトを渡し、System.IO.BinaryWriterオブジェクトを作成します。
    • System.IO.BinaryWriterオブジェクトのWriteメソッドを呼び出し、バイト配列を渡すことで、バイト配列の内容をPDFファイルに書き込みます。

関連トピック

PDFドキュメントへの使用権限の適用

MTOMを使用したAEM Formsの呼び出し

SwaRefを使用したAEM Formsの呼び出し

PDFドキュメントからの使用権限の削除

使用権限を有効にしたドキュメントから使用権限を削除できます。 使用権限を付与されたPDFドキュメントから使用権限を削除することも、その他のAEM Forms操作を実行するために必要です。 例えば、PDF ドキュメントに対する電子署名(または認証)は、使用権限を設定する前に実行する必要があります。したがって、使用権限を付与されたドキュメントに対して操作を実行する場合は、PDFドキュメントから使用権限を削除し、ドキュメントへの電子署名など他の操作を実行してから、ドキュメントに使用権限を再適用する必要があります。

メモ

Acrobat Reader DC拡張サービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

手順の概要

使用権限を付与されたPDFドキュメントから使用権限を削除するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。
  3. 使用権限を付与されたPDFドキュメントを取得します。
  4. PDFドキュメントから使用権限を削除します。
  5. PDFドキュメントを保存します。

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

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

Acrobat Reader DC拡張クライアントオブジェクトの作成

プログラムを使用してAcrobat Reader DC拡張サービスの操作を実行する前に、Acrobat Reader DC拡張サービスクライアントオブジェクトを作成する必要があります。 Java APIを使用している場合は、ReaderExtensionsServiceClientオブジェクトを作成します。 Acrobat Reader DC拡張機能WebサービスAPIを使用している場合は、ReaderExtensionsServiceServiceオブジェクトを作成します。

使用権限を付与されたPDFドキュメントの取得

使用権限を削除するために、使用権限を付与されたPDFドキュメントを取得します。

PDFドキュメントからの使用権限の削除

使用権限を付与されたPDFドキュメントを取得したら、使用権限を削除できます。 使用権限を削除すると、PDFドキュメントはAdobe Reader内で表示中、追加機能を持ちません。

PDFドキュメントの保存

使用権限がなくなったPDFドキュメントをPDFファイルとして保存できます。 PDFファイルとして保存すると、PDFドキュメントはAdobe ReaderまたはAcrobatで表示できます。

関連トピック

Java APIを使用した使用権限の削除

WebサービスAPIを使用した使用権限の削除

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

接続プロパティの設定

Acrobat Reader DC拡張サービスAPIクイック開始

PDFドキュメントへの使用権限の適用

Java APIを使用した使用権限の削除

Acrobat Reader DC拡張機能API(Java)を使用して、使用権限を付与されたPDFドキュメントから使用権限を削除します。

  1. プロジェクトファイルを含めます。

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

  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。

    コンストラクターを使用し、接続プロパティを含むServiceClientFactoryオブジェクトを渡して、ReaderExtensionsServiceClientオブジェクトを作成します。

  3. PDFドキュメントを取得します。

    • コンストラクターを使用し、PDFドキュメントの場所を指定するstring値を渡して、使用権限を付与されたPDFドキュメントを表すjava.io.FileInputStreamオブジェクトを作成します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。
  4. PDFドキュメントから使用権限を削除します。

    ReaderExtensionsServiceClientオブジェクトのremoveUsageRightsメソッドを呼び出し、使用権限を付与されたPDFドキュメントを含むcom.adobe.idp.Documentオブジェクトを渡すことで、PDFドキュメントから使用権限を削除します。 使用権限のないPDFドキュメントを含むcom.adobe.idp.Documentオブジェクトを返します。

  5. 使用権限をPDFドキュメントに適用します。

    • java.io.Fileオブジェクトを作成し、ファイル拡張子が.PDFであることを確認します。
    • DocumentオブジェクトのcopyToFileメソッドを呼び出して、Documentオブジェクトの内容をファイルにコピーします(removeUsageRightsメソッドから返されたDocumentオブジェクトを必ず使用してください)。

関連トピック

PDFドキュメントからの使用権限の削除

クイック開始(SOAPモード):Java APIを使用したPDFドキュメントからの使用権限の削除

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

接続プロパティの設定

WebサービスAPIを使用して使用権限を削除

Acrobat Reader DC拡張機能API(Webサービス)を使用して、使用権限を付与されたPDFドキュメントから使用権限を削除します。

  1. プロジェクトファイルを含めます。

    MTOMを使用するMicrosoft .NETプロジェクトを作成します。 次のWSDL定義を使用していることを確認します。http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

    メモ

    localhostを、AEM FormsをホストするサーバーのIPアドレスに置き換えます。

  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。

    • ReaderExtensionsServiceClientオブジェクトを作成するには、そのデフォルトのコンストラクタを使用します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してReaderExtensionsServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに指定するstring値を渡します(例:http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom)。 必ず?blob=mtomを指定してください)。

    • ReaderExtensionsServiceClient.Endpoint.Bindingフィールドの値を取得してSystem.ServiceModel.BasicHttpBindingオブジェクトを作成します。 戻り値を BasicHttpBinding にキャストします。

    • System.ServiceModel.BasicHttpBindingオブジェクトのMessageEncodingフィールドをWSMessageEncoding.Mtomに設定します。 この値により、MTOMが使用されます。

    • 次のタスクを実行して、基本的なHTTP認証を有効にします。

      • AEM formsユーザー名をフィールドReaderExtensionsServiceClient.ClientCredentials.UserName.UserNameに割り当てます。
      • 対応するパスワード値をフィールドReaderExtensionsServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • 定数値HttpClientCredentialType.BasicをフィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに割り当てます。
      • 定数値BasicHttpSecurityMode.TransportCredentialOnlyをフィールドBasicHttpBindingSecurity.Security.Modeに割り当てます。
  3. PDFドキュメントを取得します。

    • コンストラクタを使用して BLOB オブジェクトを作成します。BLOBオブジェクトは、使用権限が削除された、使用権限が有効なPDFドキュメントの保存に使用されます。
    • コンストラクターを呼び出し、PDFドキュメントーのファイルの場所とファイルを開くモードを表す文字列値を渡して、System.IO.FileStreamオブジェクトを作成します。
    • System.IO.FileStreamオブジェクトの内容を格納するバイト配列を作成します。 System.IO.FileStreamオブジェクトのLengthプロパティを取得して、バイト配列のサイズを決定できます。
    • System.IO.FileStreamオブジェクトのReadメソッドを呼び出し、読み取るバイト配列、開始位置、ストリーム長を渡すことで、バイト配列にストリームデータを入力します。
    • BLOBオブジェクトにMTOMプロパティを割り当て、バイト配列の内容を指定します。
  4. PDFドキュメントから使用権限を削除します。

    ReaderExtensionsServiceClientオブジェクトのremoveUsageRightsメソッドを呼び出し、使用権限を付与されたPDFドキュメントを含むBLOBオブジェクトを渡すことで、PDFドキュメントから使用権限を削除します。 使用権限のないPDFドキュメントを含むBLOBオブジェクトを返します。

  5. 使用権限をPDFドキュメントに適用します。

    • コンストラクターを呼び出し、PDFファイルの場所を表す文字列値を渡して、System.IO.FileStreamオブジェクトを作成します。
    • removeUsageRightsメソッドから返されたBLOBオブジェクトのデータ内容を格納するバイト配列を作成します。 BLOBオブジェクトのMTOMデータメンバの値を取得して、バイト配列を入力します。
    • コンストラクターを呼び出してSystem.IO.FileStreamオブジェクトを渡し、System.IO.BinaryWriterオブジェクトを作成します。

関連トピック

PDFドキュメントからの使用権限の削除

MTOMを使用したAEM Formsの呼び出し

SwaRefを使用したAEM Formsの呼び出し

秘密鍵証明書情報の取得

使用権限を付与されたPDFドキュメントに使用権限を適用するために使用された秘密鍵証明書に関する情報を取得できます。 秘密鍵証明書に関する情報を取得することで、証明書が無効になる日付などの情報を取得できます。

メモ

Acrobat Reader DC拡張サービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

手順の概要

使用権限をPDFドキュメントに適用するために使用された秘密鍵証明書に関する情報を取得するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。
  3. 使用権限を付与されたPDFドキュメントを取得します。
  4. 秘密鍵証明書に関する情報を取得します。

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

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

Acrobat Reader DC拡張クライアントオブジェクトの作成

プログラムを使用してAcrobat Reader DC拡張サービスの操作を実行する前に、Acrobat Reader DC拡張サービスクライアントオブジェクトを作成する必要があります。 Java APIを使用している場合は、ReaderExtensionsServiceClientオブジェクトを作成します。 Acrobat Reader DC拡張機能WebサービスAPIを使用している場合は、ReaderExtensionsServiceServiceオブジェクトを作成します。

使用権限を付与されたPDFドキュメントの取得

秘密鍵証明書に関する情報を取得するには、使用権限を付与されたPDFドキュメントを取得する必要があります。 エイリアスを指定して、秘密鍵証明書に関する情報を取得することもできます。ただし、使用権限を特定の使用権限を付与されたPDFドキュメントに適用するために使用された秘密鍵証明書に関する情報を取得する場合は、ドキュメントを取得する必要があります。

秘密鍵証明書に関する情報の取得

使用権限を付与されたPDFドキュメントを取得したら、使用権限の適用に使用された秘密鍵証明書に関する情報を取得できます。 秘密鍵証明書に関する次の情報を取得できます。

  • 使用権限を付与されたPDFドキュメントが開かれたときにAdobe Reader内に表示されるメッセージです。
  • 秘密鍵証明書の失効日です。
  • 秘密鍵証明書の有効期限が切れる日付です。
  • この権限を付与されたPDFドキュメントに設定された使用権限です。
  • 秘密鍵証明書が使用された回数。

関連トピック

Java APIを使用した使用権限の削除

WebサービスAPIを使用した使用権限の削除

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

接続プロパティの設定

Acrobat Reader DC拡張サービスAPIクイック開始

Java APIを使用した秘密鍵証明書情報の取得

Acrobat Reader DC拡張機能API(Java)を使用して秘密鍵証明書の情報を取得します。

  1. プロジェクトファイルを含めます。

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

  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。

    コンストラクターを使用し、接続プロパティを含むServiceClientFactoryオブジェクトを渡して、ReaderExtensionsServiceClientオブジェクトを作成します。

  3. PDFドキュメントを取得します。

    • コンストラクターを使用し、権限を付与されたPDFドキュメントの場所を指定するstring値を渡して、権限を付与されたPDFドキュメントを表すjava.io.FileInputStreamオブジェクトを作成します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。
  4. PDFドキュメントから使用権限を削除します。

    • ReaderExtensionsServiceClientオブジェクトのgetDocumentUsageRightsメソッドを呼び出し、使用権限を付与されたPDFドキュメントを含むcom.adobe.idp.Documentオブジェクトを渡すことで、PDFドキュメントに使用権限を適用するために使用される秘密鍵証明書に関する情報を取得します。 このメソッドは、秘密鍵証明書情報を含むGetUsageRightsResultオブジェクトを返します。
    • GetUsageRightsResultオブジェクトのgetNotAfterメソッドを呼び出して、秘密鍵証明書の失効日を取得します。 このメソッドは、秘密鍵証明書の失効日を表すjava.util.Dateオブジェクトを返します。
    • GetUsageRightsResultオブジェクトのgetMessageメソッドを呼び出して、使用権限を付与されたPDFドキュメントを開いたときに、Adobe Readerに表示されるメッセージを取得します。 このメソッドは、メッセージを表すstring値を返します。

関連トピック

秘密鍵証明書情報の取得

クイック開始(SOAPモード):Java APIを使用した秘密鍵証明書情報の取得

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

接続プロパティの設定

WebサービスAPIを使用した秘密鍵証明書情報の取得

Acrobat Reader DC拡張機能API(Webサービス)を使用して秘密鍵証明書の情報を取得します。

  1. プロジェクトファイルを含めます。

    MTOMを使用するMicrosoft .NETプロジェクトを作成します。 次のWSDL定義を使用していることを確認します。http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

    メモ

    localhostを、AEM FormsをホストするサーバーのIPアドレスに置き換えます。

  2. Acrobat Reader DC拡張クライアントオブジェクトを作成します。

    • ReaderExtensionsServiceClientオブジェクトを作成するには、そのデフォルトのコンストラクタを使用します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してReaderExtensionsServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに指定するstring値を渡します(例:http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom)。 必ず?blob=mtomを指定してください)。

    • ReaderExtensionsServiceClient.Endpoint.Bindingフィールドの値を取得してSystem.ServiceModel.BasicHttpBindingオブジェクトを作成します。 戻り値を BasicHttpBinding にキャストします。

    • System.ServiceModel.BasicHttpBindingオブジェクトのMessageEncodingフィールドをWSMessageEncoding.Mtomに設定します。 この値により、MTOMが使用されます。

    • 次のタスクを実行して、基本的なHTTP認証を有効にします。

      • AEM formsユーザー名をフィールドReaderExtensionsServiceClient.ClientCredentials.UserName.UserNameに割り当てます。
      • 対応するパスワード値をフィールドReaderExtensionsServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • 定数値HttpClientCredentialType.BasicをフィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに割り当てます。
      • 定数値BasicHttpSecurityMode.TransportCredentialOnlyをフィールドBasicHttpBindingSecurity.Security.Modeに割り当てます。
  3. PDFドキュメントを取得します。

    • コンストラクタを使用して BLOB オブジェクトを作成します。BLOBオブジェクトは、使用権限を付与されたPDFドキュメントの保存に使用されます。
    • コンストラクターを呼び出し、使用権限を付与されたPDFドキュメントのファイルの場所とファイルを開くモードを表すstring値を渡して、System.IO.FileStreamオブジェクトを作成します。
    • System.IO.FileStreamオブジェクトの内容を格納するバイト配列を作成します。 System.IO.FileStreamオブジェクトのLengthプロパティを取得して、バイト配列のサイズを決定できます。
    • System.IO.FileStreamオブジェクトのReadメソッドを呼び出し、読み取るバイト配列、開始位置、ストリーム長を渡すことで、バイト配列にストリームデータを入力します。
    • BLOBオブジェクトにMTOMプロパティを割り当て、バイト配列の内容を指定します。
  4. PDFドキュメントから使用権限を削除します。

    • ReaderExtensionsServiceClientオブジェクトのgetDocumentUsageRightsメソッドを呼び出し、使用権限を付与されたPDFドキュメントを含むcom.adobe.idp.Documentオブジェクトを渡すことで、PDFドキュメントに使用権限を適用するために使用される秘密鍵証明書に関する情報を取得します。 このメソッドは、秘密鍵証明書情報を含むGetUsageRightsResultオブジェクトを返します。
    • GetUsageRightsResultオブジェクトのnotAfterデータメンバーの値を取得して、秘密鍵証明書が無効になる日付を取得します。 このデータメンバのデータ型はSystem.DateTimeです。
    • GetUsageRightsResultオブジェクトのmessageデータメンバーの値を取得して、使用権限を付与されたPDFドキュメントをAdobe Readerで開いたときに表示されるメッセージを取得します。 このデータメンバのデータ型は文字列です。
    • GetUsageRightsResultオブジェクトのuseCountデータメンバーの値を取得して、秘密鍵証明書が使用された回数を取得します。 このデータメンバのデータ型は整数です。

関連トピック

秘密鍵証明書情報の取得

MTOMを使用したAEM Formsの呼び出し

SwaRefを使用したAEM Formsの呼び出し

このページ