THPDFPDFMACValidationInfo Record

Pełny wynik walidacji PDF MAC: status i komunikat, długości ByteRange i MAC, szczegóły skrótu i polityki, użycie AES-GCM, lokalizacja MAC, powiązanie z podpisem i flagi pokrycia uprawnień

Deklaracja

THPDFPDFMACValidationInfo= record
  Status: THPDFPDFMACStatus;
  ByteRangeLength: Int64;
  MACLength: Integer;
  DigestAlgorithm: THPDFPDFMACDigestAlgorithm;
  PolicyProfile: THPDFPDFMACPolicyProfile;
  PolicyAccepted: boolean;
  UsedAESGCM: boolean;
  Message: string;
  Location: THPDFPDFMACLocation;
  SignatureObjectNumber: Integer;
  SignatureGeneration: Integer;
  SignatureDigestMatched: boolean;
  FullFileCoverage: boolean;
  PermissionsAuthenticated: boolean;
  MACRequiredByPermissions: boolean;
end;

Jednostka

HPDFDoc

Pola

Pole	Przeznaczenie
`Status`	Werdykt `THPDFPDFMACStatus`: `pmsValid`, gdy MAC się zgadza, a w przeciwnym razie konkretne stany błędu
`ByteRangeLength`	Liczba bajtów pliku pokrytych przez `/ByteRange` MAC-a
`MACLength`	Długość zakodowanej wartości MAC
`DigestAlgorithm`	Algorytm skrótu, którym zbudowano sprawdzany MAC
`PolicyProfile`	`THPDFPDFMACPolicyProfile`, według którego oceniano MAC
`PolicyAccepted`	`true`, gdy polityka skrótu i AES-GCM z podanych opcji zaakceptowała MAC
`UsedAESGCM`	`true`, gdy ładunek MAC był chroniony przez AES-GCM
`Message`	Tekst wyniku czytelny dla człowieka, na przykład że MAC jest ważny, albo powód, dla którego nie jest
`Location`	`THPDFPDFMACLocation`: MAC samodzielny albo przypięty do podpisu
`SignatureObjectNumber` / `SignatureGeneration`	Referencja obiektu podpisu, do którego przypięto MAC; ma znaczenie, gdy `Location` raportuje MAC przypięty
`SignatureDigestMatched`	`true`, gdy skrót przypiętego MAC-a zgadzał się ze skrótem bajtów jego podpisu
`FullFileCoverage`	`true`, gdy zakres bajtów obejmuje cały plik
`PermissionsAuthenticated`	`true`, gdy bity uprawnień dokumentu były pokryte przez MAC
`MACRequiredByPermissions`	`true`, gdy uprawnienia dokumentu wymagają MAC-a, więc jego brak jest sam w sobie błędem walidacji

Uwagi dotyczące użycia

Wypełniany przez THotPDF.ValidatePDFMAC i walidator pojedynczej rewizji; rekord jest zerowany przed użyciem, więc przejrzyj go nawet, gdy funkcja zwróci false
Najpierw sprawdź Status, potem PolicyAccepted, aby odróżnić kryptograficznie poprawny MAC odrzucony przez Twój profil od MAC-a uszkodzonego
Dla przypiętych MAC-ów czytaj SignatureObjectNumber razem z SignatureDigestMatched, aby potwierdzić, że MAC pokrywa te same bajty, które podpisał podpis

THPDFPDFMACValidationInfo Record

Deklaracja

Jednostka

Pola

Uwagi dotyczące użycia

Powiązane API