電子署名モジュール

PDFに新しく署名フィールドを追加します。署名フィールドの名前、署名フィールドの位置（ページ）、大きさ（上下辺、左右辺）の指定が必要です。

PDFに署名フィールドを作成し、署名とタイムスタンプをつける処理を一連の流れで行います。

既存PDFにある未署名の署名フィールドに署名／タイムスタンプをつけることができます。未署名の署名フィールドの名前を指定しますと、入力PDFから該当する名前をもつ署名フィールドを探して、署名とタイムスタンプを付けます。

出力結果として署名データがダミー（全てゼロ）になる点と、新しく引数に署名データ種別（PdsSignDataType）の指定が追加された点を除けば、従来の署名付与機能と引数も同じである。従来のPDF電子署名モジュールで利用していた署名データ種別はPDS_SDATA_PKCS7_DETACHである。今回は、サーバとクライアント間の通信量の問題を考慮して署名対象はハッシュ値のみのPDS_SDATA_PKCS7_SHA1とする。

指定された署名辞書のByteRangeと署名データ種別に従って、署名対象となるデータを取得する。PDS_SDATA_PKCS7_DETACH / PDS_SDATA_CADES_DETACHの場合にはByteRangeの範囲のデータを返し、PDS_SDATA_PKCS7_SHA1 / PDS_SDATA_DOC_TIMESTAMPの場合にはByteRangeの範囲のデータのハッシュ値を返す。ハッシュ値を返す場合にはハッシュアルゴリズムの指定が可能である。なお署名対象となるハッシュ値はバイナリ形式でSHA1の場合20バイト、SHA-2(512bit)の場合64バイトとなる。通常ByteRange範囲の場合には元PDFファイルとほぼ同じサイズが必要になるので注意が必要である。

指定された署名辞書に署名データをHEXに変換して埋め込む。HEX化した署名データサイズがダミーで確保したサイズよりも大きい場合はエラーとなる。また仮署名した時に指定された署名データ形式を守る必要がある。

署名データに後から署名タイムスタンプを付与する。現在利用可能な署名データ種別は、PDS_SDATA_PKCS7_DETACHとPDS_SDATA_PKCS7_SHA1の２種類のみ。タイムスタンプ種別としては全て利用が可能となる。

PDF電子署名モジュールが出力するPDFに対して、パスワードによるセキュリティ設定を行います。

PDF電子署名モジュールが出力するPDFに対して、電子証明書によるセキュリティ設定を行います。

PDF電子署名モジュールが出力するPDFに対して、Web表示用に最適化を設定します。

検証対象のPDFファイルに含まれる署名フィールドの一覧を取得します。各署名フィールドが署名済みかどうか、署名済みの場合はさらに署名後修正されているかどうかのステータスを取得できます。

【解説】

署名フィールド番号はファイルの先頭から順に、電子署名モジュールで１番から番号を付与します。

署名フィールド番号毎にステータスの取得ができます。

【解説】

署名フィールド番号を指定して、署名フィールドの名称、署名フィールドのページ番号とページ内の位置（矩形）、可視・不可視の別、署名の有無を取得します。
署名済みの場合は、普通署名かMDP署名か、MDP署名の場合署名後の変更許可設定を取得します。
さらに署名のプロフィール（署名者の名前、署名を付加した日、署名理由・場所・証明書発行者名）、タイムスタンプ付きの場合は、タイムスタンプ発行日付とタイムスタンプ発行者を表示します。
署名後修正されているかどうかについての解説は、署名バージョンの項をご参照ください。

PDFに含まれるすべての署名の署名バージョン番号と署名後修正されているかどうかのステータスを取得できます。

【解説】

署名後修正されているとは、当該署名対象範囲の後ろにデータが存在することを示すものであり、署名対象範囲内のデータ変更有無（改竄の有無）とは別の概念です。
PDF電子署名は、常に、署名する前のPDF全体を署名対象とします。
署名バージョンとは署名対象ドキュメント（署名済みの場合は署名データを追加したもの）を対象とし、その変更履歴に対応する番号となります。
最初の署名済みドキュメントの署名バージョンは１になります。その後、PDFを更新すると、PDFは増分更新され、署名対象範囲の後ろに情報が付加されます。その時点でドキュメントの署名バージョンはひとつ増加して2となります。そして、そのPDFが2つ目の署名で署名済みになりますと、署名済みPDFの署名バージョンが2になります。

署名バージョン番号を指定し、その署名データ値を検証します。

【解説】

PDF電子署名の署名対象はPDFファイルの先頭から最後までですが、署名辞書の中の電子署名値（Contentsキーの内容）を除く範囲となります。署名後の当該署名の署名対象範囲が署名したときから変更（改竄）されていなければ、「検証結果は有効です」となります。もし、署名後に変更されていれば、「検証結果（署名値）が有効ではありません」となります。この場合、データが改竄されている可能性があります。

署名バージョン番号を指定し、その署名に使用した電子証明書を検証します。

【解説】

電子証明書の検証は、署名に使用した秘密鍵と証明書の有効性を検証するものであり、署名データ自身の有効性とは独立です。

署名バージョン番号を指定し、そのタイムスタンプ値を検証します。

【解説】

署名にタイムスタンプがないときは、「未署名かタイプスタンプがありません」となります。

署名バージョン番号を指定し、そのタイムスタンプの証明書を検証します。

【解説】

署名にタイムスタンプがないときは、「未署名かタイプスタンプがありません」となります。タイムスタンプ署名証明書の検証は、署名に使用したタイムスタンプ局の秘密鍵とタイムスタンプ証明書の有効性を検証するものであり、タイムスタンプ値自身の有効性とは独立です。