Enregistrement THPDFPDFMACValidationInfo

Résultat complet d'une validation de MAC PDF : statut et message, longueurs de plage d'octets et de MAC, détails de digest et de politique, usage d'AES-GCM, emplacement du MAC, lien de signature et drapeaux de couverture des permissions

Déclaration

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

Champs

Champ	Objectif
`Status`	Verdict `THPDFPDFMACStatus`, `pmsValid` quand le MAC se vérifie et états d'échec spécifiques sinon
`ByteRangeLength`	Nombre d'octets du fichier couverts par le `/ByteRange` du MAC
`MACLength`	Longueur de la valeur de MAC encodée
`DigestAlgorithm`	Algorithme de digest avec lequel le MAC vérifié a été construit
`PolicyProfile`	`THPDFPDFMACPolicyProfile` sous lequel le MAC a été évalué
`PolicyAccepted`	`true` quand la politique de digest et d'AES-GCM des options fournies a accepté le MAC
`UsedAESGCM`	`true` quand la charge utile du MAC était protégée par AES-GCM
`Message`	Texte d'issue lisible, par exemple que le MAC est valide, ou la raison pour laquelle il ne l'est pas
`Location`	`THPDFPDFMACLocation` : MAC autonome ou MAC attaché à une signature
`SignatureObjectNumber` / `SignatureGeneration`	Référence d'objet de la signature à laquelle le MAC s'attache, significative quand `Location` rapporte un MAC attaché
`SignatureDigestMatched`	`true` quand le digest d'un MAC attaché a correspondu au digest d'octets de sa signature
`FullFileCoverage`	`true` quand la plage d'octets couvre tout le fichier
`PermissionsAuthenticated`	`true` quand les bits de permission du document étaient couverts par le MAC
`MACRequiredByPermissions`	`true` quand les permissions du document exigent un MAC, si bien qu'un MAC absent est en soi un échec de validation

Notes d'utilisation

Rempli par THotPDF.ValidatePDFMAC et par le validateur par révision ; l'enregistrement est réinitialisé avant usage, inspectez-le donc même quand la fonction renvoie false
Vérifiez d'abord Status, puis PolicyAccepted pour distinguer un MAC cryptographiquement bon qui échoue à votre profil d'un MAC cassé
Pour les MAC attachés, lisez SignatureObjectNumber avec SignatureDigestMatched pour confirmer que le MAC couvre les mêmes octets que ceux signés par la signature

Enregistrement THPDFPDFMACValidationInfo

Déclaration

Unité

Champs

Notes d'utilisation

API associées