ドキュメントのデジタル署名と認証

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

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

Signature クライアントの作成

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

署名フィールドが追加された PDF ドキュメントを取得する

• 署名フィールドが追加された PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成するには、コンストラクタを使用して、PDF ドキュメントの場所を指定する文字列値を渡してください。
• com.adobe.idp.Document オブジェクトを作成するには、コンストラクタを使用して、java.io.FileInputStream オブジェクトを渡します。

署名フィールドを追加する

• コンストラクタを使用して、署名フィールドの場所を指定する PositionRectangle オブジェクトを作成します。コンストラクタ内で、座標値を指定します。

• 必要に応じて、デジタル署名が署名フィールドに適用された際にロックするフィールドを指定する FieldMDPOptions オブジェクトを作成します。

• PDF ドキュメントに署名フィールドを追加するには、SignatureServiceClient オブジェクトの addSignatureField メソッドを呼び出して、次の値を渡します。

  • com.adobe.idp です。署名フィールドを追加する PDF ドキュメントを表す Document オブジェクトです。
  • 署名フィールドの名前を指定する文字列値です。
  • 署名フィールドを追加するページ番号を表す java.lang.Integer 値です。
  • 署名フィールドの場所を指定する PositionRectangle オブジェクトです。
  • デジタル署名が署名フィールドに適用された後にロックされる PDF ドキュメント内のフィールドを指定する FieldMDPOptions オブジェクトです。このパラメータ値はオプションで、 null を渡すことができます。

• 様々な実行時の値を指定する PDFSeedValueOptions オブジェクトです。このパラメータ値はオプションで、 null を渡すことができます。

  addSignatureField メソッドは com.adobe.idp を返します。署名フィールドを含む PDF ドキュメントを表すDocumentオブジェクトです。

メモ

SignatureServiceClient オブジェクトの addInvisibleSignatureField メソッドを呼び出して、非表示の署名フィールドを追加します。

PDFドキュメントを PDF ファイルとして保存する

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

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

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1 を使用するようにします。

メモ

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

Signature クライアントの作成

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

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

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

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

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

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

署名フィールドが追加された PDF ドキュメントを取得する

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

署名フィールドを追加する

PDF ドキュメントに署名フィールドを追加するには、SignatureServiceClient オブジェクトの addSignatureField メソッドを呼び出して、次の値を渡します。

• 署名フィールドが追加された PDF ドキュメントを表す BLOB オブジェクトです。
• 署名フィールド名を指定する文字列値です。
• 署名フィールドを追加するページ番号を表す整数値です。
• 署名フィールドの場所を指定する PositionRect オブジェクトです。
• デジタル署名が署名フィールドに適用された後にロックされる PDF ドキュメント内のフィールドを指定する FieldMDPOptions オブジェクトです。このパラメータ値はオプションで、 null を渡すことができます。
• 様々な実行時の値を指定する PDFSeedValueOptions オブジェクトです。このパラメータ値はオプションで、nullを渡すことができます。

addSignatureField メソッドは、署名フィールドを含む PDF ドキュメントを表す BLOB オブジェクトを返します。

PDFドキュメントを PDF ファイルとして保存する

• System.IO.FileStream オブジェクトを作成するには、コンストラクターを呼び出して、署名フィールドを含む PDF ドキュメントのファイルの場所を表す文字列値およびファイルを開くモードを渡します。
• addSignatureField メソッドによって返された BLOB オブジェクトのコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの binaryData データメンバーの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。
• System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出してバイト配列を渡すことにより、バイト配列の内容を PDF ファイルに書き込みます。

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

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1 を使用するようにします。

メモ

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

Signature クライアントの作成

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

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

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

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

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

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

署名フィールドを含む PDF ドキュメントを取得する

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

署名フィールド名の取得

• 署名フィールド名を取得するには、SignatureServiceClient オブジェクトの getSignatureFieldList メソッドを呼び出して、署名フィールドを含む PDF ドキュメントを含む BLOB オブジェクトを渡します。このメソッドは、各要素に PDFSignatureField オブジェクトを含む MyArrayOfPDFSignatureField コレクションオブジェクトを返します。
• MyArrayOfPDFSignatureField オブジェクトを繰り返して、署名フィールド名があるかどうかを確認します。PDF ドキュメントの各署名フィールドに対して、PDFSignatureField オブジェクトを取得できます。署名フィールドの名前を取得するには、PDFSignatureField オブジェクトの getName メソッドを呼び出します。このメソッドは、署名フィールド名を指定する文字列値を返します。

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

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

Signature クライアントの作成

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

変更する署名フィールドを含む PDF ドキュメントを取得

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

ディクショナリの値を設定

