ポリシーを使用したドキュメントの保護

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

Document Securityサービスについて

Document Securityサービスを使用すると、ユーザーは、Adobe PDFドキュメントに機密設定を動的に適用し、ドキュメントの広範囲に関係なく、ドキュメントの制御を維持できます。

Document Securityサービスは、ポリシーで保護されたPDFドキュメントを受信者がどのように使用するかをユーザーが制御できるようにすることで、ユーザーの手の届く範囲を超えて情報が広がるのを防ぎます。 ユーザーは、ドキュメントを開くユーザーを指定し、ドキュメントの使用方法を制限し、ドキュメントの配布後にドキュメントを監視できます。 ユーザーは、ポリシーで保護されたドキュメントへのアクセスを動的に制御し、ドキュメントへのアクセスを動的に取り消すこともできます。

また、Document Securityサービスは、Microsoft Wordファイル（DOCファイル）などの他のファイルタイプも保護します。 Document SecurityクライアントAPIを使用して、これらのファイルタイプを操作できます。 次のバージョンがサポートされています。

  • Microsoft Office 2003ファイル（DOC、XLS、PPTファイル）
  • Microsoft Office 2007ファイル（DOCX、XLSX、PPTXファイル）
  • PTC Pro/Eファイル

次の2つのセクションで、Wordドキュメントの使用方法を説明します。

Document Securityサービスを使用して、次のタスクを実行できます。

メモ

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

ポリシーの作成

Document Security Java APIまたはWebサービスAPIを使用して、プログラムでポリシーを作成できます。 policy​は、Document Securityの設定、許可されたユーザー、使用権限を含む情報の集まりです。 様々な状況やユーザーに適したセキュリティ設定を使用して、任意の数のポリシーを作成および保存できます。

ポリシーを使用すると、次のタスクを実行できます。

  • ドキュメントを開くことのできる個人を指定します。 受信者は、組織に属するか、組織外に属することができます。
  • 受信者によるドキュメントの使用方法を指定します。 AcrobatとAdobe Readerの様々な機能へのアクセスを制限できます。 これらの機能には、テキストの印刷とコピー、署名の追加、ドキュメントへのコメントの追加が含まれます。
  • ポリシーで保護されたドキュメントを配布した後でも、いつでもアクセスおよびセキュリティの設定を変更できます。
  • ドキュメントを配布した後で、ドキュメントの使用を監視します。 ドキュメントの使用方法と使用者を確認できます。 例えば、誰かがドキュメントを開いた日時を調べることができます。

Webサービスを使用したポリシーの作成

WebサービスAPIを使用してポリシーを作成する場合は、ポリシーを記述する既存のPDRL(Portable Document Rights Language)XMLファイルを参照します。 ポリシー権限とプリンシパルはPDRLドキュメントで定義されます。 次のXMLドキュメントは、PDRLドキュメントの例です。

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
       <PolicyEntry>
          <ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
 
             <PrincipalName>all_internal_users</PrincipalName>
          </Principal>
       </PolicyEntry>
       <PolicyEntry>
          <ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
 
          <ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
 
          <ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
 
             <PrincipalName>publisher</PrincipalName>
          </Principal>
       </PolicyEntry>
 
       <OfflineLeasePeriod>
          <Duration>P31D</Duration>
       </OfflineLeasePeriod>
 
       <AuditSettings isTracked="true" />
 
       <PolicyValidityPeriod isAbsoluteTime="false">
          <ValidityPeriodRelative>
             <NotBeforeRelative>PT0S</NotBeforeRelative>
 
             <NotAfterRelative>P20D</NotAfterRelative>
          </ValidityPeriodRelative>
       </PolicyValidityPeriod>
 </Policy>
 
メモ

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

手順の概要

ポリシーを作成するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. ポリシーの属性を設定します。
  4. ポリシーエントリを作成します。
  5. ポリシーを登録します。

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

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

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-rightsmanagement-client.jar
  • namespace.jar (AEM FormsがJBossにデプロイされている場合)
  • jaxb-api.jar(AEM FormsがJBossにデプロイされている場合)
  • jaxb-impl.jar(AEM FormsがJBossにデプロイされている場合)
  • jaxb-libs.jar(AEM FormsがJBossにデプロイされている場合)
  • jaxb-xjc.jar(AEM FormsがJBossにデプロイされている場合)
  • relaxingDatatype.jar(AEM FormsがJBossにデプロイされている場合)
  • xsdlib.jar(AEM FormsがJBossにデプロイされている場合)
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar
  • jbossall-client.jar(AEM FormsがJBossにデプロイされていない場合は、別のJARファイルを使用)

これらのJARファイルの場所について詳しくは、「AEM Forms Javaライブラリファイルを含める」を参照してください。

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成します。

ポリシーの属性の設定

ポリシーを作成するには、ポリシー属性を設定します。 必須属性はポリシー名です。 ポリシー名は、ポリシーセットごとに一意である必要があります。 ポリシーセットは、単にポリシーの集まりです。 ポリシーが別々のポリシーセットに属する場合は、同じ名前の2つのポリシーを使用できます。 ただし、1つのポリシーセット内の2つのポリシーに同じポリシー名を付けることはできません。

もう1つの便利な属性は、有効期間です。 有効期間とは、許可された受信者がポリシーで保護されたドキュメントにアクセスできる期間です。 この属性を設定しない場合、ポリシーは常に有効です。

有効期間は、次のいずれかのオプションに設定できます。

  • ドキュメントが発行されてからドキュメントにアクセスできる日数
  • ドキュメントにアクセスできない終了日
  • ドキュメントにアクセスできる特定の日付範囲
  • 常に有効

開始日のみを指定できます。指定した日付を指定すると、ポリシーは開始日より後で有効になります。 終了日のみを指定した場合、ポリシーは終了日まで有効です。 ただし、開始日と終了日の両方が定義されていない場合は、例外が発生します。

ポリシーに属する属性を設定する場合は、暗号化設定も設定できます。 これらの暗号化設定は、ポリシーがドキュメントに適用される際に影響を受けます。 次の暗号化値を指定できます。

  • AES256:256ビットキーを持つAES暗号化アルゴリズムを表します。
  • AES128:128ビットキーを持つAES暗号化アルゴリズムを表します。
  • NoEncryption: 暗号化しないことを表します。

NoEncryptionオプションを指定する場合、PlaintextMetadataオプションをfalseに設定することはできません。 その場合は、例外が発生します。

メモ

設定できるその他の属性について詳しくは、『AEM Forms APIリファレンス』のPolicyインターフェイスの説明を参照してください。

ポリシーエントリの作成

ポリシーエントリは、プリンシパル（グループとユーザー、および権限）をポリシーに関連付けます。 ポリシーには、1つ以上のポリシーエントリが必要です。 例えば、次のタスクを実行するとします。

  • ポリシーエントリを作成して登録します。このエントリを使用すると、グループはオンライン時にドキュメントのみを表示でき、受信者はドキュメントをコピーできなくなります。
  • ポリシーにポリシーエントリを添付します。
  • Acrobatを使用して、ポリシーでドキュメントを保護します。

これらの操作を行うと、受信者はオンラインでドキュメントを表示するだけで、コピーできなくなります。 ドキュメントからセキュリティが削除されるまで、ドキュメントのセキュリティは維持されます。

ポリシーの登録

新しいポリシーを使用するには、そのポリシーを登録する必要があります。 ポリシーを登録すると、そのポリシーを使用してドキュメントを保護できます。

Java APIを使用してポリシーを作成します

Document Security API(Java)を使用してポリシーを作成します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. ポリシーの属性を設定します。

    • InfomodelObjectFactoryオブジェクトの静的なcreatePolicyメソッドを呼び出して、Policyオブジェクトを作成します。 このメソッドはPolicyオブジェクトを返します。
    • PolicyオブジェクトのsetNameメソッドを呼び出し、ポリシー名を指定する文字列値を渡すことで、ポリシーのname属性を設定します。
    • PolicyオブジェクトのsetDescriptionメソッドを呼び出し、ポリシーの説明を指定する文字列値を渡すことで、ポリシーの説明を設定します。
    • PolicyオブジェクトのsetPolicySetNameメソッドを呼び出し、ポリシーセット名を指定する文字列値を渡すことで、新しいポリシーが属するポリシーセットを設定します。 （このパラメーター値にnullを指定すると、ポリシーが​My Policies​ポリシーセットに追加されます）。
    • InfomodelObjectFactoryオブジェクトの静的なcreateValidityPeriodメソッドを呼び出して、ポリシーの有効期間を作成します。 このメソッドはValidityPeriodオブジェクトを返します。
    • ValidityPeriodオブジェクトのsetRelativeExpirationDaysメソッドを呼び出し、日数を指定する整数値を渡すことで、ポリシーで保護されたドキュメントにアクセスできる日数を設定します。
    • PolicyオブジェクトのsetValidityPeriodメソッドを呼び出し、ValidityPeriodオブジェクトを渡すことで、ポリシーの有効期間を設定します。

  4. ポリシーエントリを作成します。

    • InfomodelObjectFactoryオブジェクトの静的なcreatePolicyEntryメソッドを呼び出して、ポリシーエントリを作成します。 このメソッドはPolicyEntryオブジェクトを返します。
    • InfomodelObjectFactoryオブジェクトの静的createPermissionメソッドを呼び出して、ポリシーの権限を指定します。 権限を表すPermissionインターフェイスに属する静的データメンバーを渡します。 このメソッドはPermissionオブジェクトを返します。 例えば、ポリシーで保護されたPDFドキュメントからユーザーがデータをコピーできる権限を追加するには、Permission.COPYを渡します。 （追加する権限ごとに、この手順を繰り返します）。
    • PolicyEntryオブジェクトのaddPermissionメソッドを呼び出し、Permissionオブジェクトを渡すことで、ポリシーエントリに権限を追加します。 （作成したPermissionオブジェクトごとに、この手順を繰り返します）。
    • InfomodelObjectFactoryオブジェクトの静的なcreateSpecialPrincipalメソッドを呼び出して、ポリシープリンシパルを作成します。 プリンシパルを表すInfomodelObjectFactoryオブジェクトに属するデータメンバーを渡します。 このメソッドはPrincipalオブジェクトを返します。 例えば、ドキュメントのパブリッシャーをプリンシパルとして追加するには、InfomodelObjectFactory.PUBLISHER_PRINCIPALを渡します。
    • PolicyEntryオブジェクトのsetPrincipalメソッドを呼び出し、Principalオブジェクトを渡して、プリンシパルをポリシーエントリに追加します。
    • PolicyオブジェクトのaddPolicyEntryメソッドを呼び出し、PolicyEntryオブジェクトを渡すことで、ポリシーにポリシーエントリを追加します。

  5. ポリシーを登録します。

    • DocumentSecurityClientオブジェクトのgetPolicyManagerメソッドを呼び出して、PolicyManagerオブジェクトを作成します。

    • PolicyManagerオブジェクトのregisterPolicyメソッドを呼び出し、次の値を渡して、ポリシーを登録します。

      • 登録するポリシーを表すPolicyオブジェクト。

    • ポリシーが属するポリシーセットを表すstring値です。

    接続設定でAEM forms管理者アカウントを使用してDocumentSecurityClientオブジェクトを作成する場合は、registerPolicyメソッドを呼び出す際にポリシーセット名を指定します。 ポリシーセットのnull値を渡すと、管理者の​My Policies​ポリシーセットにポリシーが作成されます。

    接続設定内でDocument Securityユーザーを使用する場合は、ポリシーのみを受け入れるオーバーロードされたregisterPolicyメソッドを呼び出すことができます。 つまり、ポリシーセット名を指定する必要はありません。 ただし、ポリシーは​My Policies​という名前のポリシーセットに追加されます。 このポリシーセットに新しいポリシーを追加しない場合は、registerPolicyメソッドを呼び出す際にポリシーセット名を指定します。

    メモ

    ポリシーを作成する場合は、既存のポリシーセットを参照します。 存在しないポリシーセットを指定すると、例外が発生します。

