Artykuł techniczny

Podmiana podpisów PDF: przerwy ByteRange i drugie podpisy

Podpisany PDF może nieść sfabrykowaną stronę, przechodzić sprawdzanie digesta CMS i raportować, że jego podpis pokrywa cały dokument — wszystko naraz. Każdy podpisany bajt zostaje dokładnie taki, jak zostawił go signer, /ByteRange wciąż startuje od 0 i kończy na rozmiarze pliku, a dodatkowe obiekty siedzą w tym jednym odcinku pliku, który podpis PDF celowo wyłącza z digesta: przestrzeni zarezerwowanej dla szesnastkowego stringa /Contents

Ten odcinek jest większy, niż większość ludzi wyobraża. Rezerwacja 8 192 bajtów na kontener CMS kładzie na dysku 16 384 cyfry szesnastkowe, i cokolwiek z nich prawdziwy podpis nie zużyje, jest wypełniane cyfrą 0. Weryfikator, który pyta tylko, czy przerwa między dwoma zakresami jest niepusta, nigdy nie patrzy, co przerwa trzyma. To samo pytanie o układ pojawia się z przeciwnej strony, gdy kontrakt potrzebuje kontrpodpisu: podpis akceptującego musi zostać doklejony bez dotknięcia jednego bajta, który podpisał dostawca, a jego placeholder ma wylądować dokładnie w kształcie, jaki surowy weryfikator przyjmuje

Co przerwa ByteRange musi zawierać

Przerwa musi trzymać kompletną wartość /Contents i nic poza tym. ISO 32000-1 §12.8.3.3 mówi, że ciąg szesnastkowy, wraz ze swoimi delimiterami < i >, mieści się dokładnie w przestrzeni między dwoma zakresami bajtów, a ISO 32000-2 §12.8.1 niesie tę samą regułę dalej. Tabela 252 i dokumenty PAdES formułują to luźniej, mówiąc tylko, że digest wyłącza wartość Contents. Przeczytane szybko brzmi to jak „wyłącz cyfry szesnastkowe”, i signer idący za tą luźniejszą lekturą hashuje oba nawiasy kątowe razem z całą resztą. Walidatory porównujące przerwę z wartością podpisu oflagują wtedy zakres bajtów jako invalid

HotPDF trzyma się sformułowania z §12.8.3.3 na obu swoich trasach podpisywania. THotPDF.PreparePDFForSigning kończy pierwszy zakres natychmiast przed < i zaczyna drugi natychmiast po >, a strumieniowe przygotowanie wewnątrz potoku podpisu CMS liczy te same offsety. Placeholder /ByteRange w słowniku podpisu to literał o stałej szerokości, więc wpinanie prawdziwych liczb nigdy nie przesuwa bajta, a tablica odsyłaczy pozostaje ważna. Każda z czterech wartości jest wyrównana do prawej w dziesięcioznakowym polu — dlatego plik podpisany tą drogą pokazuje /ByteRange [, po którym biegną ciągi spacji. Zapłaciliśmy za ten padding raz, jadąc własnym samodzielnym weryfikatorem: pierwsza wersja ciąła cztery liczby po pojedynczych spacjach i nie znalazła nic, a szesnastkowy /Contents dał prawdziwe bajty CMS dopiero po zdjęciu końcowego zerowego paddingu

Dwa bajty wystarczają, żeby samodzielnie sprawdzić każdy podpisany plik, niezależnie od tego, kto go wyprodukował. Bajt pod offsetem ByteRange[1] musi być <, a bajt pod offsetem ByteRange[2] - 1 musi być >. Helper poniżej nie jest częścią biblioteki; to tuzin linii, które możesz wpuścić do narzędzia audytowego, karmiąc go tablicą ByteRange z GetLoadedSignatureInfo

// Sugerowany helper do twojego własnego kodu audytowego, nie API HotPDF
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];               // pierwszy bajt przerwy
    if (FS.Read(B, 1) <> 1) or (B <> '<') then Exit;
    FS.Position := BR[2] - 1;           // ostatni bajt przerwy
    if (FS.Read(B, 1) <> 1) or (B <> '>') then Exit;
    Result := True;
  finally
    FS.Free;
  end;
