THPDFSignatureInfo Record

Opisuje jeden wczytany podpis PDF: od tożsamości certyfikatów, przez pokrycie zakresów bajtów, po werdykt weryfikacji

Deklaracja

THPDFSignatureInfo= record
  FieldName: AnsiString;       // signature form field partial name
  SubFilter: AnsiString;       // /SubFilter of the signature dictionary
  SignerName: AnsiString;      // CN of the signer certificate subject
  SubjectDN: AnsiString;       // rendered subject distinguished name
  IssuerDN: AnsiString;        // rendered issuer distinguished name
  SerialNumberHex: AnsiString; // certificate serial number, hex encoded
  ValidFrom: TDateTime;        // certificate notBefore (0 when absent)
  ValidTo: TDateTime;          // certificate notAfter (0 when absent)
  SigningTime: TDateTime;      // signed attribute 1.2.840.113549.1.9.5,
                               // else the /M entry, else 0
  HashAlgorithm: AnsiString;   // SHA-1, SHA-2, SHA-3, or SHAKE256
  DigestAlgorithmOID: AnsiString;
  DigestConsistencyIssue: THPDFCMSDigestConsistencyIssue;
  SignaturePolicy: THPDFSignaturePolicyInfo;
  Reason: AnsiString;          // /Reason from the signature dictionary
  Location: AnsiString;        // /Location
  ContactInfo: AnsiString;     // /ContactInfo
  ByteRange: array of Int64;   // /ByteRange pairs (offset, length, ...)
  CoversWholeDocument: boolean; // ByteRange spans the file except /Contents
  SignedRevisionLength: Int64; // source prefix covered by this signature
  UnsignedTrailingBytes: Int64; // bytes appended after the signed revision
  CertificateTimeValidity: THPDFSignatureTimeValidity;
  Status: THPDFSignatureVerifyStatus;
  PublicKeyAlgorithm: AnsiString; // RSA, ECDSA, EdDSA, or ML-DSA
  SignatureAlgorithm: AnsiString; // CMS signature algorithm name
  SignatureAlgorithmOID: AnsiString;
  CurveName: AnsiString;          // ECDSA curve, such as 'P-256'
  Timestamp: THPDFTimestampInfo;  // RFC 3161 signature or document timestamp
  CMSAttributes: THPDFCMSAttributeSummary;
  CertificateValidation: THPDFCertificateValidationInfo;
end;

Jednostka

HPDFSignVerify

Pola

Uwagi dotyczące użycia

• GetLoadedSignatureInfo zwraca pola opisowe; VerifyLoadedSignature i VerifyLoadedSignatureEx wypełniają pola statusu i walidacji po sprawdzeniu digestów
• CoversWholeDocument razem z UnsignedTrailingBytes pokazuje, czy późniejsze rewizje zmieniły dokument po podpisaniu
• Ten sam rekord zasila walidację certyfikatów, więc jedno wywołanie obejmuje tożsamości, pokrycie, algorytmy i sprawdzenie łańcucha

Powiązane API

• THotPDF GetLoadedSignatureInfo Method
• THotPDF VerifyLoadedSignatureEx Method
• Raporty walidacji CMS