SignatureValidityModel Data Type

Signature validity information associated with a signed signature field.

Properties
name data type description
validSignatureObject boolean Flag that indicates whether the signature object was readable. If there are any errors reading the signature object, this flag is set to false.
validSignatureHash boolean Flag that indicates whether the stored signature hash matches the calculated signature hash.
validRevocationList boolean Flag that indicates the status of the revocation list validity. When this is false, at least one of the certificates in the certificate chain has been revoked.
validExpiration boolean Flag that indicates whether the start and expiration dates on the signature are valid and within range.
validCertificateChain boolean Flag that indicates the validity of the certificate chain.
trustedChain boolean Flag that indicates whether the chain of certificates in the signature starts with a certificate from a trusted certificate authority (CA).
contentAppended boolean Flag that indicates if there has been any content appended to this PDF. If content has been appended, the signature does not cover the additional content, but might still be valid for the original content, if it has not been modified.
validByteRange boolean Flag that indicates whether the byte range in the signature covers the entire file, including the signature dictionary but excluding the signature value itself.
documentReconstructed boolean Flag that indicates whether there was a problem reading the xref table that resulted in the document being reconstructed.
documentTimestamp boolean Flag that indicates whether this signature is a document timestamp.
tsaTimestamp boolean Flag that indicates whether the signature has a timestamp from a timestamp authority.
validTimestampToken boolean Flag that indicates whether a timestamp token is valid, when present.
validTimestampCertificate boolean Flag that indicates whether the certificate of the timestamp token is valid, when present.
tsaTrustedChain boolean Flag that indicates whether the TSA certificate chain is trusted.
validPadesCertificate boolean Flag that indicates if this is a PAdES signature and the certificate is valid OR if this is not a PAdES signature. False if it's a PAdES signature with an invalid certificate.
validKeyUsage boolean Flag that indicates whether the key usage is valid. It is set to true when the KU field allows for signing documents.
validityText string A textual description of the state of the signature. This method looks at all the different flags and composes a human readable description of the validity of the signature.

Example

{
  "validSignatureObject" : true,
  "validSignatureHash" : true,
  "validRevocationList" : true,
  "validExpiration" : true,
  "validCertificateChain" : true,
  "trustedChain" : true,
  "contentAppended" : true,
  "validByteRange" : true,
  "documentReconstructed" : true,
  "documentTimestamp" : true,
  "tsaTimestamp" : true,
  "validTimestampToken" : true,
  "validTimestampCertificate" : true,
  "tsaTrustedChain" : true,
  "validPadesCertificate" : true,
  "validKeyUsage" : true,
  "validityText" : "..."
}