end;

// Użycie, po Pdf.LoadFromFile('Signed.pdf'):
//   if not GapIsSpecLayout('Signed.pdf',
//     Pdf.GetLoadedSignatureInfo(0).ByteRange) then
//     Writeln('Nawiasy siedzą wewnątrz podpisanych zakresów');

W kryptograficznej połowie OpenSSL weryfikuje CMS niezależnie: sklej dwa zakresy w jeden plik i podaj go jako zawartość zewnętrzną, na przykład openssl cms -verify -binary -inform DER -in contents.der -content signed-ranges.bin -noverify. To polecenie sprawdza digest i podpis po dokładnie tych bajtach, które mu podasz. Przerwy nigdy nie widzi, więc dwubajtowe sprawdzenie powyżej wciąż jest twoją robotą

Anatomia poprawnie wypełnionego ByteRange podpisu PDF w HotPDF: pierwszy zakres obejmuje plik od bajtu zero, przerwa trzyma kompletny szesnastkowy ciąg /Contents łącznie z delimiterami mniejszości i większości, drugi zakres obejmuje trailer do końca, a dwa jednobajtowe sprawdzenia pod ByteRange[1] i ByteRange[2] - 1 potwierdzają układ na każdym podpisanym pliku
Delimitery siedzą poza podpisanymi zakresami, więc digest obejmuje same cyfry, a przerwę można walidować bajt po bajcie

Czemu sprawdzenie niepustej przerwy przepuszcza podmianę podpisu?

Niepusta przerwa dowodzi, że coś zostało wyłączone z digesta, i nie mówi nic o czym. To cała powierzchnia ataku. Placeholder /Contents jest rezerwowany z tysiącami zerowych cyfr, a prawdziwy kontener CMS rzadko go wypełnia. Atakujący zamyka szesnastkowy ciąg wcześnie wewnątrz tego paddingu swoim >, wpisuje nowe obiekty albo całą sfabrykowaną rewizję w resztę zarezerwowanej przestrzeni i zostawia zakresy bajtów nietknięte. CMS się wciąż weryfikuje, bo każdy podpisany bajt jest niezmieniony. Zakresy wciąż biegną od 0 do rozmiaru pliku. Weryfikator, który staje na „przerwa jest niepusta”, raportuje svValid z ustawionym CoversWholeDocument na True, podczas gdy każdy parser PDF otwierający plik idzie za obiektami siedzącymi w niepodpisanej dziurze

THotPDF.VerifyLoadedSignatureEx traktuje przerwę jako dane do walidacji. Kiedy sprawdzenie CMS przejdzie, weryfikator czyta przerwę, zdejmuje delimitery i przyjmuje wyłącznie cyfry szesnastkowe plus pięć bajtów białych PDF (tabulator, wysuw linii, wysuw strony, powrót karetki, spacja). Zdekodowane cyfry muszą potem równać się bajt po bajcie własnemu /Contents słownika podpisu. Obcy >, jeden bajt binarny albo zdekodowana wartość o bajt za długa lub za krótka zamieniają wynik w svInvalidByteRange, i to samo robi przerwa większa niż 64 MiB. To samo sprawdzenie działa w ValidateLoadedSignatureBatch; VerifyAllLoadedSignatures i VerifyLoadedSignatureWithTrust idą przez ścieżkę pojedynczego podpisu, więc dziedziczą je również

Jeden układ jest celowo przepuszczany: pliki, których signer zostawił nawiasy wewnątrz podpisanych zakresów, więc przerwa trzyma same cyfry. Dla takich weryfikator potwierdza, że bajt tuż przed przerwą to <, a bajt tuż po niej to >, a potem stosuje ten sam test cyfr i białych znaków. Odrzucenie tego układu nie kupowałoby żadnego bezpieczeństwa, bo przerwa i tak nie zawiera niczego poza wartością podpisu, a wywaliłoby archiwalne kontrakty, które są całkowicie nietknięte. Przyjmowanie go to właściwy domyślny wybór