Document Securityサービスを使用するコード例については、次を参照してください。

  • 「クイックスタート（SOAPモード）:Java APIを使用したポリシーの作成»

WebサービスAPIを使用してポリシーを作成します

Document Security API（Webサービス）を使用してポリシーを作成します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してDocumentSecurityServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してDocumentSecurityServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドRightsManagementServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドRightsManagementServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

  3. ポリシーの属性を設定します。

    • コンストラクタを使用して PolicySpec オブジェクトを作成します。
    • PolicySpecオブジェクトのnameデータメンバーに文字列値を割り当てて、ポリシーの名前を設定します。
    • PolicySpecオブジェクトのdescriptionデータメンバーに文字列値を割り当てて、ポリシーの説明を設定します。
    • PolicySpecオブジェクトのpolicySetNameデータメンバーに文字列値を割り当てて、ポリシーが属するポリシーセットを設定します。 既存のポリシーセット名を指定する必要があります。 （このパラメーター値にnullを指定すると、ポリシーが​My Policies​に追加されます）。
    • PolicySpecオブジェクトのofflineLeasePeriodデータメンバーに整数値を割り当てて、ポリシーのオフラインリース期間を設定します。
    • PolicySpecオブジェクトのpolicyXmlデータメンバーに、PDRL XMLデータを表す文字列値を設定します。 このタスクを実行するには、コンストラクタを使用して.NET StreamReaderオブジェクトを作成します。 ポリシーを表すPDRL XMLファイルの場所をStreamReaderコンストラクタに渡します。 次に、StreamReaderオブジェクトのReadLineメソッドを呼び出し、戻り値を文字列変数に割り当てます。 ReadLineメソッドがnullを返すまで、StreamReaderオブジェクトを繰り返し処理します。 文字列変数をPolicySpecオブジェクトのpolicyXmlデータメンバーに割り当てます。

  4. ポリシーエントリを作成します。

    Document Security WebサービスAPIを使用してポリシーを作成する場合は、ポリシーエントリを作成する必要はありません。 ポリシーエントリはPDRLドキュメントで定義されます。

  5. ポリシーを登録します。

    DocumentSecurityServiceClientオブジェクトのregisterPolicyメソッドを呼び出し、次の値を渡して、ポリシーを登録します。

    • 登録するポリシーを表すPolicySpecオブジェクト。
    • ポリシーが属するポリシーセットを表すstring値です。 null値を指定すると、ポリシーが​MyPolices​ポリシーセットに追加されます。

    接続設定でAEM forms管理者アカウントを使用してDocumentSecurityClientオブジェクトを作成する場合は、registerPolicyメソッドを呼び出す際にポリシーセット名を指定します。

    接続設定内でDocument SecurityDocument Securityユーザーを使用する場合は、ポリシーのみを受け入れるオーバーロードされたregisterPolicyメソッドを呼び出すことができます。 つまり、ポリシーセット名を指定する必要はありません。 ただし、ポリシーは​My Policies​という名前のポリシーセットに追加されます。 このポリシーセットに新しいポリシーを追加しない場合は、registerPolicyメソッドを呼び出す際にポリシーセット名を指定します。

    メモ

    ポリシーを作成し、ポリシーセットを指定する場合は、必ず既存のポリシーセットを指定してください。 存在しないポリシーセットを指定すると、例外が発生します。

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用したポリシーの作成»
  • 「クイックスタート(SwaRef):WebサービスAPIを使用したポリシーの作成»

ポリシーの変更

既存のポリシーは、Document Security Java APIまたはWebサービスAPIを使用して変更できます。 既存のポリシーに変更を加えるには、そのポリシーを取得して変更し、サーバー上でポリシーを更新します。 例えば、既存のポリシーを取得して有効期間を延長するとします。 変更を有効にする前に、ポリシーを更新する必要があります。

ビジネス要件が変更され、ポリシーにこれらの要件が反映されなくなった場合は、ポリシーを変更できます。 新しいポリシーを作成する代わりに、既存のポリシーを更新するだけで済みます。

Webサービスを使用してポリシー属性を変更するには（例えば、JAX-WSで作成されたJavaプロキシクラスを使用する）、ポリシーがDocument Securityサービスに登録されていることを確認する必要があります。 次に、PolicySpec.getPolicyXmlメソッドを使用して既存のポリシーを参照し、該当するメソッドを使用してポリシー属性を変更します。 例えば、PolicySpec.setOfflineLeasePeriodメソッドを呼び出して、オフラインリース期間を変更できます。

メモ

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

手順の概要

既存のポリシーを変更するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. 既存のポリシーを取得します。
  4. ポリシーの属性を変更します。
  5. ポリシーを更新します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成する必要があります。 Java APIを使用している場合は、RightsManagementClientオブジェクトを作成します。 Document Security WebサービスAPIを使用している場合は、RightsManagementServiceServiceオブジェクトを作成します。

既存のポリシーの取得

既存のポリシーを変更するには、そのポリシーを取得する必要があります。 ポリシーを取得するには、ポリシー名とポリシーが属するポリシーセットを指定します。 ポリシーセット名にnull値を指定すると、ポリシーは​My Policies​ポリシーセットから取得されます。

ポリシーの属性の設定

ポリシーを変更するには、ポリシー属性の値を変更します。 変更できない唯一のポリシー属性は、name属性です。 たとえば、ポリシーのオフラインリース期間を変更するには、ポリシーのオフラインリース期間属性の値を変更します。

Webサービスを使用してポリシーのオフラインリース期間を変更する場合、PolicySpecインターフェイスのofflineLeasePeriodフィールドは無視されます。 オフラインリース期間を更新するには、PDRL XMLドキュメントのOfflineLeasePeriod要素を変更します。 次に、PolicySpecインターフェイスのpolicyXMLデータメンバを使用して、更新されたPDRL XMLドキュメントを参照します。

メモ

設定できるその他の属性について詳しくは、『AEM Forms APIリファレンス』のPolicyインターフェイスの説明を参照してください。

ポリシーの更新

ポリシーに対して行った変更を反映する前に、Document Securityサービスを使用してポリシーを更新する必要があります。 ドキュメントを保護するポリシーに対する変更は、ポリシーで保護されたドキュメントが次回Document Securityサービスと同期されると更新されます。

Java APIを使用して既存のポリシーを変更する

Document Security API(Java)を使用して既存のポリシーを変更します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. 既存のポリシーを取得します。

    • RightsManagementClientオブジェクトのgetPolicyManagerメソッドを呼び出して、PolicyManagerオブジェクトを作成します。

    • PolicyManagerオブジェクトのgetPolicyメソッドを呼び出し、次の値を渡して、更新するポリシーを表すPolicyオブジェクトを作成します。

      • ポリシーが属するポリシーセット名を表すstring値です。 nullを指定すると、MyPoliciesポリシーセットが使用されます。
      • ポリシー名を表すstring値です。

  4. ポリシーの属性を設定します。

    ビジネス要件に合わせてポリシーの属性を変更します。 例えば、ポリシーのオフラインリース期間を変更するには、PolicyオブジェクトのsetOfflineLeasePeriodメソッドを呼び出します。

  5. ポリシーを更新します。

    PolicyManagerオブジェクトのupdatePolicyメソッドを呼び出して、ポリシーを更新します。 更新するポリシーを表すPolicyオブジェクトを渡します。

コード例

Document Securityサービスを使用するコード例については、「クイックスタート（SOAPモード） 」を参照してください。「 Java API 」セクションを使用してポリシーを変更する。

WebサービスAPIを使用して既存のポリシーを変更します

Document Security API（Webサービス）を使用して既存のポリシーを変更します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してRightsManagementServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してRightsManagementServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドRightsManagementServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドRightsManagementServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

  3. 既存のポリシーを取得します。

    RightsManagementServiceClientオブジェクトのgetPolicyメソッドを呼び出し、次の値を渡して、変更するポリシーを表すPolicySpecオブジェクトを作成します。

    • ポリシーが属するポリシーセット名を指定するstring値です。 nullを指定すると、MyPoliciesポリシーセットが使用されます。
    • ポリシーの名前を指定するstring値です。

  4. ポリシーの属性を設定します。

    ビジネス要件に合わせてポリシーの属性を変更します。

  5. ポリシーを更新します。

    RightsManagementServiceClientオブジェクトのupdatePolicyFromSDKメソッドを呼び出し、更新するポリシーを表すPolicySpecオブジェクトを渡すことで、ポリシーを更新します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用したポリシーの変更»
  • 「クイックスタート(SwaRef):WebサービスAPIを使用したポリシーの変更»

