THPDFPDFMACValidationInfo Record

Risultato completo di una validazione di MAC PDF: stato e messaggio, lunghezze di byte range e MAC, dettagli di digest e politica, uso di AES-GCM, posizione del MAC, collegamento alla firma e flag di copertura dei permessi

Dichiarazione

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;

Unità

HPDFDoc

Campi

Campo	Scopo
`Status`	Verdetto `THPDFPDFMACStatus`, `pmsValid` quando il MAC passa i controlli e stati di fallimento specifici altrimenti
`ByteRangeLength`	Numero di byte del file coperti dal `/ByteRange` del MAC
`MACLength`	Lunghezza del valore MAC codificato
`DigestAlgorithm`	Algoritmo di digest con cui il MAC controllato è stato costruito
`PolicyProfile`	`THPDFPDFMACPolicyProfile` sotto cui il MAC è stato valutato
`PolicyAccepted`	`true` quando la politica di digest e AES-GCM delle opzioni fornite ha accettato il MAC
`UsedAESGCM`	`true` quando il payload del MAC era protetto con AES-GCM
`Message`	Testo dell'esito leggibile, per esempio che il MAC è valido, o il motivo per cui non lo è
`Location`	`THPDFPDFMACLocation`: MAC autonomo o allegato a una firma
`SignatureObjectNumber` / `SignatureGeneration`	Riferimento d'oggetto della firma a cui il MAC si allega, significativo quando `Location` riporta un MAC allegato
`SignatureDigestMatched`	`true` quando il digest di un MAC allegato corrisponde al digest dei byte della sua firma
`FullFileCoverage`	`true` quando il byte range copre l'intero file
`PermissionsAuthenticated`	`true` quando i bit di permesso del documento erano coperti dal MAC
`MACRequiredByPermissions`	`true` quando i permessi del documento esigono un MAC, per cui un MAC assente è di per sé un fallimento di validazione

Note sull'utilizzo

Riempito da THotPDF.ValidatePDFMAC e dal validatore per revisione; il record viene azzerato prima dell'uso, quindi ispezionalo anche quando la funzione restituisce false
Controlla prima Status, poi PolicyAccepted per distinguere un MAC crittograficamente buono che fallisce il tuo profilo da uno rotto
Per i MAC allegati, leggi SignatureObjectNumber insieme a SignatureDigestMatched per confermare che il MAC copre gli stessi byte firmati dalla firma

THPDFPDFMACValidationInfo Record

Dichiarazione

Unità

Campi

Note sull'utilizzo

API correlate