Jak podmiana podpisu wykorzystuje słabo sprawdzany ByteRange PDF w Delphi: atakujący zamyka szesnastkowy ciąg wcześnie wewnątrz tysięcy zarezerwowanych zerowych cyfr, wpisuje sfabrykowaną rewizję do niepodpisanej przerwy bez dotykania jakiegokolwiek objętego bajtu, a sprawdzenie niepustej przerwy wciąż raportuje svValid z CoversWholeDocument true, dlatego HotPDF waliduje przerwę bajt po bajcie
Niepusta przerwa dowodzi tylko, że coś wyłączono ze skrótu, ale nie co — wypchana dziura to cała powierzchnia ataku
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;

Zarówno GetLoadedSignatureFieldCount, jak i indeks podawany do VerifyLoadedSignatureEx liczą pola podpisu w kolejności pól formularza, od 0. W pliku skontrpodpisanym podpis dostawcy ląduje w pierwszej gałęzi z CoversWholeDocument = False i dodatnim UnsignedTrailingBytes: wszystko, co doklejono po nim, rewizja akceptującego włącznie. Jeśli podstawy tego API są dla ciebie nowe, przewodnik po weryfikacji cyfrowych podpisów PDF z HotPDF omawia wartości statusu i rekord informacyjny głębiej

Kontrpodpisywanie z AddLoadedSignedSignatureField

Kontrpodpis bierze cztery wywołania: otwórz podpisany plik przez BeginIncrementalUpdate, dodaj pole przez AddLoadedSignedSignatureField, zapisz nową rewizję przez SaveIncrementalUpdate, a potem podpisz przygotowany plik funkcją klasową THotPDF.SignPDFWithPFX. Poziom strony THPDFPage.AddSignedSignatureField się tu nie stosuje, bo CurrentPage jest nil w trakcie aktualizacji przyrostowej; dokument jest załadowany, a nie układany. Metoda dokumentu załadowanego tworzy widget na istniejącej stronie i wiesza pod /V ten sam placeholder słownika podpisu, jaki buduje ścieżka nowego dokumentu, więc obie trasy podpisywania widzą identyczne bajty. Samą pierwszą sygnaturę przeprowadza przez potok PFX artykuł o tworzeniu cyfrowych podpisów PAdES w Delphi

var
  Pdf: THotPDF;
  FieldIndex: Integer;
begin
  Pdf := THotPDF.Create(nil);
  try
    Pdf.BeginIncrementalUpdate('Signed.pdf');
    // Strona 0, prostokąt widgeta w punktach, 8192 bajtów zarezerwowanych na CMS
    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;

  // Podpisuje pierwszy niewypełniony placeholder; podnosi wyjątek przy błędach PFX albo krypto
  if not THotPDF.SignPDFWithPFX('Prepared.pdf', 'SignedTwice.pdf',
    'approver.pfx', 'pfx-password') then
    raise Exception.Create('Second signature failed');
end;

Lista parametrów jest krótka, ale każda wartość ma widoczny efekt. ContentsBytes ma domyślnie 8192 i wymiaruje zdekodowany kontener CMS; placeholder na dysku trzyma dwa razy tyle cyfr szesnastkowych, z podłogą 64 bajtów. SubFilter ma domyślnie adbe.pkcs7.detached, a Reason, Location i ContactName lądują w słowniku podpisu jako /Reason, /Location i /ContactInfo, obok znacznika czasu /M wziętego w chwili tworzenia pola. Wartość zwrotna to indeks nowego pola albo -1, gdy indeks strony jest poza zakresem. Pusta nazwa pola albo prostokąt o zerowej szerokości lub wysokości podnoszą wyjątek, zanim cokolwiek zostanie zapisane

Co doklejona rewizja niesie, a czego nie rusza

