Teknik Makale

PDF imza wrapping: ByteRange boşlukları ve ikinci imzalar

İmzalı bir PDF, uydurma bir sayfa taşıyabilir, bir CMS digest kontrolünden geçebilir ve imzasının tüm belgeyi kapsadığını raporlayabilir — hepsi aynı anda. İmzalı her bayt, imzalayanın bıraktığı gibi kalır; /ByteRange hâlâ 0'da başlar ve dosya boyutunda biter; fazladan nesneler ise bir PDF imzasının digest'ten bilerek dışarıda bıraktığı tek dosya bölümünde durur: /Contents hex dizgesi için rezerve edilen alan

O bölüm, çoğu insanın düşündüğünden büyüktür. CMS kabı için 8.192 bayt rezerve etmek, diske 16.384 hex basamağı koyar ve gerçek imzanın kullanmadığı kısım, 0 basamağıyla doldurulur. Yalnızca iki aralık arasındaki boşluğun boş olup olmadığını soran bir doğrulayıcı, boşluğun ne tuttuğuna hiç bakmaz. Aynı düzen sorusu, ters yönden bir sözleşmenin karşı imzaya ihtiyaç duyduğu zaman da çıkar: onaylayanın imzası, tedarikçinin imzaladığı tek bir bayta dokunmadan eklenmeli ve yer tutucusu, katı bir doğrulayıcının kabul ettiği biçimin tam kendisi olmalıdır

ByteRange boşluğu tam olarak ne içermelidir?

Boşluk, eksiksiz /Contents değerini taşır ve başka hiçbir şeyi değil. ISO 32000-1 §12.8.3.3, hex dizgesinin < ve > sınırlayıcılarıyla birlikte iki byte aralığı arasındaki alana tam oturduğunu söyler ve ISO 32000-2 §12.8.1 aynı kuralı ileri taşır. Tablo 252 ve PAdES belgeleri onu daha gevşek ifade eder; yalnızca digest'in Contents değerini dışladığını söyler. Hızlı okunduğunda bu "hex basamaklarını dışla" gibi gelir ve gevşek okumayı izleyen bir imzalayan, iki köşeli parantezi her şeyle birlikte hash'ler. Boşluğu imza değeriyle karşılaştıran doğrulayıcılar da byte aralığını geçersiz işaretler

HotPDF, iki imzalama yolunda da §12.8.3.3 ifadesini izler. THotPDF.PreparePDFForSigning, ilk aralığı <'den hemen önce bitirir ve ikincisini >'den hemen sonra başlatır; CMS imzalama pipeline'ının içindeki akış hazırlığı aynı offset'leri hesaplar. İmza sözlüğündeki /ByteRange yer tutucusu sabit genişlikli bir literal dizgedir; bu yüzden gerçek sayıları yamalamak tek bir baytı bile kaydırmaz ve çapraz başvuru tablosu geçerli kalır. Dört değerin her biri on karakterlik bir alanda sağa yaslıdır; bu yüzden bu şekilde imzalanan bir dosya, /ByteRange ['dan sonra boşluk dizileri gösterir. O dolgunun bedelini, kendi bağımsız doğrulayıcımızı çalıştırırken bir kez ödedik: ilk sürüm dört sayıyı tek boşluklarla böldü ve hiçbir şey bulamadı; /Contents hex'i, sondaki sıfır dolgusu soyulduktan sonra ancak gerçek CMS baytlarını üretti

İki bayt, kim ürettiyse üretsin, imzalı herhangi bir dosyayı kendiniz kontrol etmek için yeterlidir. ByteRange[1] offset'indeki bayt < olmalı ve ByteRange[2] - 1 offset'indeki bayt > olmalıdır. Aşağıdaki yardımcı kütüphanenin parçası değildir; bir denetim aracına bırakabileceğiniz bir düzine satırdır ve GetLoadedSignatureInfo'dan alınan ByteRange dizisiyle beslenir

// Kendi denetim kodunuz için önerilen yardımcı, bir HotPDF API'si değil
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];               // boşluğun ilk baytı
    if (FS.Read(B, 1) <> 1) or (B <> '<') then Exit;
    FS.Position := BR[2] - 1;           // boşluğun son baytı
    if (FS.Read(B, 1) <> 1) or (B <> '>') then Exit;
    Result := True;
  finally
    FS.Free;
  end;