• コンストラクタを使用して PDFSignatureFieldProperties オブジェクトを作成します。PDFSignatureFieldProperties オブジェクトは、署名フィールドロックディクショナリとシード値ディクショナリ情報を格納します。
• コンストラクタを使用して PDFSeedValueOptionSpec オブジェクトを作成します。このオブジェクトを使用すると、シード値ディクショナリの値を設定できます。
• PDF ドキュメントへの変更を許可しない場合は、PDFSeedValueOptionSpec オブジェクトの setMdpValue メソッドを呼び出し、MDPPermissions.NoChanges 列挙値を渡します。
• コンストラクタを使用して FieldMDPOptionSpec オブジェクトを作成します。このオブジェクトを使用すると、署名フィールドのロックディクショナリ値を設定できます。
• PDFドキュメント内のすべてのフィールドをロックするには、FieldMDPOptionSpec オブジェクトの setMdpValue メソッドを呼び出して、FieldMDPAction.ALL 列挙値を渡します。
• シード値のディクショナリ情報を設定するには、PDFSignatureFieldProperties オブジェクトの setSeedValue メソッドを呼び出して、PDFSeedValueOptionSpec オブジェクトを渡します。
• 署名フィールドのロックディクショナリ情報を設定するには、PDFSignatureFieldPropertiesオブジェクトの setFieldMDP メソッドを呼び出して、FieldMDPOptionSpecオブジェクトを渡します。

NOTE

設定可能なすべてのシード値ディクショナリの値を確認するには、 PDFSeedValueOptionSpec クラスリファレンスを参照してください。（AEM Forms API リファレンスを参照してください）。

署名フィールドの変更

署名フィールドを変更するには、SignatureServiceClient オブジェクトの modifySignatureField メソッドを呼び出して、次の値を渡します。

• 変更する署名フィールドを含む PDFドキュメントを格納する com.adobe.idp.Document オブジェクト
• 署名フィールドの名前を指定する文字列値
• 署名フィールドロックディクショナリとシード値ディクショナリ情報を格納する PDFSignatureFieldProperties オブジェクト

modifySignatureField メソッドは、変更された署名フィールドを含む PDF ドキュメントを保存する com.adobe.idp.Document オブジェクトです。

PDFドキュメントを PDF ファイルとして保存する

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

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

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1 を使用するようにします。

NOTE

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

Signature クライアントの作成

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

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

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

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

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

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

変更する署名フィールドを含む PDF ドキュメントを取得

• コンストラクタを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、変更する署名フィールドを含む PDF ドキュメントを保存するために使用されます。
• System.IO.FileStream オブジェクトを作成するには、コンストラクタを呼び出して、PDF ドキュメントのファイル場所を示す文字列値およびファイルを開くモードを渡します。
• System.IO.FileStream オブジェクトのコンテンツを保存するバイト配列を作成します。 バイト配列のサイズは、System.IO.FileStream オブジェクトの Length プロパティを取得することで決定できます。
• System.IO.FileStream オブジェクトの Read メソッドを呼び出し、バイト配列、開始位置、および読み取るストリーム長を渡して、バイト配列にストリームデータを入力します。
• BLOB オブジェクトを入力するには、MTOM プロパティに、バイト配列のコンテンツを割り当てます。

ディクショナリの値を設定

• コンストラクタを使用して PDFSignatureFieldProperties オブジェクトを作成します。このオブジェクトは、署名フィールドロックディクショナリとシード値ディクショナリ情報を格納します。
• コンストラクタを使用して PDFSeedValueOptionSpec オブジェクトを作成します。このオブジェクトを使用すると、シード値ディクショナリの値を設定できます。
• PDF ドキュメントに変更を許可しないようにするには、MDPPermissions.NoChanges 列挙値を PDFSeedValueOptionSpec オブジェクトの mdpValue データメンバーに割り当てます。
• コンストラクタを使用して FieldMDPOptionSpec オブジェクトを作成します。このオブジェクトを使用すると、署名フィールドのロックディクショナリ値を設定できます。
• PDF ドキュメント内のすべてのフィールドをロックするには、FieldMDPAction.ALL 列挙値を FieldMDPOptionSpec オブジェクトの mdpValue データメンバーに割り当てます。
• シード値ディクショナリ情報を設定するには、PDFSeedValueOptionSpec オブジェクトを PDFSignatureFieldProperties オブジェクトの seedValue データメンバーに割り当てます。
• 署名フィールドロックディクショナリ情報を設定するには、FieldMDPOptionSpec オブジェクトを PDFSignatureFieldProperties オブジェクトの fieldMDP データメンバーに割り当てます。

NOTE

設定可能なすべてのシード値ディクショナリの値を表示するには、PDFSeedValueOptionSpec クラスレファレンスを参照してください。（AEM Forms API リファレンス を参照してください）。

署名フィールドの変更

署名フィールドを変更するには、SignatureServiceClient オブジェクトの modifySignatureField メソッドを呼び出して、次の値を渡します。

• 変更する署名フィールドを含む PDFドキュメントを格納する BLOB オブジェクト
• 署名フィールドの名前を指定する文字列値
• 署名フィールドロックディクショナリとシード値ディクショナリ情報を格納する PDFSignatureFieldProperties オブジェクト

modifySignatureField メソッドは、変更された署名フィールドを含む PDF ドキュメントを保存する BLOB オブジェクトです。

PDFドキュメントを PDF ファイルとして保存する

• コンストラクターを呼び出し、署名フィールドを含む PDF ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡して、System.IO.FileStream オブジェクトを作成します。
• addSignatureField メソッドが返す BLOB オブジェクトのコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの MTOM データメンバーの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。
• System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出してバイト配列を渡すことにより、バイト配列の内容を PDF ファイルに書き込みます。

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

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

Signatures クライアントの作成

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

署名する PDF ドキュメントを取得

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