ポリシーの削除

既存のポリシーは、Document Security Java APIまたはWebサービスAPIを使用して削除できます。 ポリシーを削除すると、そのポリシーを使用してドキュメントを保護できなくなります。 ただし、ポリシーを使用している既存のポリシーで保護されたドキュメントは、引き続き保護されます。 新しいポリシーが利用可能になったら、ポリシーを削除できます。

メモ

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

手順の概要

既存のポリシーを削除するには、次の手順を実行します。

  1. プロジェクトファイルを含める
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. ポリシーを削除します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成する必要があります。 Java APIを使用している場合は、RightsManagementClientオブジェクトを作成します。 Document Security WebサービスAPIを使用している場合は、RightsManagementServiceServiceオブジェクトを作成します。

ポリシーの削除

ポリシーを削除するには、削除するポリシーと、そのポリシーが属するポリシーセットを指定します。 AEM Formsの呼び出しに使用される設定を持つユーザーは、ポリシーを削除する権限が必要です。それ以外の場合は、例外が発生します。 同様に、存在しないポリシーを削除しようとすると、例外が発生します。

Java APIを使用したポリシーの削除

Document Security API(Java)を使用してポリシーを削除します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. ポリシーを削除します。

    • RightsManagementClientオブジェクトのgetPolicyManagerメソッドを呼び出して、PolicyManagerオブジェクトを作成します。

    • PolicyManagerオブジェクトのdeletePolicyメソッドを呼び出し、次の値を渡して、ポリシーを削除します。

      • ポリシーが属するポリシーセット名を指定するstring値です。 nullを指定すると、MyPoliciesポリシーセットが使用されます。
      • 削除するポリシーの名前を指定するstring値。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（SOAPモード）:Java APIを使用したポリシーの削除»

WebサービスAPIを使用したポリシーの削除

Document Security API（Webサービス）を使用してポリシーを削除します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してRightsManagementServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してRightsManagementServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドRightsManagementServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドRightsManagementServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

  3. ポリシーを削除します。

    RightsManagementServiceClientオブジェクトのdeletePolicyメソッドを呼び出し、次の値を渡して、ポリシーを削除します。

    • ポリシーが属するポリシーセット名を指定するstring値です。 nullを指定すると、MyPoliciesポリシーセットが使用されます。
    • 削除するポリシーの名前を指定するstring値。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用したポリシーの削除"
  • 「クイックスタート(SwaRef):WebサービスAPIを使用したポリシーの削除"

PDFドキュメントへのポリシーの適用

ドキュメントを保護するために、PDFドキュメントにポリシーを適用できます。 PDFドキュメントにポリシーを適用すると、ドキュメントへのアクセスを制限できます。 ドキュメントが既にポリシーで保護されている場合、ドキュメントにポリシーを適用することはできません。

ドキュメントを開いている間は、テキストの印刷とコピー、変更、ドキュメントへの署名とコメントの追加など、AcrobatとAdobe Readerの機能へのアクセスを制限することもできます。 また、ユーザーにドキュメントへのアクセスを許可しない場合に、ポリシーで保護されたPDFドキュメントを失効させることもできます。

ポリシーで保護されたドキュメントを配布した後で、そのドキュメントの使用を監視できます。 つまり、ドキュメントの使用方法と使用者を確認できます。 例えば、誰かがドキュメントを開いた日時を調べることができます。

メモ

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

手順の概要

PDFドキュメントにポリシーを適用するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. ポリシーが適用されるPDFドキュメントを取得します。
  4. PDFドキュメントに既存のポリシーを適用します。
  5. ポリシーで保護されたPDFドキュメントを保存します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成します。 Java APIを使用している場合は、DocumentSecurityClientオブジェクトを作成します。 Document Security WebサービスAPIを使用している場合は、DocumentSecurityServiceServiceオブジェクトを作成します。

PDFドキュメントの取得

PDFドキュメントを取得してポリシーを適用できます。 PDFドキュメントにポリシーを適用すると、ドキュメントの使用時にユーザーが制限されます。 例えば、オフライン時にドキュメントを開くことをポリシーで有効にしていない場合、ドキュメントを開くにはユーザーがオンラインである必要があります。

PDFドキュメントへの既存のポリシーの適用

PDFドキュメントにポリシーを適用するには、既存のポリシーを参照し、ポリシーが属するポリシーセットを指定します。 接続プロパティを設定するユーザーは、指定したポリシーにアクセスできる必要があります。 そうでない場合、例外が発生します。

PDFドキュメントの保存

Document SecurityサービスによってPDFドキュメントにポリシーが適用されたら、ポリシーで保護されたPDFドキュメントをPDFファイルとして保存できます。

関連トピック

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

接続プロパティの設定

ドキュメントへのアクセスの取り消し

Java APIを使用したPDFドキュメントへのポリシーの適用

Document Security API(Java)を使用してPDFドキュメントにポリシーを適用します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

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

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

  4. PDFドキュメントに既存のポリシーを適用します。

    • RightsManagementClientオブジェクトのgetDocumentManagerメソッドを呼び出して、DocumentManagerオブジェクトを作成します。

    • DocumentManagerオブジェクトのprotectDocumentメソッドを呼び出し、次の値を渡してPDFドキュメントにポリシーを適用します。

      • ポリシーが適用されるPDFドキュメントを含むcom.adobe.idp.Documentオブジェクト。
      • ドキュメントの名前を指定するstring値。
      • ポリシーが属するポリシーセットの名前を指定するstring値です。 nullの値を指定して、MyPoliciesポリシーセットを使用することができます。
      • ポリシー名を指定するstring値です。
      • ドキュメントのパブリッシャーであるユーザーのユーザーマネージャードメインの名前を表すstring値です。 このパラメーター値はオプションで、nullにできます（このパラメーターがnullの場合、次のパラメーター値はnullにする必要があります）。
      • ドキュメントのパブリッシャーであるユーザーマネージャーユーザーの正規名の名前を表すstring値です。 このパラメーターの値はオプションで、nullにできます（このパラメーターがnullの場合、前のパラメーターの値はnullにする必要があります）。
      • MS Officeテンプレートの選択に使用されるロケールを表すcom.adobe.livecycle.rightsmanagement.Locale。 このパラメーター値はオプションで、PDFドキュメントには使用されません。 PDFドキュメントを保護するには、nullを指定します。

      protectDocumentメソッドは、ポリシーで保護されたPDFドキュメントを含むRMSecureDocumentResultオブジェクトを返します。

  5. PDFドキュメントを保存します。

    • RMSecureDocumentResultオブジェクトのgetProtectedDocメソッドを呼び出して、ポリシーで保護されたPDFドキュメントを取得します。 このメソッドはcom.adobe.idp.Documentオブジェクトを返します。
    • java.io.Fileオブジェクトを作成し、ファイル拡張子がPDFであることを確認します。
    • com.adobe.idp.DocumentオブジェクトのcopyToFileメソッドを呼び出して、Documentオブジェクトの内容をファイルにコピーします（getProtectedDocメソッドで返されたDocumentオブジェクトを使用するようにしてください）。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（EJBモード）:Java APIを使用したPDFドキュメントへのポリシーの適用»
  • 「クイックスタート（SOAPモード）:Java APIを使用したPDFドキュメントへのポリシーの適用»

関連トピック

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

接続プロパティの設定

WebサービスAPIを使用してPDFドキュメントにポリシーを適用します

Document Security API（Webサービス）を使用してPDFドキュメントにポリシーを適用します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してRightsManagementServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してRightsManagementServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをFormsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドRightsManagementServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドRightsManagementServiceClient.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ドキュメントに既存のポリシーを適用します。

    RightsManagementServiceClientオブジェクトのprotectDocumentメソッドを呼び出し、次の値を渡してPDFドキュメントにポリシーを適用します。

    • ポリシーが適用されるPDFドキュメントを含むBLOBオブジェクト。
    • ドキュメントの名前を指定するstring値。
    • ポリシーが属するポリシーセットの名前を指定するstring値です。 nullの値を指定して、MyPoliciesポリシーセットを使用することができます。
    • ポリシー名を指定するstring値です。
    • ドキュメントのパブリッシャーであるユーザーのユーザーマネージャードメインの名前を表すstring値です。 このパラメーター値はオプションで、nullにできます（このパラメーターがnullの場合、次のパラメーター値はnullにする必要があります）。
    • ドキュメントのパブリッシャーであるユーザーマネージャーユーザーの正規名の名前を表すstring値です。 このパラメーター値はオプションで、nullにできます（このパラメーターがnullの場合、前のパラメーター値はnullにする必要があります）。
    • ロケール値を指定するRMLocale値（例：RMLocale.en）。
    • ポリシー識別子の値を格納するために使用される文字列出力パラメーターです。
    • ポリシーで保護された識別子の値を保存するために使用される文字列出力パラメーターです。
    • MIMEタイプの保存に使用する文字列出力パラメーター（例：application/pdf）。

    protectDocumentメソッドは、ポリシーで保護されたPDFドキュメントを含むBLOBオブジェクトを返します。

  5. PDFドキュメントを保存します。

    • コンストラクターを呼び出し、ポリシーで保護されたPDFドキュメントのファイルの場所を表す文字列値を渡すことで、System.IO.FileStreamオブジェクトを作成します。
    • protectDocumentメソッドで返されたBLOBオブジェクトのデータ内容を格納するバイト配列を作成します。 BLOBオブジェクトのMTOMデータメンバーの値を取得して、バイト配列を設定します。
    • コンストラクターを呼び出し、System.IO.FileStreamオブジェクトを渡して、System.IO.BinaryWriterオブジェクトを作成します。
    • System.IO.BinaryWriterオブジェクトのWriteメソッドを呼び出し、バイト配列を渡すことにより、バイト配列の内容をPDFファイルに書き込みます。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用したPDFドキュメントへのポリシーの適用»
  • 「クイックスタート(SwaRef):WebサービスAPI「 」を使用したPDFドキュメントへのポリシーの適用

PDFドキュメントからのポリシーの削除

