技術記事

PDF署名ラッピング:ByteRangeギャップと2つ目の署名

署名済みPDFは、偽造ページを運びながら、CMSダイジェスト検査を通過し、その署名が文書全体を覆うと報告できます。すべて同時にです。署名されたバイトは署名者が残したとおりぴったりで、/ByteRangeは今も0から始まりファイルサイズで終わり、余分なオブジェクトは、PDF署名が意図的にダイジェストから外すファイル内のただ1つの区間、つまり/Contentsの16進文字列のために予約された空間に座っています

その区間は多くの人が思い描くより大きいです。CMSコンテナに8,192バイトを予約すると、ディスク上には16,384桁の16進数字が並び、本当の署名が使わない部分は桁0で埋められます。2つの範囲の間の隙間が空でないかだけを尋ねる検証器は、隙間が何を保持するかを決して見ません。同じレイアウトの問いは、契約書に副署名が必要になると反対方向から現れます。承認者の署名は、ベンダーが署名したバイトを1つも触れずに追加されなければならず、そのプレースホルダは、厳格な検証器が受け入れるちょうどの形に収まらなければなりません

ByteRangeのギャップが含まねばならないもの

ギャップは完全な/Contents値を保持し、それ以外は何も保持してはなりません。ISO 32000-1 §12.8.3.3は、16進文字列が<と>の区切り文字込みで、2つのバイト範囲の間の空間にぴったり収まると言い、ISO 32000-2 §12.8.1が同じ規則を持ち越します。表252とPAdES文書はもっと緩く言語化し、ダイジェストがContents値を除外するとだけ言います。急いで読むと「16進数字を除外する」と聞こえ、緩い読みに従う署名者は2つの角かっこを他のすべてと一緒にハッシュします。ギャップを署名値と比較するバリデータは、そのときバイト範囲を無効とフラグします