PDF ドキュメントに署名

PDF ドキュメントに署名するには、SignatureServiceClient オブジェクトの sign メソッドを呼び出し、次の値を渡します。

• 署名する PDF ドキュメントを表す com.adobe.idp.Document オブジェクト。
• デジタル署名を含む署名フィールドの名前を表す文字列値です。
• PDFドキュメントにデジタル署名するために使用される資格情報を表す Credential オブジェクト。Credential オブジェクトの静的な getInstance メソッドを呼び出し、セキュリティ認証情報に対応するエイリアス値を指定する文字列値を渡すことによって、Credential オブジェクトを作成します。
• PDF ドキュメントのダイジェストに使用するハッシュアルゴリズムを表す静的データメンバーを指定する HashAlgorithm オブジェクト。例えば、SHA1 アルゴリズムを使用するには HashAlgorithm.SHA1 を指定できます。
• PDF ドキュメントがデジタル署名された理由を表す文字列値です。
• 署名者の連絡先情報を表す文字列値です。
• デジタル署名のアピアランスを制御する PDFSignatureAppearanceOptions オブジェクト。 例えば、このオブジェクトを使用して、デジタル署名にカスタムロゴを追加できます。
• 署名者の証明書に対して失効確認を実行するかどうかを指定する java.lang.Boolean オブジェクト。
• オンライン証明書ステータスプロトコル（OCSP）サポートの環境設定を格納する OCSPOptionSpec オブジェクト。 失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。
• 証明書失効リスト (CRL) の環境設定を格納する CRLPreferences オブジェクト。失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。
• タイムスタンププロバイダー（TSP）がサポートする環境設定を格納する TSPPreferences オブジェクト。このパラメーターはオプションで、null にすることができます。詳しくは、AEM Forms API リファレンスを参照してください。

sign メソッドは、署名済み PDF ドキュメントを表す com.adobe.idp.Document オブジェクトを返します。

署名済み PDF ドキュメントを保存

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

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

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1 を使用するようにします。

NOTE

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

Signatures クライアントの作成

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

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

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

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

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

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

署名する PDF ドキュメントを取得

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

PDF ドキュメントに署名

PDF ドキュメントに署名するには、SignatureServiceClient オブジェクトの sign メソッドを呼び出し、次の値を渡します。

• 署名する PDF ドキュメントを表す BLOB オブジェクト。
• デジタル署名を含む署名フィールドの名前を表す文字列値です。
• PDFドキュメントにデジタル署名するために使用される資格情報を表す Credential オブジェクト。Credential オブジェクトを作成するには、コンストラクターを使用し、Credential オブジェクトの alias プロパティに値を割り当ててエイリアスを指定します。
• PDF ドキュメントのダイジェストに使用するハッシュアルゴリズムを表す静的データメンバーを指定する HashAlgorithm オブジェクト。例えば、HashAlgorithm.SHA1 を指定して SHA1 アルゴリズムを使用することができます。
• ハッシュアルゴリズムを使用するかどうかを指定するブール値です。
• PDF ドキュメントがデジタル署名された理由を表す文字列値です。
• 署名者の場所を表す文字列値です。
• 署名者の連絡先情報を表す文字列値です。
• デジタル署名のアピアランスを制御する PDFSignatureAppearanceOptions オブジェクト。 例えば、このオブジェクトを使用して、デジタル署名にカスタムロゴを追加できます。
• 署名者の証明書に対して失効確認を実行するかどうかを指定する System.Boolean オブジェクト。失効確認を実行すると、署名に埋め込まれます。デフォルトは、false です。
• オンライン証明書ステータスプロトコル（OCSP）サポートの環境設定を格納する OCSPOptionSpec オブジェクト。失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。このオブジェクトについて詳しくは、AEM Forms API リファレンスを参照してください。
• 証明書失効リスト（CRL）の環境設定を保存する CRLPreferences オブジェクト。失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。
• タイムスタンププロバイダー（TSP）がサポートする環境設定を保存する TSPPreferences オブジェクト。このパラメーターはオプションで、null を設定することもできます。

この sign メソッドは、署名済み PDF ドキュメントを表す BLOB オブジェクトを返します。

署名済み PDF ドキュメントを保存

• コンストラクタを呼び出して System.IO.FileStream オブジェクトを作成します。署名済み PDF ドキュメントのファイルの場所と、ファイルを開くモードを表す文字列値を渡します。
• sign メソッドが返した BLOB オブジェクトの内容を格納するバイト配列を作成します。BLOB オブジェクトの MTOM データメンバーの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。
• System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出してバイト配列を渡すことにより、バイト配列の内容を PDF ファイルに書き込みます。

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

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

Forms および Signatures クライアントを作成

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

Forms サービスを使用してインタラクティブフォームを取得

• コンストラクターを使用して、Forms サービスに渡す PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。PDF ドキュメントの場所を指定する文字列値を渡します。

• コンストラクターを使用して java.io.FileInputStream オブジェクトを渡すことにより、com.adobe.idp.Document オブジェクトを作成します。

• コンストラクターを使用して、Forms サービスに渡すフォームデータを含む XML ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。XML ファイルの場所を指定する文字列値を渡します。

• コンストラクターを使用して java.io.FileInputStream オブジェクトを渡すことにより、com.adobe.idp.Document オブジェクトを作成します。