ポリシーで保護されたドキュメントからポリシーを削除して、ドキュメントからセキュリティを削除できます。 つまり、ドキュメントをポリシーで保護したくない場合です。 ポリシーで保護されたドキュメントを新しいポリシーで更新する場合は、ポリシーを削除して更新されたポリシーを追加する代わりに、ポリシーを切り替える方が効率的です。

メモ

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

手順の概要

ポリシーで保護されたPDFドキュメントからポリシーを削除するには、次の手順を実行します。

  1. プロジェクトファイルを含める
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. ポリシーで保護されたPDFドキュメントを取得します。
  4. PDFドキュメントからポリシーを削除します。
  5. 保護されていないPDFドキュメントを保存します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成します。

ポリシーで保護されたPDFドキュメントの取得

ポリシーで保護されたPDFドキュメントを取得して、ポリシーを削除できます。 ポリシーで保護されていないPDFドキュメントからポリシーを削除しようとすると、例外が発生します。

PDFドキュメントからポリシーを削除します

接続設定で管理者が指定されている場合は、ポリシーで保護されたPDFドキュメントからポリシーを削除できます。 そうでない場合は、ドキュメントの保護に使用されるポリシーに、PDFドキュメントからポリシーを削除するためのSWITCH_POLICY権限が含まれている必要があります。 また、AEM Forms接続設定で指定したユーザーにも、その権限が必要です。 それ以外の場合は、例外がスローされます。

保護されていないPDFドキュメントの保存

Document SecurityサービスがPDFドキュメントからポリシーを削除した後、保護されていないPDFドキュメントをPDFファイルとして保存できます。

関連トピック

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

接続プロパティの設定

PDFドキュメントへのポリシーの適用

Java APIを使用してPDFドキュメントからポリシーを削除します

Document Security API(Java)を使用して、ポリシーで保護されたPDFドキュメントからポリシーを削除します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. ポリシーで保護されたPDFドキュメントを取得します。

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

  4. PDFドキュメントからポリシーを削除します。

    • DocumentSecurityClientオブジェクトのgetDocumentManagerメソッドを呼び出して、DocumentManagerオブジェクトを作成します。
    • DocumentManagerオブジェクトのremoveSecurityメソッドを呼び出し、ポリシーで保護されたPDFドキュメントを含むcom.adobe.idp.Documentオブジェクトを渡すことで、PDFドキュメントからポリシーを削除します。 このメソッドは、保護されていないPDFドキュメントを含むcom.adobe.idp.Documentオブジェクトを返します。

  5. 保護されていないPDFドキュメントを保存します。

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

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（SOAPモード）:Java APIを使用したPDFドキュメントからのポリシーの削除»

WebサービスAPIを使用してポリシーを削除する

Document Security API（Webサービス）を使用して、ポリシーで保護されたPDFドキュメントからポリシーを削除します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してDocumentSecurityServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してDocumentSecurityServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドDocumentSecurityServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドDocumentSecurityServiceClient.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ドキュメントからポリシーを削除します。

    DocumentSecurityServiceClientオブジェクトのremovePolicySecurityメソッドを呼び出し、ポリシーで保護されたPDFドキュメントを含むBLOBオブジェクトを渡すことで、PDFドキュメントからポリシーを削除します。 このメソッドは、保護されていないPDFドキュメントを含むBLOBオブジェクトを返します。

  5. 保護されていないPDFドキュメントを保存します。

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

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPI「 」を使用したPDFドキュメントからのポリシーの削除
  • 「クイックスタート(SwaRef):WebサービスAPIを使用したPDFドキュメントからのポリシーの削除"

関連トピック

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

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

ドキュメントへのアクセスの取り消し

ポリシーで保護されたPDFドキュメントへのアクセスを取り消すと、そのドキュメントのすべてのコピーにユーザーからアクセスできなくなります。 失効したPDFドキュメントを開こうとすると、ユーザーは、変更されたドキュメントを表示できる、指定されたURLにリダイレクトされます。 ユーザーのリダイレクト先のURLは、プログラムで指定する必要があります。 ドキュメントへのアクセスを取り消すと、ポリシーで保護されたドキュメントをオンラインで開くことで、ユーザーが次回Document Securityサービスと同期したときに、変更が反映されます。

ドキュメントへのアクセスを取り消す機能により、セキュリティが強化されます。 例えば、新しいバージョンのドキュメントが利用可能で、古いバージョンを表示するユーザーがいなくなるとします。 この場合、古いドキュメントへのアクセスを取り消し、アクセス権を回復しない限り、ドキュメントを表示できません。

メモ

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

手順の概要

ポリシーで保護されたドキュメントを失効するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. ポリシーで保護されたPDFドキュメントを取得します。
  4. ポリシーで保護されたドキュメントを失効します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成する必要があります。

ポリシーで保護されたPDFドキュメントの取得

ポリシーで保護されたPDFドキュメントを取り消すには、そのドキュメントを取得する必要があります。 失効済みのドキュメントや、ポリシーで保護されたドキュメントではないドキュメントは失効できません。

ポリシーで保護されたドキュメントのライセンス識別子の値がわかっている場合は、ポリシーで保護されたPDFドキュメントを取得する必要はありません。 ただし、ほとんどの場合、ライセンス識別子の値を取得するためにPDFドキュメントを取得する必要があります。

ポリシーで保護されたドキュメントの失効

ポリシーで保護されたドキュメントを失効するには、ポリシーで保護されたドキュメントのライセンス識別子を指定します。 また、失効したドキュメントを開こうとしたときにユーザーが表示できるドキュメントのURLを指定できます。 つまり、古いドキュメントが取り消されたとします。 ユーザーが失効したドキュメントを開こうとすると、失効したドキュメントではなく、更新されたドキュメントが表示されます。

メモ

既に失効したドキュメントを失効しようとすると、例外が発生します。

関連トピック

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

接続プロパティの設定

PDFドキュメントへのポリシーの適用

取り消されたドキュメントへのアクセス権の回復

Java APIを使用してドキュメントへのアクセスを取り消す

Document Security API(Java)を使用して、ポリシーで保護されたPDFドキュメントへのアクセス権を失効します。

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

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

  2. Document SecurityクライアントAPIオブジェクトの作成

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. ポリシーで保護されたPDFドキュメントの取得

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

  4. ポリシーで保護されたドキュメントの失効

    • DocumentSecurityClientオブジェクトのgetDocumentManagerメソッドを呼び出して、DocumentManagerオブジェクトを作成します。

    • DocumentManagerオブジェクトのgetLicenseIdメソッドを呼び出して、ポリシーで保護されたドキュメントのライセンス識別子の値を取得します。 ポリシーで保護されたドキュメントを表すcom.adobe.idp.Documentオブジェクトを渡します。 このメソッドは、ライセンス識別子の値を表すstring値を返します。

    • DocumentSecurityClientオブジェクトのgetLicenseManagerメソッドを呼び出して、LicenseManagerオブジェクトを作成します。

    • LicenseManagerオブジェクトのrevokeLicenseメソッドを呼び出し、次の値を渡して、ポリシーで保護されたドキュメントを失効します。

      • ポリシーで保護されたドキュメントのライセンス識別子の値（DocumentManagerオブジェクトのgetLicenseIdメソッドの戻り値を指定）を指定するstring値。
      • ドキュメントを失効させる理由を指定する、Licenseインターフェイスの静的データメンバーです。 例えば、License.DOCUMENT_REVISEDを指定できます。
      • 改訂されたドキュメントの場所を指定するjava.net.URL値。 ユーザーを別のURLにリダイレクトしたくない場合は、nullを渡すことができます。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（SOAPモード）:Java APIを使用したドキュメントの取り消し»

WebサービスAPIを使用してドキュメントへのアクセスを取り消す

Document Security API（Webサービス）を使用して、ポリシーで保護されたPDFドキュメントへのアクセス権を失効します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトの作成

    • デフォルトのコンストラクターを使用してDocumentSecurityServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してDocumentSecurityServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドDocumentSecurityServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドDocumentSecurityServiceClient.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. ポリシーで保護されたドキュメントの失効

    • DocumentSecurityServiceClientオブジェクトのgetLicenseIDメソッドを呼び出し、ポリシーで保護されたドキュメントを表すBLOBオブジェクトを渡すことで、ポリシーで保護されたドキュメントのライセンス識別子の値を取得します。 このメソッドは、ライセンス識別子を表すstring値を返します。

    • DocumentSecurityServiceClientオブジェクトのrevokeLicenseメソッドを呼び出し、次の値を渡して、ポリシーで保護されたドキュメントを失効します。

      • ポリシーで保護されたドキュメントのライセンス識別子の値（DocumentSecurityServiceServiceオブジェクトのgetLicenseIdメソッドの戻り値を指定）を指定するstring値。
      • ドキュメントを失効させる理由を指定する、Reason列挙の静的データメンバーです。 例えば、Reason.DOCUMENT_REVISEDを指定できます。
      • 改訂されたドキュメントのURLの場所を指定するstring値。 ユーザーを別のURLにリダイレクトしたくない場合は、nullを渡すことができます。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用したドキュメントの取り消し"
  • 「クイックスタート(SwaRef):WebサービスAPIを使用したドキュメントの取り消し"

関連トピック

Wordドキュメントからポリシーを削除する

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

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

失効したドキュメントへのアクセス権の回復

失効したPDFドキュメントへのアクセス権を回復すると、失効したドキュメントのすべてのコピーにユーザーがアクセスできるようになります。 ユーザーが失効した回復済みドキュメントを開くと、そのドキュメントを表示できます。

メモ

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

手順の概要

取り消されたPDFドキュメントへのアクセス権を復元するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. 失効したPDFドキュメントのライセンス識別子を取得します。
  4. 失効したPDFドキュメントへのアクセス権を回復します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成する必要があります。 Java APIを使用している場合は、DocumentSecurityClientオブジェクトを作成します。 Document Security WebサービスAPIを使用している場合は、DocumentSecurityServiceServiceオブジェクトを作成します。

失効したPDFドキュメントのライセンス識別子の取得

失効したPDFドキュメントを復元するには、失効したPDFドキュメントのライセンス識別子を取得する必要があります。 ライセンス識別子の値を取得した後、失効したドキュメントを復元できます。 失効していないドキュメントを元に戻そうとすると、例外が発生します。

失効したPDFドキュメントへのアクセス権の回復