end;

// Kullanım, Pdf.LoadFromFile('Signed.pdf') çağrısından sonra:
//   if not GapIsSpecLayout('Signed.pdf',
//     Pdf.GetLoadedSignatureInfo(0).ByteRange) then
//     Writeln('Köşeli parantezler imzalı aralıkların içinde');

Kriptografik yarı için OpenSSL, CMS'yi bağımsız doğrular: iki aralığı tek bir dosyada birleştirin ve dış içerik olarak geçirin; örneğin openssl cms -verify -binary -inform DER -in contents.der -content signed-ranges.bin -noverify. O komut, digest'i ve imzayı, ona verdiğiniz baytların tam kendisi üzerinde kontrol eder. Boşluğu hiç görmez; yukarıdaki iki baytlık kontrol hâlâ sizin işinizdir

HotPDF'te doğru doldurulmuş bir PDF imza ByteRange anatomisi: ilk aralık dosyayı sıfırıncı bayttan kapsar, boşluk küçüktür-büyüktür sınırlayıcıları dahil tam /Contents hex dizgesini taşır, ikinci aralık trailer'ı sona kadar kapsar ve ByteRange[1] ile ByteRange[2] - 1 üzerindeki iki tek-baytlık kontrol düzeni herhangi bir imzalı dosyada teyit eder
Sınırlayıcılar imzalı aralıkların dışında durur; böylece digest yalnızca basamakları kapsar ve boşluk bayt bayt doğrulanabilir

Boş olmayan boşluk kontrolü imza wrapping'i neden göremez?

Boş olmayan bir boşluk, digest'ten bir şey çıkarıldığını kanıtlar ve ne çıkarıldığı hakkında hiçbir şey söylemez. Saldırı yüzeyinin tamamı budur. /Contents yer tutucusu binlerce sıfır basamakla rezerve edilir ve gerçek bir CMS kabı onu nadiren doldurur. Bir saldırgan, o dolgunun içinde hex dizgesini bir > ile erken kapatır, rezerve alanın kalanına yeni nesneler ya da bütün bir uydurma revizyon yazar ve byte aralıklarına dokunmaz. CMS yine doğrulanır, çünkü imzalı her bayt değişmemiştir. Aralıklar hâlâ 0'dan dosya boyutuna uzanır. "Boşluk boş değil"de duran bir doğrulayıcı, CoversWholeDocument True ayarlı svValid rapor eder; oysa dosyayı açan herhangi bir PDF ayrıştırıcısı, imzasız delikte oturan hangi nesneler varsa onları izler

THotPDF.VerifyLoadedSignatureEx, boşluğu doğrulanacak veri sayar. CMS kontrolü geçtikten sonra doğrulayıcı boşluğu okur, sınırlayıcıları soyar ve yalnızca hex basamaklarını artı beş PDF boşluk baytını (tab, line feed, form feed, carriage return, space) kabul eder. Çözülen basamaklar daha sonra, imza sözlüğünün kendi /Contents'ine bayt bayt eşit olmalıdır. Başıboş bir >, tek bir ikili bayt ya da bir bayt fazla ya da eksik çözülen bir değer, sonucu svInvalidByteRange'e çevirir; 64 MiB'den büyük bir boşluk da öyle. Aynı kontrol ValidateLoadedSignatureBatch içinde de çalışır; VerifyAllLoadedSignatures ile VerifyLoadedSignatureWithTrust, tek-imza yolundan geçer ve onu aynı şekilde miras alır

Tek bir düzen bilerek geçirilir: imzalayanın köşeli parantezleri imzalı aralıkların içinde tuttuğu, boşluğun yalnızca basamakları taşıdığı dosyalar. Onlar için doğrulayıcı, boşluğun hemen öncesindeki baytın <, hemen sonrasındaki baytın > olduğunu teyit eder, sonra aynı basamak-ve-boşluk testini uygular. O düzeni reddetmek hiçbir güvenlik satın almaz — boşluk yine de imza değerinden başka bir şey içermez — ve sapasağlam duran arşivlenmiş sözleşmeleri başarısız kılardı. Onu kabul etmek doğru varsayılandır