• 実行時オプションの設定に使用する PDFFormRenderSpec オブジェクトを作成します。PDFFormRenderSpec オブジェクトの setGenerateServerAppearance メソッドを呼び出し、true を渡します。

• FormsServiceClient オブジェクトの renderPDFForm2 メソッドを呼び出して、以下の値を渡します。

  • レンダリングする PDF フォームを含む com.adobe.idp.Document オブジェクト。
  • フォームに結合するデータを含む com.adobe.idp.Document オブジェクト。
  • 実行時オプションを格納する PDFFormRenderSpec オブジェクト。
  • Forms サービスで必要な URI 値を格納する URLSpec オブジェクト。このパラメーター値として null を指定できます。
  • 添付ファイルを格納する java.util.HashMap オブジェクト。これはオプションのパラメーターであり、フォームにファイルを添付しない場合に null を指定できます。

  renderPDFForm2 メソッドは、 フォームデータストリームを含む FormsResult オブジェクトを返します。

• FormsResult オブジェクトの getOutputContent メソッドを呼び出して PDF フォームを取得します。このメソッドは、インタラクティブフォームを表す com.adobe.idp.Document オブジェクトを返します。

インタラクティブフォームに署名する

PDF ドキュメントに署名するには、SignatureServiceClient オブジェクトの sign メソッドを呼び出し、次の値を渡します。

• 署名する PDF ドキュメントを表す com.adobe.idp.Document オブジェクト。このオブジェクトが、Forms サービスから取得された com.adobe.idp.Document オブジェクトであることを確認します。
• 署名された署名フィールドの名前を表す文字列値です。
• PDF ドキュメントへの電子署名に使用する資格情報を表す Credential オブジェクト。Credential オブジェクトの静的 getInstance メソッドを呼び出すことによって Credential オブジェクトを作成します。セキュリティ資格情報に対応するエイリアス値を指定する文字列値を渡します。
• PDF ドキュメントのダイジェストに使用するハッシュアルゴリズムを表す静的データメンバーを指定する HashAlgorithm オブジェクト。例えば、SHA1 アルゴリズムを使用するには HashAlgorithm.SHA1 を指定できます。
• PDF ドキュメントがデジタル署名された理由を表す文字列値です。
• 署名者の連絡先情報を表す文字列値です。
• デジタル署名のアピアランスを制御する PDFSignatureAppearanceOptions オブジェクト。 例えば、このオブジェクトを使用して、デジタル署名にカスタムロゴを追加できます。
• 署名者の証明書に対して失効確認を実行するかどうかを指定する java.lang.Boolean オブジェクト。
• オンライン証明書ステータスプロトコル（OCSP）サポートの環境設定を格納する OCSPPreferences オブジェクト。 失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。
• 証明書失効リスト (CRL) の環境設定を格納する CRLPreferences オブジェクト。失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。
• タイムスタンププロバイダー（TSP）がサポートする環境設定を保存する TSPPreferences オブジェクト。このパラメーターはオプションで、null を設定することもできます。

この sign メソッドは、署名済み PDF ドキュメントを表す com.adobe.idp.Document オブジェクトを返します。

署名済み PDF ドキュメントを保存

• java.io.File オブジェクトを作成し、ファイル拡張子が .pdf であることを確認します。
• com.adobe.idp.Document オブジェクトの copyToFile メソッドを呼び出して java.io.File を渡し、Document オブジェクトのコンテンツをファイルにコピーします。必ず sign メソッドが返した com.adobe.idp.Document オブジェクトを使用します 。

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

MTOM を使用する Microsoft .NET プロジェクトを作成します。このクライアントアプリケーションは 2 つの AEM Forms サービスを呼び出すので、2 つのサービス参照を作成します。Signature サービスに関連付けられたサービス参照に、次の WSDL 定義を使用します：http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1。

Forms サービスに関連付けられたサービス参照に、次の WSDL 定義を使用します：http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1。

BLOB データタイプは、両方のサービス参照に共通であるため、BLOB データタイプを使用する場合は完全に修飾してください。対応する web サービスのクイックスタートで、すべての BLOB インスタンスは完全に修飾されています。

NOTE

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

Forms および Signatures クライアントを作成

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

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

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

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

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

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

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

NOTE

Forms サービスクライアントに対して、これらの手順を繰り返します。

Forms サービスを使用してインタラクティブフォームを取得

• コンストラクターを使用して BLOB オブジェクトを作成します。この BLOB オブジェクトは、署名された PDF ドキュメントを保存するために使用されます。

• コンストラクタを呼び出し、署名する PDF ドキュメントのファイルの場所と、ファイルを開くモードを表す文字列値を渡すことによって、System.IO.FileStream オブジェクトを作成します。

• System.IO.FileStream オブジェクトのコンテンツを格納するバイト配列を作成します。バイト配列のサイズは、System.IO.FileStream オブジェクトの Length プロパティを取得することで決定できます。

• System.IO.FileStream オブジェクトの Read メソッドを呼び出し、バイト配列、開始位置、および読み取るストリーム長を渡して、バイト配列にストリームデータを入力します。

• MTOM プロパティにバイト配列のコンテンツを割り当てて、BLOB オブジェクトを設定します。