失効したPDFドキュメントへのアクセス権を回復するには、失効したドキュメントのライセンス識別子を指定する必要があります。 失効していないPDFドキュメントへのアクセス権を復元しようとすると、例外が発生します。

関連トピック

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

接続プロパティの設定

PDFドキュメントへのポリシーの適用

ドキュメントへのアクセスの取り消し

Java APIを使用した、失効したドキュメントへのアクセス権の回復

Document Security API(Java)を使用して、取り消されたドキュメントへのアクセス権を復元します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. 失効したPDFドキュメントのライセンス識別子を取得します。

    • コンストラクターを使用し、PDFドキュメントの場所を指定する文字列値を渡すことで、失効したPDFドキュメントを表すjava.io.FileInputStreamオブジェクトを作成します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。
    • DocumentSecurityClientオブジェクトのgetDocumentManagerメソッドを呼び出して、DocumentManagerオブジェクトを作成します。
    • DocumentManagerオブジェクトのgetLicenseIdメソッドを呼び出し、取り消されたドキュメントを表すcom.adobe.idp.Documentオブジェクトを渡して、取り消されたドキュメントのライセンス識別子の値を取得します。 このメソッドは、ライセンス識別子を表すstring値を返します。

  4. 失効したPDFドキュメントへのアクセス権を回復します。

    • DocumentSecurityClientオブジェクトのgetLicenseManagerメソッドを呼び出して、LicenseManagerオブジェクトを作成します。
    • LicenseManagerオブジェクトのunrevokeLicenseメソッドを呼び出し、取り消されたドキュメントのライセンス識別子の値を渡すことで、取り消されたPDFドキュメントへのアクセスを回復します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（SOAPモード）:WebサービスAPIを使用した、取り消されたドキュメントへのアクセス権の回復」

WebサービスAPIを使用した、失効したドキュメントへのアクセス権の回復

Document Security API（Webサービス）を使用して、取り消されたドキュメントへのアクセス権を回復します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してDocumentSecurityServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してDocumentSecurityServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドDocumentSecurityServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドDocumentSecurityServiceClient.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ドキュメントへのアクセス権を回復します。

    • DocumentSecurityServiceClientオブジェクトのgetLicenseIDメソッドを呼び出し、取り消されたドキュメントを表すBLOBオブジェクトを渡して、取り消されたドキュメントのライセンス識別子の値を取得します。 このメソッドは、ライセンス識別子を表すstring値を返します。
    • DocumentSecurityServiceClientオブジェクトのunrevokeLicenseメソッドを呼び出し、取り消されたPDFドキュメントのライセンス識別子の値を指定する文字列値を渡す（DocumentSecurityServiceClientオブジェクトのgetLicenseIdメソッドの戻り値を渡す）ことで、取り消されたPDFドキュメントへのアクセスを回復します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用した、取り消されたドキュメントへのアクセス権の回復」
  • 「クイックスタート(SwaRef):WebサービスAPIを使用した、取り消されたドキュメントへのアクセス権の回復」

関連トピック

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

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

ポリシーで保護されたPDFドキュメントの検査

Document Security Service API（JavaおよびWebサービス）を使用して、ポリシーで保護されたPDFドキュメントを検査できます。 ポリシーで保護されたPDFドキュメントを検査すると、ポリシーで保護されたPDFドキュメントに関する情報が返されます。 例えば、ドキュメントの保護に使用されたポリシーやドキュメントの保護日を決定できます。

バージョンが8.x以前の場合は、このLiveCycleを実行できません。 ポリシーで保護されたドキュメントの検査のサポートがAEM Formsに追加されました。 LiveCycle8.x（またはそれ以前）を使用してポリシーで保護されたドキュメントを検査しようとすると、例外がスローされます。

メモ

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

手順の概要

ポリシーで保護されたPDFドキュメントを検査するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. 検査するポリシーで保護されたドキュメントを取得します。
  4. ポリシーで保護されたドキュメントに関する情報を取得します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成します。 Java APIを使用している場合は、RightsManagementClientオブジェクトを作成します。 Document Security WebサービスAPIを使用している場合は、RightsManagementServiceServiceオブジェクトを作成します。

検査するポリシーで保護されたドキュメントの取得

ポリシーで保護されたドキュメントを検査するには、ドキュメントを取得します。 ポリシーで保護されていないドキュメントや、失効したドキュメントを検査しようとすると、例外が発生します。

ドキュメントのInspect

ポリシーで保護されたドキュメントを取得したら、それを調べることができます。

ポリシーで保護されたドキュメントに関する情報の取得

ポリシーで保護されたPDFドキュメントを検査した後、そのドキュメントに関する情報を取得できます。 例えば、ドキュメントを保護するために使用されるポリシーを決定できます。

マイポリシーに属するポリシーでドキュメントを保護し、RMInspectResult.getPolicysetNameまたはRMInspectResult.getPolicysetIdを呼び出すと、nullが返されます。

ポリシーセットに含まれるポリシー（マイポリシー以外）を使用してドキュメントを保護している場合、RMInspectResult.getPolicysetNameとRMInspectResult.getPolicysetIdは有効な文字列を返します。

関連トピック

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

接続プロパティの設定

Java APIを使用したInspectポリシーで保護されたPDFドキュメント

Inspect Security Service API(Java)を使用して、ポリシーで保護されたPDFドキュメントを作成します。

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

    Javaプロジェクトのクラスパスに、adobe-rightsmanagement-client.jarなどのクライアントJARファイルを含めます。 これらのファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。（接続プロパティの設定を参照。）
    • コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. 検査するポリシーで保護されたドキュメントを取得します。

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

  4. ドキュメントをInspectします。

    • RightsManagementClientオブジェクトのgetDocumentManagerメソッドを呼び出して、DocumentManagerオブジェクトを作成します。
    • LicenseManagerオブジェクトのinspectDocumentメソッドを呼び出すことで、ポリシーで保護されたドキュメントをInspectします。 ポリシーで保護されたPDFドキュメントを含むcom.adobe.idp.Documentオブジェクトを渡します。 このメソッドは、ポリシーで保護されたドキュメントに関する情報を含むRMInspectResultオブジェクトを返します。

  5. ポリシーで保護されたドキュメントに関する情報を取得します。

    ポリシーで保護されたドキュメントに関する情報を取得するには、RMInspectResultオブジェクトに属する適切なメソッドを呼び出します。 例えば、ポリシー名を取得するには、RMInspectResultオブジェクトのgetPolicyNameメソッドを呼び出します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（SOAPモード）:Java APIを使用したポリシーで保護されたPDFドキュメントの検査»

WebサービスAPIを使用したInspectポリシーで保護されたPDFドキュメント

Inspect Security Service API（Webサービス）を使用して、ポリシーで保護されたPDFドキュメントを作成します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してRightsManagementServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してRightsManagementServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドRightsManagementServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドRightsManagementServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

  3. 検査するポリシーで保護されたドキュメントを取得します。

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

  4. ドキュメントをInspectします。

    RightsManagementServiceClientオブジェクトのinspectDocumentメソッドを呼び出すことで、ポリシーで保護されたドキュメントをInspectします。 ポリシーで保護されたPDFドキュメントを含むBLOBオブジェクトを渡します。 このメソッドは、ポリシーで保護されたドキュメントに関する情報を含むRMInspectResultオブジェクトを返します。

  5. ポリシーで保護されたドキュメントに関する情報を取得します。

    ポリシーで保護されたドキュメントに関する情報を取得するには、RMInspectResultオブジェクトに属する適切なフィールドの値を取得します。 例えば、ポリシー名を取得するには、RMInspectResultオブジェクトのpolicyNameフィールドの値を取得します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用したポリシーで保護されたPDFドキュメントの検査»
  • 「クイックスタート(SwaRef):WebサービスAPIを使用したポリシーで保護されたPDFドキュメントの検査»

関連トピック

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

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

透かしの作成

透かしは、ドキュメントを一意に識別し、著作権侵害を制御することで、ドキュメントのセキュリティを確保するのに役立ちます。 例えば、ドキュメントのすべてのページに機密を示す透かしを作成して配置できます。 透かしを作成した後は、その透かしをポリシーの一部として含めることができます。 つまり、新しく作成した透かしをポリシーの透かし属性に設定できます。 透かしを含むポリシーがドキュメントに適用されると、その透かしがポリシーで保護されたドキュメントに表示されます。

メモ

透かしを作成できるのは、Document Securityの管理権限を持つユーザーだけです。 つまり、Document Securityサービスクライアントオブジェクトの作成に必要な接続設定を定義する場合は、このようなユーザーを指定する必要があります。

メモ

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

手順の概要

透かしを作成するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. 透かしの属性を設定します。
  4. 透かしをDocument Securityサービスに登録します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成する必要があります。 Java APIを使用している場合は、RightsManagementClientオブジェクトを作成します。 Document Security WebサービスAPIを使用している場合は、RightsManagementServiceServiceオブジェクトを作成します。

透かしの属性の設定

新しい透かしを作成するには、透かしの属性を設定する必要があります。 name属性は必ず定義する必要があります。 name属性に加えて、次の属性の少なくとも1つを設定する必要があります。

  • カスタムテキスト
  • DateIncluded
  • UserIdIncluded
  • UserNameIncluded

次の表に、Webサービスを使用して透かしを作成する際に必要なキーと値のペアを示します。

キー名

説明

値

WaterBackCmd:IS_USERNAME_ENABLED

ドキュメントを開くユーザーのユーザー名が透かしの一部であるかどうかを指定します。

True または False

WaterBackCmd:IS_USERID_ENABLED

ドキュメントを開くユーザーのIDが透かしの一部であるかどうかを指定します。

True または False

WaterBackCmd:IS_CURRENTDATE_ENABLED

現在の日付が透かしの一部であるかどうかを指定します。

True または False

WaterBackCmd:IS_CUSTOMTEXT_ENABLED

この値がtrueの場合、カスタムテキストの値はWaterBackCmd:SRCTEXTを使用して指定する必要があります。

True または False

WaterBackCmd:OPACITY

透かしの不透明度を指定します。 指定しない場合、デフォルト値は0.5です。

0.0 ～ 1.0の値。

WaterBackCmd:ROTATION

透かしの回転を指定します。 デフォルト値は0度です。

0 ～ 359の値。