İmza wrapping, Delphi'de gevşek kontrol edilmiş bir PDF ByteRange'i nasıl sömürür: saldırgan hex dizgesini binlerce rezerve sıfır basamağının içinde erken kapatır, kapsanan hiçbir bayta dokunmadan uydurma bir revizyonu imzasız boşluğa yazar ve boş olmayan boşluk kontrolü hâlâ CoversWholeDocument true ile svValid rapor eder — HotPDF'in boşluğu bayt bayt doğrulamasının nedeni budur
Boş olmayan bir boşluk, digest'ten bir şey çıkarıldığını yalnızca kanıtlar, neyi değil — dolgulu delik, saldırı yüzeyinin tamamıdır
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;

Hem GetLoadedSignatureFieldCount hem de VerifyLoadedSignatureEx'e geçirilen indeks, form-alanı sırasındaki imza alanlarını 0'dan başlayarak sayar. Karşı imzalı bir dosyada tedarikçinin imzası, CoversWholeDocument = False ve pozitif bir UnsignedTrailingBytes ile ilk dala düşer: ondan sonra eklenen her şey, onaylayanın revizyonu dahil. Bu API'nin temelleri size yeni ise HotPDF ile PDF dijital imzalarını doğrulama kılavuzu, durum değerlerini ve info kaydını daha derinden kapsar

AddLoadedSignedSignatureField ile karşı imza

Bir karşı imza dört çağrı alır: imzalı dosyayı BeginIncrementalUpdate ile açın, alanı AddLoadedSignedSignatureField ile ekleyin, yeni revizyonu SaveIncrementalUpdate ile yazın, sonra hazırlanan dosyayı THotPDF.SignPDFWithPFX sınıf fonksiyonuyla imzalayın. Sayfa düzeyindeki THPDFPage.AddSignedSignatureField burada uygulanmaz, çünkü CurrentPage bir artımlı güncelleme sırasında nil'dir; belge yüklenmiştir, yerleştirilmektedir değil. Yüklenen-belge metodu widget'ı mevcut bir sayfada kurar ve /V altına, yeni-belge yolunun kurduğu yer tutucu imza sözlüğünün aynısını asar; böylece iki imzalama yolu da özdeş baytlar görür. İlk imzanın kendisi için Delphi'de PAdES dijital imzaları oluşturma yazısı, PFX pipeline'ını adım adım gezer

var
  Pdf: THotPDF;
  FieldIndex: Integer;
begin
  Pdf := THotPDF.Create(nil);
  try
    Pdf.BeginIncrementalUpdate('Signed.pdf');
    // Sayfa 0, widget dikdörtgeni punto cinsinden, CMS için 8192 bayt rezerve
    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;

  // İlk doldurulmamış yer tutucuyu imzalar; PFX ya da kripto hatalarında yükseltir
  if not THotPDF.SignPDFWithPFX('Prepared.pdf', 'SignedTwice.pdf',
    'approver.pfx', 'pfx-password') then
    raise Exception.Create('Second signature failed');
end;

Parametre listesi kısadır ama her değerin görünür bir etkisi vardır. ContentsBytes 8192 varsayar ve çözülen CMS kabını boyutlandırır; diskteki yer tutucu, tabanı 64 bayt olmak üzere, onun iki katı hex basamağı tutar. SubFilter adbe.pkcs7.detached varsayar ve Reason, Location ile ContactName, alan kurulurken alınan bir /M zaman damgasının yanında, imza sözlüğünde /Reason, /Location ve /ContactInfo olarak biter. Dönüş değeri yeni alan indeksidir ya da sayfa indeksi aralık dışındayken -1'dir. Boş bir alan adı ya da sıfır genişlikli/yükseklikli bir dikdörtgen, hiçbir şey yazılmadan bir istisna yükseltir

Eklenen revizyon neyi taşır, neyi kendi hâline bırakır?