• コンストラクターを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、フォームデータの格納に使用されます。

• コンストラクターを呼び出し、フォームデータを含む XML ファイルのファイルの場所とファイルを開くモードを表す文字列値を渡すことにより、System.IO.FileStream オブジェクトを作成します。

• System.IO.FileStream オブジェクトのコンテンツを格納するバイト配列を作成します。バイト配列のサイズは、System.IO.FileStream オブジェクトの Length プロパティを取得することで決定できます。

• System.IO.FileStream オブジェクトの Read メソッドを呼び出し、バイト配列、開始位置、および読み取るストリーム長を渡して、バイト配列にストリームデータを入力します。

• MTOM プロパティにバイト配列のコンテンツを割り当てて、BLOB オブジェクトを設定します。

• 実行時オプションの設定に使用される PDFFormRenderSpec オブジェクトを作成します。値 true を PDFFormRenderSpec オブジェクトの generateServerAppearance フィールドに割り当てます。

• FormsServiceClient オブジェクトの renderPDFForm2 メソッドを呼び出して、以下の値を渡します。

  • レンダリングする PDF フォームを含む BLOB オブジェクト。
  • フォームに結合するデータを含む BLOB オブジェクト。
  • 実行時オプションを格納する PDFFormRenderSpec オブジェクト。
  • Forms サービスで必要な URI 値を格納する URLSpec オブジェクト。このパラメーター値として null を指定できます。
  • 添付ファイルを格納する java.util.HashMap オブジェクト。これはオプションのパラメーターで、フォームにファイルを添付しない場合、null を指定できます。
  • フォームにページ数を保存するために使用される長い出力パラメーターです。
  • ロケール値に使用される文字列出力パラメーターです。
  • インタラクティブフォームの保存に使用される出力パラメーターの FormResult 値です。

• FormsResult オブジェクトの outputContent フィールドを呼び出して、PDF フォームを取得します。このフィールドは、インタラクティブフォームを表す BLOB オブジェクトを保存します。

インタラクティブフォームに署名する

PDF ドキュメントに署名するには、SignatureServiceClient オブジェクトの sign メソッドを呼び出し、次の値を渡します。

• 署名する PDF ドキュメントを表す BLOB オブジェクトです。Forms サービスによって返された BLOB インスタンスを使用します。
• 署名された署名フィールドの名前を表す文字列値です。
• PDF ドキュメントへの電子署名に使用する資格情報を表す Credential オブジェクト。Credential オブジェクトを作成するには、コンストラクターを使用し、Credential オブジェクトの alias プロパティに値を割り当ててエイリアスを指定します。
• PDF ドキュメントのダイジェストに使用するハッシュアルゴリズムを表す静的データメンバーを指定する HashAlgorithm オブジェクト。例えば、HashAlgorithm.SHA1 を指定して SHA1 アルゴリズムを使用することができます。
• ハッシュアルゴリズムを使用するかどうかを指定するブール値です。
• PDF ドキュメントがデジタル署名された理由を表す文字列値です。
• 署名者の場所を表す文字列値です。
• 署名者の連絡先情報を表す文字列値です。
• デジタル署名のアピアランスを制御する PDFSignatureAppearanceOptions オブジェクト。 例えば、このオブジェクトを使用して、デジタル署名にカスタムロゴを追加できます。
• 署名者の証明書に対して失効確認を実行するかどうかを指定する System.Boolean オブジェクト。失効確認を実行すると、署名に埋め込まれます。デフォルトは、false です。
• オンライン証明書ステータスプロトコル（OCSP）サポートの環境設定を格納する OCSPPreferences オブジェクト。失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。このオブジェクトについて詳しくは、AEM Forms API リファレンスを参照してください。
• 証明書失効リスト（CRL）の環境設定を保存する CRLPreferences オブジェクト。失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。
• タイムスタンププロバイダー（TSP）がサポートする環境設定を保存する TSPPreferences オブジェクト。このパラメーターはオプションで、null を設定することもできます。

この sign メソッドは、署名済み PDF ドキュメントを表す BLOB オブジェクトを返します。

署名済み PDF ドキュメントを保存

• コンストラクタを呼び出して System.IO.FileStream オブジェクトを作成します。署名済み PDF ドキュメントのファイルの場所と、ファイルを開くモードを表す文字列値を渡します。
• sign メソッドが返した BLOB オブジェクトの内容を格納するバイト配列を作成します。BLOB オブジェクトの MTOM データメンバーの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。
• System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出してバイト配列を渡すことにより、バイト配列の内容を PDF ファイルに書き込みます。

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

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

Signature クライアントの作成

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

認証する PDF ドキュメントを取得

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

PDF ドキュメントの認証

SignatureServiceClient オブジェクトの certify メソッドを呼び出し、次の値を渡し、PDF ドキュメントを認証します。