WaterBackCmd:SCALE

この値を指定する場合は、WaterBackCmd:IS_SIZE_ENABLEDが存在し、値がtrueである必要があります。 この属性を指定しない場合、デフォルトの動作はページに合わせて適用されます。

0.0 より大きく 1.0 以下の値。

WaterBackCmd:HORIZ_ALIGN

透かしの水平方向の配置を指定します。 デフォルト値はcenterです。

左、中央、または右

WaterBackCmd:VERT_ALIGN

透かしの垂直方向の配置を指定します。 デフォルト値はcenterです。

上、中央、下

WaterBackCmd:IS_USE_BACKGROUND

透かしが背景かどうかを指定します。 デフォルト値は false です。

True または False

WaterBackCmd:IS_SIZE_ENABLED

カスタム尺度を指定する場合はTrue。 この値がtrueの場合は、SCALEも指定する必要があります。 この値がfalseの場合、デフォルトはページに合わせて適用されます。

True または False

WaterBackCmd:SRCTEXT

透かしのカスタムテキストを指定します。 この値が存在する場合は、WaterBackCmd:IS_CUSTOMTEXT_ENABLEDも存在し、trueに設定されている必要があります。

True または False

すべての透かしに、次の属性のいずれかを定義する必要があります。

  • WaterBackCmd:IS_USERNAME_ENABLED
  • WaterBackCmd:IS_USERID_ENABLED
  • WaterBackCmd:IS_CURRENTDATE_ENABLED
  • WaterBackCmd:IS_CUSTOMTEXT_ENABLED

その他の属性はすべてオプションです。

透かしの登録

新しい透かしを使用するには、その透かしをDocument Securityサービスに登録する必要があります。 透かしを登録すると、その透かしをポリシー内で使用できます。

関連トピック

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

接続プロパティの設定

PDFドキュメントへのポリシーの適用

Java APIを使用した透かしの作成

Document Security API(Java)を使用して透かしを作成します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. 透かしの属性の設定

    • InfomodelObjectFactoryオブジェクトの静的なcreateWatermarkメソッドを呼び出して、Watermarkオブジェクトを作成します。 このメソッドはWatermarkオブジェクトを返します。
    • WatermarkオブジェクトのsetNameメソッドを呼び出し、ポリシー名を指定する文字列値を渡すことで、透かしの名前属性を設定します。
    • WatermarkオブジェクトのsetBackgroundメソッドを呼び出し、trueを渡すことで、透かしの背景属性を設定します。 この属性を設定すると、透かしがドキュメントの背景に表示されます。
    • WatermarkオブジェクトのsetCustomTextメソッドを呼び出し、透かしのテキストを表す文字列値を渡すことで、透かしのカスタムテキスト属性を設定します。
    • WatermarkオブジェクトのsetOpacityメソッドを呼び出し、不透明度レベルを指定する整数値を渡すことで、透かしの不透明度属性を設定します。 値が100の場合、透かしは完全に不透明で、値が0の場合、透かしは完全に透明です。

  4. 透かしを登録します。

    • RightsManagementClientオブジェクトのgetWatermarkManagerメソッドを呼び出して、WatermarkManagerオブジェクトを作成します。 このメソッドはWatermarkManagerオブジェクトを返します。
    • WatermarkManagerオブジェクトのregisterWatermarkメソッドを呼び出し、登録する透かしを表すWatermarkオブジェクトを渡すことで、透かしを登録します。 このメソッドは、透かしの識別値を表すstring値を返します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（SOAPモード）:Java APIを使用した透かしの作成»

WebサービスAPIを使用して透かしを作成します。

Document Security API（Webサービス）を使用して透かしを作成します。

  1. Document SecurityクライアントAPIオブジェクトを作成します。

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してRightsManagementServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してRightsManagementServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドRightsManagementServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドRightsManagementServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

  3. 透かしの属性を設定します。

    • WatermarkSpecコンストラクターを呼び出して、WatermarkSpecオブジェクトを作成します。
    • WatermarkSpecオブジェクトのnameデータメンバに文字列値を割り当てて、透かしの名前を設定します。
    • WatermarkSpecオブジェクトのidデータメンバーに文字列値を割り当てて、透かしのid属性を設定します。
    • 設定する透かしプロパティごとに、個別のMyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトを作成します。
    • MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトのkeyデータメンバーに値を割り当てて、キー値を設定します（例：WaterBackCmd:OPACITY)）。
    • MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトのvalueデータメンバーに値を割り当てて値を設定します（例：.25）。
    • MyArrayOf_xsd_anyTypeオブジェクトを作成します。 MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトごとに、MyArrayOf_xsd_anyTypeオブジェクトのAddメソッドを呼び出します。 MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトを渡します。
    • MyArrayOf_xsd_anyTypeオブジェクトをWatermarkSpecオブジェクトのvaluesデータメンバーに割り当てます。

  4. 透かしを登録します。

    RightsManagementServiceClientオブジェクトのregisterWatermarkメソッドを呼び出し、登録する透かしを表すWatermarkSpecオブジェクトを渡すことで、透かしを登録します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用した透かしの作成」を参照してください。
  • 「クイックスタート(SwaRef):WebサービスAPIを使用した透かしの作成」を参照してください。

関連トピック

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

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

透かしの変更

既存の透かしは、Document Security Java APIまたはWebサービスAPIを使用して変更できます。 既存の透かしに変更を加えるには、その透かしを取得し、その属性を変更して、サーバー上で更新します。 例えば、透かしを取得し、その不透明度属性を変更したとします。 変更を有効にする前に、透かしを更新する必要があります。

透かしを変更すると、その透かしが適用された後のドキュメントに影響が及びます。 つまり、透かしを含む既存のPDFドキュメントは影響を受けません。

メモ

透かしを変更できるのは、Document Securityの管理権限を持つユーザーだけです。 つまり、Document Securityサービスクライアントオブジェクトの作成に必要な接続設定を定義する場合は、このようなユーザーを指定する必要があります。

メモ

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

手順の概要

透かしを変更するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. 変更する透かしを取得します。
  4. 透かしの属性を設定します。
  5. 透かしを更新します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成する必要があります。 Java APIを使用している場合は、DocumentSecurityClientオブジェクトを作成します。 Document Security WebサービスAPIを使用している場合は、DocumentSecurityServiceServiceオブジェクトを作成します。

変更する透かしの取得

透かしを変更するには、既存の透かしを取得する必要があります。 透かしを取得するには、名前を指定するか、識別子の値を指定します。

透かしの属性の設定

既存の透かしを変更するには、1つ以上の透かし属性の値を変更します。 Webサービスを使用してプログラムによって透かしを更新する場合、値が変更されなくても、元々設定されていたすべての属性を設定する必要があります。 例えば、次の透かし属性が設定されているとします。WaterBackCmd:IS_USERID_ENABLED、WaterBackCmd:IS_CUSTOMTEXT_ENABLED、WaterBackCmd:OPACITY、およびWaterBackCmd:SRCTEXTです。 変更する属性はWaterBackCmd:OPACITYのみですが、他の値は適切に設定する必要があります。

メモ

Java APIを使用して透かしを変更する場合、すべての属性を指定する必要はありません。 変更する透かし属性を設定します。

メモ

透かし属性の名前について詳しくは、「透かしの作成」を参照してください。

透かしの更新

透かしの属性を変更した後、透かしを更新する必要があります。

関連トピック

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

接続プロパティの設定

透かしの作成

Java APIを使用した透かしの変更

Document Security API(Java)を使用して透かしを変更します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. 変更する透かしを取得します。

    DocumentSecurityClientオブジェクトのgetWatermarkManagerメソッドを呼び出してWatermarkManagerオブジェクトを作成し、透かし名を指定する文字列値を渡します。 このメソッドは、変更する透かしを表すWatermarkオブジェクトを返します。

  4. 透かしの属性を設定します。

    WatermarkオブジェクトのsetOpacityメソッドを呼び出し、不透明度レベルを指定する整数値を渡すことで、透かしの不透明度属性を設定します。 値が100の場合、透かしは完全に不透明で、値が0の場合、透かしは完全に透明です。

    メモ

    次の使用例は、不透明度の属性のみを変更します。

  5. 透かしを更新します。

    • WatermarkManagerオブジェクトのupdateWatermarkメソッドを呼び出して透かしを更新し、属性が変更されたWatermarkオブジェクトを渡します。

コード例

Document Securityサービスを使用するコード例については、「クイックスタート（SOAPモード） 」を参照してください。「Java API」セクションを使用した透かしの変更

WebサービスAPIを使用して透かしを変更します

Document Security API（Webサービス）を使用して透かしを変更します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してDocumentSecurityServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してRightsManagementServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/DocumentSecurityService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドDocumentSecurityServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドDocumentSecurityServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

  3. 変更する透かしを取得します。

    DocumentSecurityServiceClientオブジェクトのgetWatermarkByNameメソッドを呼び出して、変更する透かしを取得します。 透かし名を指定するstring値を渡します。 このメソッドは、変更する透かしを表すWatermarkSpecオブジェクトを返します。

  4. 透かしの属性を設定します。

    • 更新する透かしプロパティごとに、個別のMyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトを作成します。
    • MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトのkeyデータメンバーに値を割り当てて、キー値を設定します（例：WaterBackCmd:OPACITY)）。
    • MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトのvalueデータメンバーに値を割り当てて値を設定します（例：.50）。
    • MyArrayOf_xsd_anyTypeオブジェクトを作成します。 MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトごとに、MyArrayOf_xsd_anyTypeオブジェクトのAddメソッドを呼び出します。 MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトを渡します。
    • MyArrayOf_xsd_anyTypeオブジェクトをWatermarkSpecオブジェクトのvaluesデータメンバーに割り当てます。

  5. 透かしを更新します。

    DocumentSecurityServiceClientオブジェクトのupdateWatermarkメソッドを呼び出し、変更する透かしを表すWatermarkSpecオブジェクトを渡すことで、透かしを更新します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用した透かしの変更」

イベントの検索

Rights Managementサービスは、特定のアクション（ドキュメントへのポリシーの適用、ポリシーで保護されたドキュメントの開く、ドキュメントへのアクセスの取り消しなど）の発生時に追跡を行います。 イベントサービスに対してイベント監査を有効にする必要があります。有効にしないと、Rights Managementが追跡されません。