AddLoadedSignedSignatureField, kardaşlarından bilerek daha sessizdir. Diğer AddLoaded* alan kurucuları AcroForm üzerinde /NeedAppearances true ayarlar; bu, bir görüntüleyiciden dosyayı açarken alan görünüşlerini yeniden üretmesini ister. İmzalı bir belgede o yeniden üretim, ilk imzalayanın kapsadığı içeriği yeniden yazabilir. Bu yüzden yeni metot, bayrağı kaynak dosya hâlihazırda taşımıyorsa yine kaldırır ve /NeedAppearances ile gelmiş bir dosya onu tam olarak geldiği gibi tutar. /SigFlags mevcut bitlerini korur ve 3 kazanır — ISO 32000-1 §12.7.2 Tablo 219'dan SignaturesExist (1) artı AppendOnly (2)

Sayfa için MarkDirty'i kendi hâline bırakın. Artımlı modda yeni yaratılan nesneler otomatik yazılır ve yüklenen nesneler, bir şey onları işaretlediğinde yazılır. Widget'ı sayfanın /Annots'una ve AcroForm /Fields'ine eklemek, o dizileri sahiplenen dolaylı nesneleri zaten yeni revizyona koyar. Açık bir sayfa işareti, sayfa sözlüğünü /Annots dizisi ayrı bir nesnede otururken bile yanında sürükler ve revizyon analizi o zaman, bir imza alanından başka hiçbir şey içermemesi gereken bir revizyonda sayfa değişikliği raporlar

Yer tutucu sözlüğü /ByteRange'i /Contents'ten önce yazar. Hazırlanan dosyayı kendi araçlarınızla sonradan işliyorsanız o sıra önemlidir: PreparePDFForSigning önce /ByteRange nöbetçisini bulur, sonra ileriye doğru bir sonraki /Contents <'i arar. Anahtarları yer değiştirmiş bir sözlük, o ileri aramayı kendi hex dizgesinin ötesine ve dosyada ne varsa onun peşine yollardı

İlk imzalayan bir DocMDP ya da FieldMDP kısıtı uygulamışsa, 2. revizyonu yazmanın daha katı yolu SaveIncrementalUpdateAuthenticated'dir. Aynı dizinde bir aday dosyaya kaydeder, transform politikası taşıyan her imzayı doğrular, her birinden sonra bütün revizyonları değerlendirir ve adayı yalnızca her politika değişikliğe izin verdiğinde yayımlar. Kısıtsız bir sözleşmede sade SaveIncrementalUpdate işi daha az törenle yapar

Zaten imzalanmış bir PDF'i HotPDF Delphi ile karşı imzalama iş akışı: BeginIncrementalUpdate dosyayı açar, AddLoadedSignedSignatureField widget'ı kurar ve /Contents yer tutucusunu rezerve eder, SaveIncrementalUpdate ikinci bir revizyon ekler, SignPDFWithPFX onu doldurur; ilk imza UnsignedTrailingBytes ile geçerli kalırken yeni ByteRange bütün büyümüş dosyayı kapsar
Revizyon başına bir yer tutucu, her iki imzalama yolunda da aynı serileştirmeyle hazırlanıp yamanır — katı doğrulayıcının beklediği temiz düzen

Digest'i harici bir imzalayıcıya ya da HSM'ye vermek

Akıllı karttan, bir HSM'den ya da uzak bir imzalama servisinden gelen CMS'de iş akışında hiçbir şey değişmez; yalnızca son adım değişir. THotPDF.PreparePDFForSigning, hazırlanan baytlardaki /ByteRange'i yamar ve boşluğu eksiksiz /Contents dizgesi olan iki 0 tabanlı aralık döndürür; artı ContentsHexStart — AnsiString'teki ilk hex basamağının 1 tabanlı indeksi — ve ContentsHexLen. 0 tabanlı dosya offset'lerini 1 tabanlı dizge indeksleriyle karıştırmak, bu adımın klasik off-by-one'ıdır. Örnek, hiçbir şeyi hash'lemeden önce her iki sınırlayıcı konumunu assert eder

var
  Bytes, ToSign, CmsHex: AnsiString;
  R1Start, R1Len, R2Start, R2Len, HexStart, HexLen: Integer;