AddLoadedSignedSignatureField jest celowo cichszy od swoich krewnych. Pozostali twórcy pól AddLoaded* ustawiają /NeedAppearances true na AcroForm, co prosi przeglądarkę o regenerację wyglądów pól przy otwarciu pliku. Na podpisanym dokumencie ta regeneracja może przepisać zawartość objętą pierwszym signerem. Nowa metoda usuwa więc flagę z powrotem, kiedy plik źródłowy jej nie niósł, a plik, który przyszedł z /NeedAppearances, trzyma ją dokładnie tak, jak była. /SigFlags zachowuje swoje istniejące bity i zyskuje 3 — SignaturesExist (1) plus AppendOnly (2) z ISO 32000-1 §12.7.2, tabela 219

Zostaw MarkDirty w spokoju dla strony. W trybie przyrostowym nowo utworzone obiekty są zapisywane automatycznie, a załadowane tylko wtedy, gdy coś je oznaczy. Dodanie widgeta do /Annots strony i do AcroForm /Fields samo wkłada do nowej rewizji wszystkie obiekty pośrednie posiadające te tablice. Jawne oznaczenie strony ciągnie za sobą słownik strony nawet wtedy, gdy jego tablica /Annots mieszka w osobnym obiekcie, a analiza rewizji raportuje wtedy modyfikację strony w rewizji, która powinna zawierać nic poza polem podpisu

Słownik placeholdera zapisuje /ByteRange przed /Contents. Ta kolejność ma znaczenie, jeśli post-processujesz przygotowany plik własnymi narzędziami: PreparePDFForSigning znajduje najpierw wartownika /ByteRange, a potem szuka w przód następnego /Contents <. Słownik z zamienionymi kluczami wysłałby to szukanie w przód za jego własny szesnastkowy ciąg, w cokolwiek przyjdzie dalej w pliku

Kiedy pierwszy signer nałożył restrykcję DocMDP albo FieldMDP, SaveIncrementalUpdateAuthenticated to ostrzejszy sposób zapisania rewizji 2. Zapisuje do pliku kandydata w tym samym katalogu, uwierzytelnia każdy podpis niosący politykę transformacji, ewaluuje wszystkie rewizje po każdej z nich i publikuje kandydata tylko wtedy, gdy każda polityka pozwala na zmianę. Na nieskrępowanym kontrakcie zwykły SaveIncrementalUpdate robi robotę z mniejszą ceremonią

Przepływ HotPDF w Delphi do kontrpodpisywania już podpisanego PDF-a: BeginIncrementalUpdate otwiera plik, AddLoadedSignedSignatureField tworzy widżet i rezerwuje placeholder /Contents, SaveIncrementalUpdate dokleja drugą rewizję, a SignPDFWithPFX ją zapełnia, zostawiając pierwszy podpis ważny z UnsignedTrailingBytes, podczas gdy nowy ByteRange obejmuje cały urośnięty plik
Jeden placeholder na rewizję, przygotowywany i łatany tą samą serializacją na obu trasach podpisywania — czysty układ, jakiego oczekuje surowszy weryfikator

Podawanie digesta zewnętrznemu signerowi albo HSM

Nic w przepływie się nie zmienia, gdy CMS przychodzi z karty smart, HSM albo zdalnej usługi podpisującej; zmienia się tylko ostatni krok. THotPDF.PreparePDFForSigning łata /ByteRange w przygotowanych bajtach i zwraca dwa zakresy liczone od 0, których przerwa to cały string /Contents, plus ContentsHexStart — indeks pierwszej cyfry szesnastkowej w AnsiString liczony od 1 — oraz ContentsHexLen. Mieszanie offsetów pliku liczonych od 0 z indeksami stringa licznymi od 1 to klasyczny off-by-one w tym kroku. Przykład asertuje obie pozycje delimiterów, zanim cokolwiek zhashuje

var
  Bytes, ToSign, CmsHex: AnsiString;
  R1Start, R1Len, R2Start, R2Len, HexStart, HexLen: Integer;