イベントは、次のカテゴリのいずれかに分類されます。

  • 管理者イベントは、新しい管理者アカウントの作成など、管理者に関連するアクションです。
  • ドキュメントイベントは、ポリシーで保護されたドキュメントを閉じるなど、ドキュメントに関連するアクションです。
  • ポリシーイベントは、新しいポリシーの作成など、ポリシーに関連するアクションです。
  • サービスイベントとは、ユーザーディレクトリとの同期など、Rights Managementサービスに関連するアクションです。

Rights ManagementJava APIまたはWebサービスAPIを使用して、特定のイベントを検索できます。 イベントを検索することで、特定のイベントのログファイルの作成などのタスクを実行できます。

メモ

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

手順の概要

イベントイベントを検索するには、次のRights Managementを実行します。

  1. プロジェクトファイルを含めます。
  2. Rights ManagementクライアントAPIオブジェクトを作成します。
  3. 検索するイベントを指定します。
  4. イベントを検索します。

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

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

Rights ManagementクライアントAPIオブジェクトの作成

プログラムでRights Managementサービス操作を実行する前に、Rights Managementサービスクライアントオブジェクトを作成する必要があります。 Java APIを使用している場合は、DocumentSecurityClientオブジェクトを作成します。 Rights ManagementWebサービスAPIを使用している場合は、DocumentSecurityServiceServiceオブジェクトを作成します。

検索するイベントの指定

検索するイベントを指定する必要があります。 例えば、新しいポリシーの作成時に発生するポリシー作成イベントを検索できます。

イベントの検索

検索するイベントを指定したら、Rights ManagementJava APIまたはRights ManagementWebサービスAPIを使用してイベントを検索できます。

関連トピック

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

接続プロパティの設定

Java APIを使用したイベントの検索

Rights ManagementAPI(Java)を使用してイベントを検索します。

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

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

  2. Rights ManagementクライアントAPIオブジェクトの作成

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

  3. 検索するイベントの指定

    • DocumentSecurityClientオブジェクトのgetEventManagerメソッドを呼び出して、EventManagerオブジェクトを作成します。 このメソッドは、EventManagerオブジェクトを返します。
    • コンストラクターを呼び出して、EventSearchFilterオブジェクトを作成します。
    • EventSearchFilterオブジェクトのsetEventCodeメソッドを呼び出し、検索対象のイベントを表すEventManagerクラスに属する静的データメンバーを渡すことで、検索するイベントを指定します。 例えば、ポリシー作成イベントを検索するには、EventManager.POLICY_CREATE_EVENTを渡します。
    メモ

    EventSearchFilterオブジェクトメソッドを呼び出すことで、追加の検索条件を定義できます。 例えば、setUserNameメソッドを呼び出して、イベントに関連付けられたユーザーを指定します。

  4. イベントの検索

    EventManagerオブジェクトのsearchForEventsメソッドを呼び出し、イベント検索条件を定義するEventSearchFilterオブジェクトを渡すことで、イベントを検索します。 このメソッドは、Eventオブジェクトの配列を返します。

コード例

Rights Managementサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(SOAP):Java APIを使用したイベントの検索»

WebサービスAPIを使用したイベントの検索

Rights ManagementAPI（Webサービス）を使用してイベントを検索します。

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

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

    メモ

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

  2. Rights ManagementクライアントAPIオブジェクトの作成

    • デフォルトのコンストラクターを使用してDocumentSecurityServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してDocumentSecurityServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドDocumentSecurityServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドDocumentSecurityServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

  3. 検索するイベントの指定

    • EventSpecオブジェクトを作成するには、コンストラクタを使用します。
    • EventSpecオブジェクトのfirstTime.dateデータメンバーに、イベントが発生した日付範囲の開始を表すDataTimeインスタンスを設定して、イベントが発生した期間の開始を指定します。
    • 値trueをEventSpecオブジェクトのfirstTime.dateSpecifiedデータメンバーに割り当てます。
    • EventSpecオブジェクトのlastTime.dateデータメンバーに、イベントが発生した日付範囲の終了を表すDataTimeインスタンスを設定して、イベントが発生した期間の終了を指定します。
    • 値trueをEventSpecオブジェクトのlastTime.dateSpecifiedデータメンバーに割り当てます。
    • EventSpecオブジェクトのeventCodeデータメンバーに文字列値を割り当てて、検索するイベントを設定します。 次の表に、このプロパティに割り当てることができる数値を示します。

    イベントタイプ

    値

    ALL_EVENTS

    999

    USER_CHANGE_PASSWORD_EVENT

    1000

    USER_REGISTER_EVENT

    1001

    USER_PREREGISTER_EVENT

    1002

    USER_ACTIVATE_EVENT

    1003

    USER_DEACTIVATE_EVENT

    1004

    USER_AUTHENTICATE_EVENT

    1005年

    USER_AUTHENTICATE_DENY_EVENT

    1006

    USER_ACCOUNT_LOCK_EVENT

    1007

    USER_DELETE_EVENT

    1008

    USER_UPDATE_PROFILE_EVENT

    1009

    DOCUMENT_VIEW_EVENT

    2,000

    DOCUMENT_PRINT_LOW_EVENT

    2001年

    DOCUMENT_PRINT_HIGH_EVENT

    2002年

    DOCUMENT_SIGN_EVENT

    2003年

    DOCUMENT_ADD_ANNOTATION_EVENT

    2004年

    DOCUMENT_FORM_FILL_EVENT

    2005年

    DOCUMENT_CLOSE_EVENT

    2006年

    DOCUMENT_MODIFY_EVENT

    2007年

    DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT

    2008

    DOCUMENT_SWITCH_POLICY_EVENT

    2009年

    DOCUMENT_REVOKE_EVENT

    2010年

    $1

    2011年

    DOCUMENT_SECURE_EVENT

    2012年

    DOCUMENT_UNKNOWN_CLIENT_EVENT

    2013年

    DOCUMENT_CHANGE_REVOKE_URL_EVENT

    2014年

    POLICY_CHANGE_EVENT

    3000

    POLICY_ENABLE_EVENT

    3001

    POLICY_DISABLE_EVENT

    3002

    POLICY_CREATE_EVENT

    3003

    POLICY_DELETE_EVENT

    3004

    POLICY_CHANGE_OWNER_EVENT

    3005

    SERVER_CLIENT_SYNC_EVENT

    4000

    SERVER_SYNC_DIR_INFO_EVENT

    4001

    SERVER_SYNC_DIR_COMPLETE_EVENT

    4002

    SERVER_VERSION_MISMATCH_EVENT

    4003

    SERVER_CONFIG_CHANGE_EVENT

    4004

    SERVER_ENABLE_OFFLINE_ACCESS_EVENT

    4005

    ADMIN_ADD_EVENT

    5,000

    ADMIN_DELETE_EVENT

    5001

    ADMIN_EDIT_EVENT

    5002

    ADMIN_ACTIVATE_EVENT

    5003

    ADMIN_DEACTIVATE_EVENT

    5004

    ERROR_DIRECTORY_SERVICE_EVENT

    6000

    CREATED_POLICYSET_EVENT

    7000

    DELETED_POLICYSET_EVENT

    7001

    MODIFIED_POLICYSET_EVENT

    7002

  4. イベントの検索

    DocumentSecurityServiceClientオブジェクトのsearchForEventsメソッドを呼び出し、検索するイベントを表すEventSpecオブジェクトと検索結果の最大数を渡すことで、イベントを検索します。 このメソッドは、各要素がAuditSpecインスタンスであるMyArrayOf_xsd_anyTypeコレクションを返します。 AuditSpecインスタンスを使用して、イベントの発生時刻などの情報を取得できます。 AuditSpecインスタンスには、この情報を指定するtimestampデータメンバーが含まれます。

コード例

Rights Managementサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用したイベントの検索»
  • 「クイックスタート(SwaRef):WebサービスAPIを使用したイベントの検索»

関連トピック

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

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

Wordドキュメントへのポリシーの適用

Rights Managementサービスは、PDFドキュメントに加えて、Microsoft Wordドキュメント（DOCファイル）やその他のMicrosoft Officeファイル形式などの追加のドキュメント形式をサポートします。 例えば、Wordドキュメントを保護するために、Wordドキュメントにポリシーを適用できます。 Word文書にポリシーを適用すると、その文書へのアクセスを制限できます。 ドキュメントが既にポリシーで保護されている場合、ドキュメントにポリシーを適用することはできません。

ポリシーで保護されたWord文書を配布した後で、その使用を監視できます。 つまり、ドキュメントの使用方法と使用者を確認できます。 例えば、誰かがドキュメントを開いた日時を調べることができます。

メモ

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

手順の概要

Word文書にポリシーを適用するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. ポリシーが適用されるWordドキュメントを取得します。
  4. Wordドキュメントに既存のポリシーを適用します。
  5. ポリシーで保護されたWordドキュメントを保存します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成する必要があります。

Wordドキュメントの取得

ポリシーを適用するには、Wordドキュメントを取得する必要があります。 Wordドキュメントにポリシーを適用すると、そのドキュメントを使用する際にユーザーが制限されます。 例えば、オフライン時にドキュメントを開くことをポリシーで有効にしていない場合、ドキュメントを開くにはユーザーがオンラインである必要があります。

Wordドキュメントに既存のポリシーを適用する

Word文書にポリシーを適用するには、既存のポリシーを参照し、ポリシーが属するポリシーセットを指定する必要があります。 接続プロパティを設定するユーザーは、指定したポリシーにアクセスできる必要があります。 そうでない場合、例外が発生します。

Wordドキュメントを保存する

Document SecurityサービスによってWordドキュメントにポリシーが適用されたら、ポリシーで保護されたWordドキュメントをDOCファイルとして保存できます。

関連トピック

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

接続プロパティの設定

ドキュメントへのアクセスの取り消し

Java APIを使用してWordドキュメントにポリシーを適用します