begin
  Bytes := LoadFileAsAnsiString('Prepared.pdf');   // sizin yardımcınız
  if not THotPDF.PreparePDFForSigning(Bytes, R1Start, R1Len,
    R2Start, R2Len, HexStart, HexLen) then
    raise Exception.Create('No signature placeholder found');

  // Önerilen akıl sağlığı kontrolleri (sizin olanlar, kütüphane çağrısı değil):
  // '<' 1. aralığı bitirir, '>' 2. aralığın hemen önünde durur
  Assert(Bytes[R1Start + R1Len + 1] = '<');
  Assert(Bytes[R2Start] = '>');

  ToSign := Copy(Bytes, R1Start + 1, R1Len) + Copy(Bytes, R2Start + 1, R2Len);
  CmsHex := SignDetachedWithHsm(ToSign);           // sizin CMS imzalayıcınız, hex DER
  if not THotPDF.InsertSignatureHexAt(Bytes, HexStart, HexLen, CmsHex) then
    raise Exception.Create('CMS does not fit the reserved space');
  SaveAnsiStringToFile(Bytes, 'SignedTwice.pdf');  // sizin yardımcınız
end;

Revizyon başına tam olarak bir yer tutucu hazırlayın. PreparePDFForSigning, bulduğu ilk yamalanmamış /ByteRange nöbetçisini yamar ve aynı revizyonda bırakılan ikinci bir yer tutucu, ilk imzanın kapsadığı baytların içinde oturur; onu sonra doldurmak o imzayı bozar. CMS'yi geri yazmak için kullanılacak çağrı, döndürülen offset'lerle InsertSignatureHexAt'tir. InsertSignatureHex, basamakları tamamen sıfır olan ilk /Contents dizgesini arar; tek boş yer tutuculu bir dosyada çalışır. Offset'ler elinizdeyken aranacak ve eşleşmeyecek hiçbir şey yoktur. Daha kısa bir CMS, kapanış >'sinden önce, sonda 0 ile doldurulur. Daha uzun biri, InsertSignatureHexAt'in dosya baytlarına dokunmadan False döndürmesine yol açar

Boşluk kontrolü neyi kanıtlar, neyi kanıtlamaz?

Boşluk kontrolü tek bir özel deliği kapatır. svValid hâlâ bayt bütünlüğü artı CMS'ye gömülü sertifikayla eşleşen bir imza demektir; o sertifikanın kabul ettiğiniz bir güven çapasına zincirlenip zincirlenmediği, güven çapalarınızı ve iptal kanıtlarınızı vererek VerifyLoadedSignatureWithTrust tarafından cevaplanır. Kaynak baytlar olmadan hiçbir şey hiçbir zaman svValid'e ulaşmaz. VerifyLoadedSignatureEx onları belgenin yüklendiği dosyadan okur ve akıştan yüklenen bir belge için svSourceUnavailable döndürür — orada VerifyLoadedSignature'ın TStream overload'u onları sizden alır

Karşı imzalı bir dosyadaki ilk imza için CoversWholeDocument doğru olarak False'tur. Eklenen revizyonun yalnızca bir imza mı eklediği yoksa sayfaları da mı değiştirdiği, HotPDF'te DocMDP, FieldMDP ve revizyon analizinde anlatılan AnalyzeLoadedSignatureRevisions'un sorusudur

Köşeli parantez düzeni, ISO TS 32004'ün tanımladığı ekli PDF MAC'ine (/MACLocation /AttachedToSig) de sızar; onun kontrolü, offset'leri dosyadaki < ve >'nin tam konumlarıyla karşılaştırır. HotPDF orada da iki düzeni kabul eder. Parantez-dahil offset'leri koduna gömmüş kendi yapımınız bir araç, §12.8.3.3 düzenine imzalanmış bir dosyayla karşılaştığında genelde ilk kırılan şeydir ve ilk bölümdeki iki baytlık yardımcıyı kendi aracınızın çıktısı üzerinde çalıştırmak bir dakika alır

Bu alandaki imza derdinin çoğu, imzalayan araç, karşı imza atan araç ve denetleyen araç, köşeli parantezlerin nereye gittiği konusunda anlaşamadığında başlar. Delphi ve C++Builder için native PDF bileşeni HotPDF, §12.8.3.3 düzenini her imzalama yolunda yazar, boşluğu her doğrulama yolunda bayt bayt kontrol eder ve karşı imzaları tek bir API'den temiz artımlı revizyonlar olarak ekler