HotPDFは両方の署名経路で§12.8.3.3の文言に従います。THotPDF.PreparePDFForSigningは最初の範囲を<の直前で終え、2つ目を>の直後で始め、CMS署名パイプライン内のストリーミング準備も同じオフセットを計算します。署名辞書の/ByteRangeプレースホルダは固定幅のリテラル文字列なので、実数のパッチで1バイトも動かず、相互参照テーブルは有効のままです。4つの値はそれぞれ10文字フィールドで右寄せされます。この方法で署名されたファイルが/ByteRange [の後に空白の連なりを見せるのはこのためです。わたしたちは自社のスタンドアロン検証器を書いているときにそのパディングの代償を一度払いました。最初の版は4つの数値を単一スペースで分割して何も見つけられず、/Contentsの16進は、末尾のゼロパディングを剥いで初めて本当のCMSバイトになりました

誰が作ったファイルでも、署名済みファイルを自分で検査するには2バイトで足ります。オフセットByteRange[1]のバイトは<でなければならず、オフセットByteRange[2] - 1のバイトは>でなければなりません。下のヘルパーはライブラリの一部ではなく、GetLoadedSignatureInfoのByteRange配列を渡して監査ツールに放り込める10行ほどのコードです

暗号の半分については、OpenSSLがCMSを独立に検証します。2つの範囲を1つのファイルに連結し、外部コンテンツとして渡します。たとえばopenssl cms -verify -binary -inform DER -in contents.der -content signed-ranges.bin -noverifyです。このコマンドは渡したバイトちょうどの上のダイジェストと署名を検査します。ギャップは決して見ません。だから上の2バイト検査は依然としてあなたの仕事です

HotPDFで正しく埋められたPDF署名ByteRangeの解剖。最初の範囲はバイト0からファイルを覆い、ギャップは区切り文字込みで完全な/Contents 16進文字列を保持し、2つ目の範囲はトレーラーから終端までを覆い、ByteRange[1]とByteRange[2] - 1での2つの1バイト検査がどの署名済みファイルでもレイアウトを確認します
区切り文字は署名範囲の外に座るので、ダイジェストは数字だけを覆い、ギャップはバイト単位で検証できます

空でないギャップ検査はなぜ署名ラッピングを見逃すのか

空でないギャップが証明するのは、何かがダイジェストから外されたことだけで、何が外されたかではありません。それが攻撃面のすべてです。/Contentsプレースホルダは数千桁のゼロで予約され、本当のCMSコンテナがそれを埋めることはめったにありません。攻撃者はそのパディングの中で16進文字列を>で早く閉じ、予約空間の残りに新しいオブジェクトや偽造リビジョン丸ごとを書き込み、バイト範囲には触れません。CMSは今も検証を通ります。署名されたバイトは1つも変わっていないからです。範囲は今も0からファイルサイズまで走ります。「ギャップは空でない」で立ち止まる検証器はCoversWholeDocumentをTrueにしたままsvValidを報告し、ファイルを開くどのPDFパーサーも、未署名の穴に座るオブジェクトをそのまま追います

THotPDF.VerifyLoadedSignatureExはギャップを検証すべきデータとして扱います。CMS検査が通った後、検証器はギャップを読み、区切り文字を剥ぎ、16進数字と5つのPDF空白バイト(タブ、ラインフィード、フォームフィード、キャリッジリターン、スペース)だけを受け入れます。そしてデコードされた数字が、署名辞書自身の/Contentsとバイト単位で等しいことを確認します。迷子の>、1個のバイナリバイト、1バイト長すぎたり短すぎたりするデコード値は結果をsvInvalidByteRangeに変え、64 MiBを超えるギャップもそうです。同じ検査がValidateLoadedSignatureBatchでも走り、VerifyAllLoadedSignaturesとVerifyLoadedSignatureWithTrustは単一署名の経路を通るので、これを継承します

1つのレイアウトは意図的に通します。署名者が括弧を署名範囲の内側に置いたファイルで、ギャップが数字だけを保持するものです。その場合、検証器はギャップの直前のバイトが<で直後のバイトが>であることを確認してから、同じ数字と空白の検査を適用します。そのレイアウトを拒否しても安全性は買えません。ギャップは今も署名値しか含まないからですし、完全に無傷のアーカイブ済み契約書が失敗することになります。受け入れるのが正しいデフォルトです

署名ラッピングがDelphiの緩く検査されたPDF ByteRangeを突く方法。攻撃者は予約された数千桁のゼロの中で16進文字列を早く閉じ、覆われたバイトに触れずに未署名のギャップへ偽造リビジョンを書き込み、空でないギャップ検査は今もCoversWholeDocument trueのままsvValidを報告する。HotPDFがギャップをバイト単位で検証するのはこのためです
空でないギャップが証明するのは、何かがダイジェストから外されたことであって何かではありません。パディングされた穴こそが攻撃面のすべてです
// 自前の監査コード向けの推奨ヘルパー。HotPDFのAPIではない
function GapIsSpecLayout(const FileName: string;
  const BR: array of Int64): Boolean;
var
  FS: TFileStream;
  B: AnsiChar;
begin
  Result := False;
  if Length(BR) <> 4 then Exit;
  FS := TFileStream.Create(FileName, fmOpenRead or fmShareDenyWrite);
  try
    FS.Position := BR[1];               // ギャップの最初のバイト
    if (FS.Read(B, 1) <> 1) or (B <> '<') then Exit;
    FS.Position := BR[2] - 1;           // ギャップの最後のバイト
    if (FS.Read(B, 1) <> 1) or (B <> '>') then Exit;
    Result := True;
  finally
    FS.Free;
  end;
end;

// 使い方。Pdf.LoadFromFile('Signed.pdf')の後で:
//   if not GapIsSpecLayout('Signed.pdf',
//     Pdf.GetLoadedSignatureInfo(0).ByteRange) then
//     Writeln('括弧が署名範囲の内側にあります');
var
  Pdf: THotPDF;
  Info: THPDFSignatureInfo;
  Status: THPDFSignatureVerifyStatus;
  I: Integer;
begin
  Pdf := THotPDF.Create(nil);
  try
    Pdf.LoadFromFile('SignedTwice.pdf');
    for I := 0 to Pdf.GetLoadedSignatureFieldCount - 1 do
    begin
      Status := Pdf.VerifyLoadedSignatureEx(I, Info);
      case Status of
        svValid:
          if Info.CoversWholeDocument then
            Writeln(Info.FieldName, ': valid, covers the whole file')
          else
            Writeln(Info.FieldName, ': valid, ',
              Info.UnsignedTrailingBytes, ' bytes appended later');
        svInvalidByteRange:
          Writeln(Info.FieldName, ': ByteRange gap rejected (wrapping?)');
        svSourceUnavailable:
          Writeln('Loaded from a stream: use the TStream overload');
      else
        Writeln(Info.FieldName, ': failed, status ', Ord(Status));
      end;
    end;
  finally
    Pdf.Free;
  end;
end;

GetLoadedSignatureFieldCountもVerifyLoadedSignatureExに渡すインデックスも、フォームフィールド順に0から数えます。副署名されたファイルでは、ベンダーの署名は最初の分岐に入り、CoversWholeDocument = Falseと正のUnsignedTrailingBytesになります。その後に追加されたすべて、承認者のリビジョン込みです。このAPIの基本が初めてなら、HotPDFでPDFデジタル署名を検証するガイドがステータス値と情報レコードをより深く扱っています

AddLoadedSignedSignatureFieldによる副署名

副署名は4回の呼び出しで済みます。BeginIncrementalUpdateで署名済みファイルを開き、AddLoadedSignedSignatureFieldでフィールドを足し、SaveIncrementalUpdateで新しいリビジョンを書き、それからクラス関数THotPDF.SignPDFWithPFXで準備済みファイルに署名します。ページレベルのTHPDFPage.AddSignedSignatureFieldはここでは使えません。インクリメンタルアップデート中はCurrentPageがnilだからです。文書はロードされていて、レイアウトされているのではありません。ロード済み文書メソッドは既存ページにウィジェットを作り、新規文書経路が組み立てるのと同じプレースホルダ署名辞書を/Vの下にぶら下げるので、両署名経路は同じバイトを見ます。最初の署名そのものについては、DelphiでPAdESデジタル署名を作成する記事がPFXパイプラインを歩いています

var
  Pdf: THotPDF;
  FieldIndex: Integer;
begin
  Pdf := THotPDF.Create(nil);
  try
    Pdf.BeginIncrementalUpdate('Signed.pdf');
    // ページ0、ウィジェット矩形はポイント単位、CMSに8192バイトを予約
    FieldIndex := Pdf.AddLoadedSignedSignatureField(0, 320, 60, 520, 120,
      'ApproverSignature', 8192, 'adbe.pkcs7.detached',
      'Approved for payment', 'Head office');
    if FieldIndex < 0 then
      raise Exception.Create('Page index out of range');
    Pdf.SaveIncrementalUpdate('Prepared.pdf');
  finally
    Pdf.Free;
  end;

  // 最初の未記入プレースホルダに署名する。PFXや暗号のエラーでは例外を上げる
  if not THotPDF.SignPDFWithPFX('Prepared.pdf', 'SignedTwice.pdf',
    'approver.pfx', 'pfx-password') then
    raise Exception.Create('Second signature failed');
end;

パラメータリストは短いですが、それぞれの値に目に見える効果があります。ContentsBytesはデフォルトで8192で、デコードされたCMSコンテナのサイズを決めます。ディスク上のプレースホルダはその2倍の16進数字を保持し、下限は64バイトです。SubFilterのデフォルトはadbe.pkcs7.detachedで、Reason、Location、ContactNameは署名辞書に/Reason、/Location、/ContactInfoとして、フィールド作成時点の/Mタイムスタンプと並んで入ります。戻り値は新しいフィールドインデックスで、ページインデックスが範囲外なら-1です。空のフィールド名や、幅か高さがゼロの矩形は、何かが書かれる前に例外を上げます

追加されるリビジョンが運ぶもの、手を付けないもの

AddLoadedSignedSignatureFieldは意図的に兄弟より静かです。他のAddLoaded*フィールド生成器はAcroFormに/NeedAppearances trueを設定します。これはビューアにファイルを開くときのフィールド外観の再生成を頼むものです。署名済み文書では、その再生成が最初の署名者が覆ったコンテンツを書き換えかねません。そこで新しいメソッドは、ソースファイルがそのフラグを運んでいなかった場合は再度フラグを取り除き、/NeedAppearances付きで届いたファイルはそのままの形で保持します。/SigFlagsは既存のビットを保ち、3を足します。ISO 32000-1 §12.7.2の表219にあるSignaturesExist(1)プラスAppendOnly(2)です

ページのMarkDirtyはそのままにしてください。インクリメンタルモードでは、新しく作られたオブジェクトは自動的に書かれ、ロードされたオブジェクトは何かが印を付けたときだけ書かれます。ウィジェットをページの/AnnotsとAcroFormの/Fieldsに足すだけで、それらの配列を所有する間接オブジェクトは新しいリビジョンに入ります。明示的なページの印は、/Annots配列が別オブジェクトに住んでいる場合でもページ辞書を引きずり込み、リビジョン分析は署名フィールドしか含むべきでないリビジョンにページ変更を報告します

プレースホルダ辞書は/Contentsの前に/ByteRangeを書きます。準備済みファイルを自前のツールで後処理するなら、この順序が効いてきます。PreparePDFForSigningはまず/ByteRangeのセンチネルを見つけ、それから前方へ/Contents <を探すからです。鍵を入れ替えた辞書は、その前方検索を自分の16進文字列の先へ、ファイルの次の何かに送り込んでしまいます

最初の署名者がDocMDPやFieldMDPの制限を課していた場合、リビジョン2の書き出しにはSaveIncrementalUpdateAuthenticatedというより厳格な方法があります。同じディレクトリの候補ファイルへ保存し、変換ポリシーを運ぶすべての署名を認証し、それぞれの後にすべてのリビジョンを評価し、すべてのポリシーが変更を許すときだけ候補を公開します。制限のない契約書なら、普通のSaveIncrementalUpdateが少ない儀式で仕事をします

すでに署名済みのPDFにHotPDFとDelphiで副署名するワークフロー。BeginIncrementalUpdateがファイルを開き、AddLoadedSignedSignatureFieldがウィジェットを作り/Contentsプレースホルダを予約し、SaveIncrementalUpdateが2つ目のリビジョンを追加し、SignPDFWithPFXがそれを埋める。最初の署名はUnsignedTrailingBytesつきのまま有効で、新しいByteRangeは成長したファイル全体にまたがります
リビジョンごとに1つのプレースホルダ、両署名経路で同じ直列化が準備とパッチを担う。厳格な検証器が期待するきれいなレイアウトです

ダイジェストを外部署名者やHSMへ渡す

CMSがスマートカードやHSMやリモート署名サービスから来るとき、ワークフローで変わるのは最後のステップだけです。THotPDF.PreparePDFForSigningは準備済みバイトの/ByteRangeにパッチを当て、ギャップが/Contents文字列全体である2つの0始まりの範囲を返します。さらにContentsHexStart、つまりAnsiString内の最初の16進数字の1始まりインデックスと、ContentsHexLenです。0始まりのファイルオフセットと1始まりの文字列インデックスを混ぜるのが、このステップの典型的なオフバイワンです。サンプルは何かをハッシュする前に両方の区切り位置を表明します

var
  Bytes, ToSign, CmsHex: AnsiString;
  R1Start, R1Len, R2Start, R2Len, HexStart, HexLen: Integer;
begin
  Bytes := LoadFileAsAnsiString('Prepared.pdf');   // 自前のヘルパー
  if not THotPDF.PreparePDFForSigning(Bytes, R1Start, R1Len,
    R2Start, R2Len, HexStart, HexLen) then
    raise Exception.Create('No signature placeholder found');

  // 推奨の健全性検査(自前のもので、ライブラリ呼び出しではない):
  // '<'が範囲1を終え、'>'が範囲2の直前に座る
  Assert(Bytes[R1Start + R1Len + 1] = '<');
  Assert(Bytes[R2Start] = '>');

  ToSign := Copy(Bytes, R1Start + 1, R1Len) + Copy(Bytes, R2Start + 1, R2Len);
  CmsHex := SignDetachedWithHsm(ToSign);           // 自前のCMS署名者、16進DER
  if not THotPDF.InsertSignatureHexAt(Bytes, HexStart, HexLen, CmsHex) then
    raise Exception.Create('CMS does not fit the reserved space');
  SaveAnsiStringToFile(Bytes, 'SignedTwice.pdf');  // 自前のヘルパー
end;

リビジョンごとにプレースホルダはちょうど1つ用意します。PreparePDFForSigningは見つけた最初の未パッチの/ByteRangeセンチネルにパッチを当てます。同じリビジョンに残された2つ目のプレースホルダは、最初の署名が覆うバイトの中に座るので、後で埋めるとその署名を壊します。CMSを書き戻すには、返されたオフセットでのInsertSignatureHexAtが使うべき呼び出しです。InsertSignatureHexは数字がすべてゼロの最初の/Contents文字列を探します。空のプレースホルダが1つだけのファイルなら動きますが、オフセットが手にあれば探すものも、一致しなおすものもありません。短いCMSは閉じる>の前に、末尾へ0でパディングされます。長いものはInsertSignatureHexAtがファイルバイトに触れずにFalseを返します

ギャップ検査が証明するものと、しないもの

ギャップ検査が塞ぐのは1つの特定の穴です。svValidは今も、バイトの完全性とCMSに埋め込まれた証明書に一致する署名を意味します。その証明書があなたの受け入れるトラストアンカーへチェーンするかは、トラストアンカーと失効証拠を渡してVerifyLoadedSignatureWithTrustが答える質問です。ソースバイトがなければ、何もsvValidに届きません。VerifyLoadedSignatureExは文書のロード元ファイルからそれらを読み、ストリームロードされた文書にはsvSourceUnavailableを返します。ストリームの文書では、VerifyLoadedSignatureのTStreamオーバーロードがソースバイトをあなたから受け取ります

副署名されたファイルの最初の署名では、CoversWholeDocumentは正しくFalseです。追加されたリビジョンが署名だけを足したのかページも変えたのかは、AnalyzeLoadedSignatureRevisionsへの質問で、HotPDFのDocMDP、FieldMDPとリビジョン分析で説明しています

括弧のレイアウトは、ISO TS 32004が定義する添付PDF MAC(/MACLocation /AttachedToSig)にも漏れ込みます。その検査はオフセットを、ファイル内の<と>の正確な位置と比較します。HotPDFはそこでも両レイアウトを受け入れます。括弧込みのオフセットをハードコードした自家製ツールは、§12.8.3.3レイアウトで署名されたファイルに出会ったとき、たいてい最初に壊れるものです。最初の節の2バイトヘルパーを自前のツールの出力に走らせるのに1分もかかりません

この領域の署名トラブルの大半は、署名するツール、副署名するツール、監査するツールが括弧の行き先について食い違うときに始まります。DelphiとC++Builder向けのネイティブPDFコンポーネントHotPDFは、すべての署名経路で§12.8.3.3レイアウトを書き、すべての検証経路でギャップをバイト単位に検査し、副署名を1つのAPIできれいなインクリメンタルリビジョンとして追加します