• 認証する PDF ドキュメントを表す com.adobe.idp.Document オブジェクト
• 署名を含む署名フィールドの名前を表す文字列値。
• PDF ドキュメントの認証に使用する資格情報を表す Credential オブジェクト。Credential オブジェクトの静的な getInstance メソッドを呼び出し、セキュリティ認証情報に対応するエイリアス値を指定する文字列値を渡して、Credential オブジェクトを作成します。
• PDF ドキュメントのダイジェストに使用するハッシュアルゴリズムを表すスタティックデータメンバーを指定する HashAlgorithm オブジェクトです。例えば、HashAlgorithm.SHA1 を指定して、SHA1 アルゴリズムを使用できます。
• PDF ドキュメントが認証された理由を表す文字列値。
• 署名者の連絡先情報を表す文字列値です。
• 署名を無効にする PDF ドキュメントで実行できるアクションを指定する MDPPermissions オブジェクトです。
• 認証済みの署名の外観を制御する PDFSignatureAppearanceOptions オブジェクト。必要に応じて setShowDate などのメソッドを呼び出し、署名の外観を変更します。
• 署名を無効にするアクションの説明を提供する文字列値です。
• 署名者の証明書に対して失効確認を実行するかどうかを指定する java.lang.Boolean オブジェクトです。失効確認を実行すると、署名に埋め込まれます。デフォルトは、false です。
• 認証される署名フィールドをロックするかどうかを指定する java.lang.Boolean オブジェクトです。署名フィールドをロックすると、このフィールドは読み取り専用としてマークされ、プロパティは変更できません。また、必要な権限を持たないユーザーはこのフィールドをクリアできません。デフォルトは、false です。
• オンライン証明書ステータスプロトコル（OCSP）サポートの環境設定を格納する OCSPPreferences オブジェクト。失効確認を実行しない場合、このパラメーターは使用されず、null を指定できます。このオブジェクトについて詳しくは、AEM Forms API リファレンスを参照してください。
• 証明書失効リスト（CRL）の環境設定を保存する CRLPreferences オブジェクトです。失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。
• タイムスタンププロバイダー（TSP）がサポートする環境設定を格納する TSPPreferences オブジェクト。例えば、TSPPreferences オブジェクトを作成したら、TSPPreferences オブジェクトの setTspServerURL メソッドを呼び出して、TSP サーバーの URL を設定できます。このパラメーターはオプションで、null にすることができます。詳しくは、AEM Forms のサービスリファレンスを参照してください。

certify メソッドは、認証済み PDF ドキュメントを表す com.adobe.idp.Document オブジェクトを返します。

認証済み PDF ドキュメントを PDF ファイルとして保存

• java.io.File オブジェクトを作成し、ファイル拡張子が .pdf であることを確認します。
• com.adobe.idp.Document オブジェクトの copyToFile メソッドを呼び出して、com.adobe.idp.Document オブジェクトの内容をファイルにコピーします。

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

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1 を使用するようにします。

NOTE

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

Signature クライアントの作成

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

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

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

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

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

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

認証する PDF ドキュメントを取得

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

PDF ドキュメントの認証

SignatureServiceClient オブジェクトの certify メソッドを呼び出し、次の値を渡し、PDF ドキュメントを認証します。

• 認証する PDF ドキュメントを表す BLOB オブジェクト
• 署名を含む署名フィールドの名前を表す文字列値。
• PDF ドキュメントの認証に使用する資格情報を表す Credential オブジェクト。Credential オブジェクトを作成するには、コンストラクターを使用し、Credential オブジェクトの alias プロパティに値を割り当てエイリアスを指定します。
• PDF ドキュメントのダイジェストに使用するハッシュアルゴリズムを表すスタティックデータメンバーを指定する HashAlgorithm オブジェクトです。例えば、SHA1 アルゴリズムを使用するために HashAlgorithm.SHA1 を指定できます。
• ハッシュアルゴリズムを使用するかどうかを指定するブール値です。
• PDF ドキュメントが認証された理由を表す文字列値。
• 署名者の場所を表す文字列値です。
• 署名者の連絡先情報を表す文字列値です。
• 署名を無効にする PDF ドキュメントで実行できるアクションを指定する MDPPermissions オブジェクトの静的データメンバーです。
• 前のパラメータ値として渡された MDPPermissions オブジェクトを使用するかどうかを指定するブール値。
• どのようなアクションで署名が無効になるかを説明する文字列値。
• 認証された署名の外観を制御する PDFSignatureAppearanceOptions オブジェクト。コンストラクタを使用して PDFSignatureAppearanceOptions オブジェクトを作成します。署名のデータメンバーのいずれかを設定することで、署名の外観を変更できます。
• 署名者の証明書に対して失効確認を実行するかどうかを指定する System.Boolean オブジェクトです。失効確認を実行すると、署名に埋め込まれます。デフォルトは、false です。
• 認証される署名フィールドをロックするかどうかを指定する System.Boolean オブジェクトです。署名フィールドをロックすると、このフィールドは読み取り専用としてマークされ、プロパティは変更できません。また、必要な権限を持たないユーザーはこのフィールドをクリアできません。デフォルトは、false です。
• 署名フィールドをロックするかどうかを指定する System.Boolean オブジェクトです。つまり、 true を前のパラメーターに渡す場合は、true をこのパラメーターに渡します。
• オンライン証明書ステータスプロトコル（OCSP）のサポートの環境設定を保存する OCSPPreferences オブジェクトです。このオブジェクトは、PDF ドキュメントの認証に使用される資格情報のステータスに関する情報を提供します。失効確認を実行しない場合、このパラメーターは使用されず、null を指定できます。
• 証明書失効リスト (CRL) の環境設定を格納する CRLPreferences オブジェクト。失効確認が実行されない場合、このパラメーターは使用されず、null を指定できます。
• タイムスタンププロバイダー（TSP）がサポートする環境設定を格納する TSPPreferences オブジェクト。例えば、TSPPreferences オブジェクトを作成したら、TSPPreferences オブジェクトの tspServerURL データメンバーを設定し、TSP の URL を設定できます。このパラメーターはオプションで、null にすることができます。