Document Security API(Java)を使用してWordドキュメントにポリシーを適用します。

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

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して DocumentSecurityClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

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

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

  4. Wordドキュメントに既存のポリシーを適用します。

    • DocumentSecurityClientオブジェクトのgetDocumentManagerメソッドを呼び出して、DocumentManagerオブジェクトを作成します。

    • DocumentManagerオブジェクトのprotectDocumentメソッドを呼び出し、次の値を渡して、Wordドキュメントにポリシーを適用します。

      • ポリシーが適用されるWordドキュメントを含むcom.adobe.idp.Documentオブジェクト。
      • ドキュメントの名前を指定するstring値。
      • ポリシーが属するポリシーセットの名前を指定するstring値です。 nullの値を指定して、MyPoliciesポリシーセットを使用することができます。
      • ポリシー名を指定するstring値です。
      • ドキュメントのパブリッシャーであるユーザーのユーザーマネージャードメインの名前を表すstring値です。 このパラメーター値はオプションで、nullにできます（このパラメーターがnullの場合、次のパラメーター値はnullにする必要があります）。
      • ドキュメントのパブリッシャーであるユーザーマネージャーユーザーの正規名の名前を表すstring値です。 このパラメーターの値はオプションで、nullにできます（このパラメーターがnullの場合、前のパラメーターの値はnullにする必要があります）。
      • MS Officeテンプレートの選択に使用されるロケールを表すcom.adobe.livecycle.rightsmanagement.Locale。 このパラメーター値はオプションで、nullを指定できます。

      protectDocumentメソッドは、ポリシーで保護されたWordドキュメントを含むRMSecureDocumentResultオブジェクトを返します。

  5. Wordドキュメントを保存します。

    • RMSecureDocumentResultオブジェクトのgetProtectedDocメソッドを呼び出して、ポリシーで保護されたWordドキュメントを取得します。 このメソッドはcom.adobe.idp.Documentオブジェクトを返します。
    • java.io.Fileオブジェクトを作成し、ファイル拡張子がDOCであることを確認します。
    • com.adobe.idp.DocumentオブジェクトのcopyToFileメソッドを呼び出して、Documentオブジェクトの内容をファイルにコピーします（getProtectedDocメソッドで返されたDocumentオブジェクトを使用するようにしてください）。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（SOAPモード）:Java APIを使用したWordドキュメントへのポリシーの適用»

WebサービスAPIを使用してWordドキュメントにポリシーを適用する

Document Security API（Webサービス）を使用して、Wordドキュメントにポリシーを適用します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトを作成します。

    • デフォルトのコンストラクターを使用してDocumentSecurityServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してDocumentSecurityServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/DocumentSecurityService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドDocumentSecurityServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドDocumentSecurityServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

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

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

  4. Wordドキュメントに既存のポリシーを適用します。

    DocumentSecurityServiceClientオブジェクトのprotectDocumentメソッドを呼び出し、次の値を渡して、Wordドキュメントにポリシーを適用します。

    • ポリシーが適用されるWordドキュメントを含むBLOBオブジェクト。
    • ドキュメントの名前を指定するstring値。
    • ポリシーが属するポリシーセットの名前を指定するstring値です。 nullの値を指定して、MyPoliciesポリシーセットを使用することができます。
    • ポリシー名を指定するstring値です。
    • ドキュメントのパブリッシャーであるユーザーのユーザーマネージャードメインの名前を表すstring値です。 このパラメーター値はオプションで、nullにできます（このパラメーターがnullの場合、次のパラメーター値はnullにする必要があります）。
    • ドキュメントのパブリッシャーであるユーザーマネージャーユーザーの正規名の名前を表すstring値です。 このパラメーター値はオプションで、nullにできます（このパラメーターがnullの場合、前のパラメーター値はnullにする必要があります）。
    • ロケール値を指定するRMLocale値（例：RMLocale.en）。
    • ポリシー識別子の値を格納するために使用される文字列出力パラメーターです。
    • ポリシーで保護された識別子の値を保存するために使用される文字列出力パラメーターです。
    • MIMEタイプの保存に使用する文字列出力パラメーター（例：application/doc）。

    protectDocumentメソッドは、ポリシーで保護されたWordドキュメントを含むBLOBオブジェクトを返します。

  5. Wordドキュメントを保存します。

    • コンストラクターを呼び出し、ポリシーで保護されたWordドキュメントのファイルの場所を表す文字列値を渡すことで、System.IO.FileStreamオブジェクトを作成します。
    • protectDocumentメソッドで返されたBLOBオブジェクトのデータ内容を格納するバイト配列を作成します。 BLOBオブジェクトのMTOMデータメンバーの値を取得して、バイト配列を設定します。
    • コンストラクターを呼び出し、System.IO.FileStreamオブジェクトを渡して、System.IO.BinaryWriterオブジェクトを作成します。
    • System.IO.BinaryWriterオブジェクトのWriteメソッドを呼び出し、バイト配列を渡すことにより、バイト配列の内容をWordファイルに書き込みます。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPI「 」を使用したWordドキュメントへのポリシーの適用

Wordドキュメントからポリシーを削除する

ポリシーで保護されたWordドキュメントからポリシーを削除して、ドキュメントからセキュリティを削除できます。 つまり、ドキュメントをポリシーで保護したくない場合です。 ポリシーで保護されたWordドキュメントを新しいポリシーで更新する場合は、ポリシーを削除して更新したポリシーを追加する代わりに、ポリシーを切り替える方が効率的です。

メモ

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

手順の概要

ポリシーで保護されたWordドキュメントからポリシーを削除するには、次の手順を実行します。

  1. プロジェクトファイルを含める
  2. Document SecurityクライアントAPIオブジェクトを作成します。
  3. ポリシーで保護されたWordドキュメントを取得します。
  4. Wordドキュメントからポリシーを削除します。
  5. 保護されていないWordドキュメントを保存します。

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

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

Document SecurityクライアントAPIオブジェクトの作成

Document Securityサービスの操作をプログラムで実行する前に、Document Securityサービスのクライアントオブジェクトを作成します。

ポリシーで保護されたWordドキュメントの取得

ポリシーを削除するには、ポリシーで保護されたWordドキュメントを取得する必要があります。 ポリシーで保護されていないWord文書からポリシーを削除しようとすると、例外が発生します。

Wordドキュメントからポリシーを削除する

接続設定で管理者が指定されている場合は、ポリシーで保護されたWordドキュメントからポリシーを削除できます。 そうでない場合は、ドキュメントを保護するために使用されるポリシーに、Wordドキュメントからポリシーを削除するためのSWITCH_POLICY権限が含まれている必要があります。 また、AEM Forms接続設定で指定したユーザーにも、その権限が必要です。 それ以外の場合は、例外がスローされます。

保護されていないWord文書を保存する

Document SecurityサービスがWordドキュメントからポリシーを削除した後、保護されていないWordドキュメントをDOCファイルとして保存できます。

関連トピック

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

接続プロパティの設定

Wordドキュメントへのポリシーの適用

Java APIを使用してWordドキュメントからポリシーを削除する

Document Security API(Java)を使用して、ポリシーで保護されたWordドキュメントからポリシーを削除します。

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

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

  2. Document SecurityクライアントAPIオブジェクトの作成

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して RightsManagementClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. ポリシーで保護されたWordドキュメントの取得

    • コンストラクタを使用し、Wordドキュメントの場所を指定する文字列値を渡すことで、ポリシーで保護されたWordドキュメントを表すjava.io.FileInputStreamオブジェクトを作成します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

  4. Wordドキュメントからポリシーを削除する

    • RightsManagementClientオブジェクトのgetDocumentManagerメソッドを呼び出して、DocumentManagerオブジェクトを作成します。
    • DocumentManagerオブジェクトのremoveSecurityメソッドを呼び出し、ポリシーで保護されたWordドキュメントを含むcom.adobe.idp.Documentオブジェクトを渡すことで、Wordドキュメントからポリシーを削除します。 このメソッドは、保護されていないWordドキュメントを含むcom.adobe.idp.Documentオブジェクトを返します。

  5. 保護されていないWord文書を保存する

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

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート（SOAPモード）:Java API「 」を使用したWordドキュメントからのポリシーの削除

WebサービスAPIを使用してWordドキュメントからポリシーを削除する

Document Security API（Webサービス）を使用して、ポリシーで保護されたWordドキュメントからポリシーを削除します。

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

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

    メモ

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

  2. Document SecurityクライアントAPIオブジェクトの作成

    • デフォルトのコンストラクターを使用してRightsManagementServiceClientオブジェクトを作成します。

    • System.ServiceModel.EndpointAddressコンストラクターを使用してRightsManagementServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに渡す文字列値（例：http://localhost:8080/soap/services/RightsManagementService?WSDL）を渡します。 lc_version属性を使用する必要はありません。 この属性は、サービス参照を作成する際に使用されます)。

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

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

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

      • フィールドRightsManagementServiceClient.ClientCredentials.UserName.UserNameにAEM formsユーザー名を割り当てます。
      • 対応するパスワード値をフィールドRightsManagementServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
      • フィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに定数値HttpClientCredentialType.Basicを割り当てます。

    • フィールドBasicHttpBindingSecurity.Security.Modeに定数値BasicHttpSecurityMode.TransportCredentialOnlyを割り当てます。

  3. ポリシーで保護されたWordドキュメントの取得

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

  4. Wordドキュメントからポリシーを削除する

    RightsManagementServiceClientオブジェクトのremovePolicySecurityメソッドを呼び出し、ポリシーで保護されたWordドキュメントを含むBLOBオブジェクトを渡すことで、Wordドキュメントからポリシーを削除します。 このメソッドは、保護されていないWordドキュメントを含むBLOBオブジェクトを返します。

  5. 保護されていないWord文書を保存する

    • コンストラクターを呼び出し、保護されていないWordドキュメントのファイルの場所を表す文字列値を渡して、System.IO.FileStreamオブジェクトを作成します。
    • removePolicySecurityメソッドで返されたBLOBオブジェクトのデータ内容を格納するバイト配列を作成します。 BLOBオブジェクトのMTOMフィールドの値を取得して、バイト配列を設定します。
    • コンストラクターを呼び出し、System.IO.FileStreamオブジェクトを渡して、System.IO.BinaryWriterオブジェクトを作成します。

コード例

Document Securityサービスを使用するコード例については、次のクイックスタートを参照してください。

  • 「クイックスタート(MTOM):WebサービスAPIを使用したWordドキュメントからのポリシーの削除"

関連トピック

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

このページ