使用権限の割り当て

このドキュメントのサンプルと例は、JEE上のAEM Forms環境に限られています。

Acrobat Reader DC Extensionsサービスについて

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

Acrobat Reader DC Extensionsサービスを使用すると、次のタスクを実行できます。

メモ

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

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

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

メモ

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

メモ

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

手順の概要

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

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

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

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

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

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

PDFドキュメントの取得

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

適用する使用権限の指定

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

メモ

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

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

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

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

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

関連トピック

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

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

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

接続プロパティの設定

Acrobat Reader DC ExtensionsサービスAPIのクイックスタート

Java APIを使用して使用権限を適用します。

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

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

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

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

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

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

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

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

      • ドキュメントに適用する使用権限を含むUsageRightsオブジェクト。
      • 使用権限を付与されたPDFドキュメントをAdobe Reader 7.xで開いたときにユーザーに表示されるメッセージを指定するstring値です。このメッセージは、Adobe Reader 8.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 Extensions 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 Extensionsクライアントオブジェクトを作成します。

    • デフォルトのコンストラクターを使用して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認証を有効にします。

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

    • コンストラクタを使用して BLOB オブジェクトを作成します。BLOBオブジェクトは、使用権限が適用されるPDFドキュメントを保存するために使用されます。
    • コンストラクターを呼び出し、PDFドキュメントのファイルの場所とファイルを開くモードを表すstring値を渡して、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 Extensionsサービスに必要な実行時オプションが含まれています。

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

    • Adobe Readerで使用権限を付与されたPDFドキュメントを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 Extensionsサービスについて詳しくは、『 AEM Forms🔗のサービスリファレンス』を参照してください。

手順の概要

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

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

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

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

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

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

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

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

PDFドキュメントから使用権限を削除します

権限を付与されたPDFドキュメントを取得したら、使用権限を削除できます。 使用権限を削除すると、Adobe Reader内で表示されている間、PDFドキュメントに追加機能は含まれなくなります。

PDFドキュメントの保存

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

関連トピック

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

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

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

接続プロパティの設定

Acrobat Reader DC ExtensionsサービスAPIのクイックスタート

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

Java APIを使用して使用権限を削除します。

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

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

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

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

    コンストラクターを使用し、接続プロパティを含む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 Extensions 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 Extensionsクライアントオブジェクトを作成します。

    • デフォルトのコンストラクターを使用して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認証を有効にします。

      • フィールドReaderExtensionsServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドReaderExtensionsServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。
      • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。
  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オブジェクトの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 Extensionsサービスについて詳しくは、『 AEM Forms🔗のサービスリファレンス』を参照してください。

手順の概要

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

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

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

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

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

プログラムによってAcrobat Reader DC Extensionsサービスの操作を実行する前に、Acrobat Reader DC Extensionsサービスクライアントオブジェクトを作成する必要があります。 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 ExtensionsサービスAPIのクイックスタート

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

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

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

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

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

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

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

    • コンストラクターを使用し、権限を付与されたPDFドキュメントの場所を指定する文字列値を渡すことで、権限を付与された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 Extensions 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 Extensionsクライアントオブジェクトを作成します。

    • デフォルトのコンストラクターを使用して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認証を有効にします。

      • フィールドReaderExtensionsServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドReaderExtensionsServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。
      • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。
  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の呼び出し

このページ