Registro THPDFPDFMACValidationInfo

Resultado completo de una validación de MAC PDF: estado y mensaje, longitudes de byte range y del MAC, detalles de digest y política, uso de AES-GCM, ubicación del MAC, enlace con la firma y flags de cobertura de permisos

Declaración

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;

Unidad

HPDFDoc

Campos

Campo	Propósito
`Status`	Veredicto `THPDFPDFMACStatus`, `pmsValid` cuando el MAC pasó la comprobación y estados de fallo específicos en caso contrario
`ByteRangeLength`	Número de bytes del archivo cubiertos por el `/ByteRange` del MAC
`MACLength`	Longitud del valor del MAC codificado
`DigestAlgorithm`	Algoritmo de digest con el que se construyó el MAC comprobado
`PolicyProfile`	`THPDFPDFMACPolicyProfile` bajo el cual se evaluó el MAC
`PolicyAccepted`	`true` cuando la política de digest y AES-GCM de las opciones suministradas aceptó el MAC
`UsedAESGCM`	`true` cuando la carga del MAC estaba protegida con AES-GCM
`Message`	Texto de resultado legible, por ejemplo que el MAC es válido, o el motivo por el que no lo es
`Location`	`THPDFPDFMACLocation`: MAC independiente o adjunto a una firma
`SignatureObjectNumber` / `SignatureGeneration`	Referencia de objeto de la firma a la que se adjunta el MAC, con sentido cuando `Location` informa de un MAC adjunto
`SignatureDigestMatched`	`true` cuando el digest de un MAC adjunto coincidió con el digest de bytes de su firma
`FullFileCoverage`	`true` cuando el rango de bytes cubre el archivo completo
`PermissionsAuthenticated`	`true` cuando los bits de permiso del documento estuvieron cubiertos por el MAC
`MACRequiredByPermissions`	`true` cuando los permisos del documento exigen un MAC, de modo que su ausencia es en sí misma un fallo de validación

Notas de uso

Lo rellenan THotPDF.ValidatePDFMAC y el validador por revisión; el registro se reinicia antes de usarse, así que inspéctionelo incluso cuando la función devuelva false
Compruebe primero Status y luego PolicyAccepted para distinguir un MAC criptográficamente bueno que falla su perfil de uno roto
Para los MAC adjuntos, lea SignatureObjectNumber junto con SignatureDigestMatched para confirmar que el MAC cubre los mismos bytes que firmó la firma

Registro THPDFPDFMACValidationInfo

Declaración

Unidad

Campos

Notas de uso

APIs relacionadas