certify メソッドは、認証済みPDF オブジェクトを表す BLOB オブジェクトを返します。

認証済み PDF ドキュメントを PDF ファイルとして保存

• コンストラクタを呼び出し、認証された PDF ドキュメントを含む PDF ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡すことによって、System.IO.FileStream オブジェクトを作成します。
• certify メソッドによって返された BLOB オブジェクトのコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの binaryData データメンバーの値を取得して、バイト配列にデータを入力します。
• コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。
• System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出してバイト配列を渡すことにより、バイト配列の内容を PDF ファイルに書き込みます。

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

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

Signature クライアントの作成

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

検証する署名を含む PDF ドキュメントを取得する

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

PKI 実行時オプションを設定する

• コンストラクタを使用して PKIOptions オブジェクトを作成します。
• PKIOptions オブジェクトの setVerificationTime メソッドを呼び出して、検証時刻を指定する VerificationTime 列挙値を渡すことにより検証する時刻を設定します。
• PKIOptions オブジェクトの setRevocationCheckStyle メソッドを呼び出して、失効確認を実行するかどうかを指定する RevocationCheckStyle 列挙値を渡すことにより、失効確認オプションを設定します。

電子署名を検証する

SignatureServiceClient オブジェクトの verify2 メソッドを呼び出して次の値を渡して、署名を検証します。

• 電子署名、または認証済みの PDF ドキュメントを含む com.adobe.idp.Document オブジェクト。
• 検証する署名が含まれている署名フィールド名を表す文字列値。
• PKI 実行時オプションを含む PKIOptions オブジェクト。
• SPI 情報を含む VerifySPIOptions インスタンス。このパラメーターには、null を指定できます。

verify2 メソッドでは、電子署名の検証に使用できる情報を含む PDFSignatureVerificationInfo オブジェクトが返されます。

署名のステータスの判断

• PDFSignatureVerificationInfo オブジェクトの getStatus メソッドを呼び出して、署名のステータスを判断します。このメソッドは、署名のステータスを指定する SignatureStatus オブジェクトを返します。例えば、署名済みの PDF ドキュメントに変更がない場合は、このメソッドにより SignatureStatus.DocumentSigNoChanges が返されます。

署名者の ID の判断

• PDFSignatureVerificationInfo オブジェクトの getSigner メソッドを呼び出して、署名者の ID を判断します。このメソッドは、IdentityInformation オブジェクトを返します。
• IdentityInformation オブジェクトの getStatus メソッドを呼び出して、署名者の ID を判断します。このメソッドは、ID を特定する IdentityStatus 列挙値を返します。例えば、信頼されている署名者の場合、このメソッドでは IdentityStatus.TRUSTED が返されます。

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

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1 を使用するようにします。

NOTE

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

Signature クライアントの作成

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

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

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

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

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

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

検証する署名を含む PDF ドキュメントを取得する

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

PKI 実行時オプションを設定する

• コンストラクタを使用して PKIOptions オブジェクトを作成します。
• PKIOptions オブジェクトの verificationTime データメンバーに検証時間を指定する VerificationTime 列挙値を割り当てて、検証時間を設定します。
• PKIOptions オブジェクトの revocationCheckStyle データメンバーに、失効チェックを実行するかどうかを指定する RevocationCheckStyle 列挙値を割り当てることにより、失効確認オプションを設定します。

電子署名を検証する

SignatureServiceClient オブジェクトの verify2 メソッドを呼び出して次の値を渡して、署名を検証します。

• デジタル署名された、または認証された PDF ドキュメントを含む BLOB オブジェクト。
• 検証する署名が含まれている署名フィールド名を表す文字列値。
• PKI 実行時オプションを含む PKIOptions オブジェクト。
• SPI 情報を含む VerifySPIOptions インスタンス。このパラメーターには、null を指定できます。

verify2 メソッドでは、電子署名の検証に使用できる情報を含む PDFSignatureVerificationInfo オブジェクトが返されます。

署名のステータスの判断

PDFSignatureVerificationInfo オブジェクトの status データメンバーの値を取得して、署名のステータスを決定します。このデータメンバーは、署名のステータスを指定する SignatureStatus オブジェクトを格納します。例えば、署名済みの PDF ドキュメントを変更する場合、status データメンバーに値 SignatureStatus.DocumentSigNoChanges が格納されます。

署名者の ID の判断

• PDFSignatureVerificationInfo オブジェクトの signer データメンバーの値を取得して、署名者の ID を決定します。このメンバーは IdentityInformation オブジェクトを返します。
• IdentityInformation オブジェクトの status データメンバーを取得して、署名者の ID を決定します。このデータメンバーは、id を指定する IdentityStatus 列挙値を返します。例えば、署名者が信頼されている場合、このメンバーは IdentityStatus.TRUSTED を返します。

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

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

Signature クライアントの作成

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