begin
  Bytes := LoadFileAsAnsiString('Prepared.pdf');   // twój helper
  if not THotPDF.PreparePDFForSigning(Bytes, R1Start, R1Len,
    R2Start, R2Len, HexStart, HexLen) then
    raise Exception.Create('No signature placeholder found');

  // Sugerowane sprawdzenia zdroworozsądkowe (twoje, nie wywołania biblioteki):
  // '<' kończy zakres 1, '>' siedzi tuż przed zakresem 2
  Assert(Bytes[R1Start + R1Len + 1] = '<');
  Assert(Bytes[R2Start] = '>');

  ToSign := Copy(Bytes, R1Start + 1, R1Len) + Copy(Bytes, R2Start + 1, R2Len);
  CmsHex := SignDetachedWithHsm(ToSign);           // twój signer CMS, DER w hexie
  if not THotPDF.InsertSignatureHexAt(Bytes, HexStart, HexLen, CmsHex) then
    raise Exception.Create('CMS does not fit the reserved space');
  SaveAnsiStringToFile(Bytes, 'SignedTwice.pdf');  // twój helper
end;

Przygotuj dokładnie jeden placeholder na rewizję. PreparePDFForSigning łata pierwszego nieopatchowanego wartownika /ByteRange, jaki znajdzie, a drugi placeholder zostawiony w tej samej rewizji siedzi wewnątrz bajtów, które pierwsza sygnatura obejmuje, więc wypełnienie go później psuje tę sygnaturę. Do wpisania CMS z powrotem właściwą komendą jest InsertSignatureHexAt ze zwróconymi offsetami. InsertSignatureHex szuka pierwszego stringa /Contents, którego cyfry są wszystkie zerami — działa na pliku z pojedynczym pustym placeholderem; z offsetami w ręku nie ma czego szukać i niczego nie da się źle dopasować. Krótszy CMS jest dopełniany 0 na końcu, przed zamykającym >. Dłuższy sprawia, że InsertSignatureHexAt zwraca False, nie dotykając bajtów pliku

Co dowodzi sprawdzenie przerwy, a czego nie?

Sprawdzenie przerwy zamyka jedną konkretną dziurę. svValid nadal znaczy integralność bajtów plus podpis pasujący do certyfikatu wpisanego w CMS; to, czy ten certyfikat łańcuchuje się do zaakceptowanego zaufanego korzenia, odpowiada VerifyLoadedSignatureWithTrust, dostawszy twoje korzenie zaufania i dowody rewokacji. Bez bajtów źródłowych nic nie dociera do svValid w ogóle. VerifyLoadedSignatureEx czyta je z pliku, z którego dokument został załadowany, i zwraca svSourceUnavailable dla dokumentu załadowanego ze strumienia, gdzie przeciążenie TStream VerifyLoadedSignature bierze je od ciebie

Dla pierwszej sygnatury w pliku skontrpodpisanym CoversWholeDocument jest poprawnie False. To, czy doklejona rewizja tylko dodała podpis, czy też zmieniła strony, to pytanie dla AnalyzeLoadedSignatureRevisions, wyjaśnionego w DocMDP, FieldMDP i analizie rewizji w HotPDF

Układ z nawiasami przecieka też do załączonego MAC PDF zdefiniowanego w ISO TS 32004 (/MACLocation /AttachedToSig), którego sprawdzenie porównuje offsety z dokładnymi pozycjami < i > w pliku. HotPDF przyjmuje tam oba układy. Domowe narzędzie z zaszytymi na sztywno offsetami włączającymi nawiasy to zwykle pierwsza rzecz, która pada, gdy spotka plik podpisany w układzie §12.8.3.3, a puszczenie dwubajtowego helpera z pierwszej sekcji na wyjściu własnego narzędzia zabiera minutę

Większość kłopotów z podpisami w tej okolicy zaczyna się, gdy narzędzie podpisujące, narzędzie kontrpodpisujące i narzędzie audytujące mają różne zdanie o tym, gdzie idą nawiasy. HotPDF, natywny komponent PDF dla Delphi i C++Builder pisze układ §12.8.3.3 na każdej trasie podpisywania, sprawdza przerwę bajt po bajcie na każdej ścieżce weryfikacji i dokleja kontrpodpisy jako czyste rewizje przyrostowe z jednego API