検証する署名が含まれている PDF ドキュメントを取得します

• コンストラクターを使用して、検証対象である複数のデジタル署名を含む PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。PDF ドキュメントの場所を指定する文字列値を渡します。
• コンストラクタを使用して java.io.FileInputStream オブジェクトを渡すことによって、com.adobe.idp.Document オブジェクトを作成します。

PKI ランタイムオプションを設定

• コンストラクタを使用して PKIOptions オブジェクトを作成します。
• 検証時間を設定するには、PKIOptions オブジェクトの setVerificationTime メソッドを呼び出して、検証時間を指定する VerificationTime 列挙値を渡します。
• 失効確認オプションを設定するには、PKIOptions オブジェクトの setRevocationCheckStyle メソッドを呼び出して、失効確認を実行するかどうかを指定する RevocationCheckStyle 列挙値を渡します。

すべてのデジタル署名を取得する

SignatureServiceClient オブジェクトの verifyPDFDocument メソッドを呼び出して、以下の値を渡します。

• 複数のデジタル署名を含む PDF ドキュメントが格納されている com.adobe.idp.Document オブジェクト。
• PKI 実行時オプションが格納されている PKIOptions オブジェクト。
• SPI 情報を含む VerifySPIOptions インスタンス。このパラメーターには null を指定できます。

この verifyPDFDocument メソッドは、PDF ドキュメントにあるすべてのデジタル署名に関する情報が格納されている PDFDocumentVerificationInfo オブジェクトを返します。

すべての署名を繰り返し処理する

• PDFDocumentVerificationInfo オブジェクトの getVerificationInfos メソッドを呼び出して、すべての署名を繰り返し処理します。このメソッドは、各要素が PDFSignatureVerificationInfo オブジェクトである java.util.List オブジェクトを返します。java.util.Iterator オブジェクトを使用して、署名のリストを反復処理します。
• PDFSignatureVerificationInfo オブジェクトを使用すると、PDFSignatureVerificationInfo オブジェクトの getStatus メソッドを呼び出して署名のステータスを決定するといったタスクを実行することができます。このメソッドは、静的データメンバーが署名のステータスを通知する SignatureStatus オブジェクトを返します。例えば署名が不明な場合、このメソッドは SignatureStatus.DocumentSignatureUnknown を返します。

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

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1 を使用するようにします。

NOTE

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

Signature クライアントの作成

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

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

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

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

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

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

検証する署名が含まれている PDF ドキュメントを取得します

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

PKI ランタイムオプションを設定

• コンストラクタを使用して PKIOptions オブジェクトを作成します。
• 検証時間を設定するには PKIOptions オブジェクトの verificationTime データメンバーを、検証時間を指定する VerificationTime 列挙値に割り当てます。
• 失効確認オプションを設定するには、PKIOptions オブジェクトの revocationCheckStyle データメンバーを、失効確認を実行するかどうかを指定する RevocationCheckStyle 列挙値に割り当てます。

すべてのデジタル署名を取得する

SignatureServiceClient オブジェクトの verifyPDFDocument メソッドを呼び出して、以下の値を渡します。

• 複数のデジタル署名を含む PDF ドキュメントが格納されている BLOB オブジェクト。
• PKI 実行時オプションが格納されている PKIOptions オブジェクト。
• SPI 情報を含む VerifySPIOptions インスタンス。このパラメーターには null を指定できます。

この verifyPDFDocument メソッドは、PDF ドキュメントにあるすべてのデジタル署名に関する情報が格納されている PDFDocumentVerificationInfo オブジェクトを返します。

すべての署名を繰り返し処理する

• PDFDocumentVerificationInfo オブジェクトの verificationInfos データメンバーを取得することで、すべての署名を繰り返し処理します。このデータメンバーは、各要素が PDFSignatureVerificationInfo オブジェクトである Object 配列を返します。
• PDFSignatureVerificationInfo オブジェクトを使用すると、PDFSignatureVerificationInfo オブジェクトの status データメンバーを取得することによって、署名のステータスを決定するタスクなどを実行できます。このデータメンバーは、静的データメンバーが署名のステータスについて通知する SignatureStatus オブジェクトを返します。例えば、署名が不明な場合、このメソッドは SignatureStatus.DocumentSignatureUnknown を返します。

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

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

Signature クライアントを作成します。

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

削除する署名が含まれている PDF ドキュメントを取得します。

• 削除する署名が含まれている PDF ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。このため、このオブジェクトのコンストラクターを使用して、PDF ドキュメントの場所を指定する文字列値を渡します。
• コンストラクターを使用して java.io.FileInputStream オブジェクトを渡すことにより、com.adobe.idp.Document オブジェクトを作成します。

署名フィールドからデジタル署名を削除します。

署名フィールドから電子署名を削除するには、SignatureServiceClient オブジェクトの clearSignatureField メソッドを呼び出し、次の値を渡します。

• 削除する署名が含まれている PDF ドキュメントを表す com.adobe.idp.Document オブジェクト。
• デジタル署名が含まれている署名フィールドの名前を示す文字列値。

clearSignatureField メソッドは、デジタル署名が削除された PDF ドキュメントを表す com.adobe.idp.Document オブジェクトを返します。

PDFドキュメントを PDF ファイルとして保存する

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