SecureBlackbox 2020 Qt Edition

Questions / Feedback?

SignatureFound Event

Signifies the start of signature validation.

Syntax

class MessageVerifierSignatureFoundEventParams {
public:
  const QString &IssuerRDN();
  const QByteArray &SerialNumber();
  const QByteArray &SubjectKeyID();
  bool CertFound();
  bool ValidateSignature();
  void SetValidateSignature(bool bValidateSignature);
  bool ValidateChain();
  void SetValidateChain(bool bValidateChain);
  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};
// To handle, connect one or more slots to this signal. void SignatureFound(MessageVerifierSignatureFoundEventParams *e);
// Or, subclass MessageVerifier and override this emitter function. virtual int FireSignatureFound(MessageVerifierSignatureFoundEventParams *e) {...}

Remarks

This event tells the application that signature validation is about to start, and provides the details about the signer's certificate via its IssuerRDN, SerialNumber, and SubjectKeyID parameters. It fires for every signature located in the verified document or message.

The CertFound is set to True if the class has found the needed certificate in one of the known locations, and to False otherwise, in which case you must provide it manually via KnownCertificates property.

Signature validation consists of two independent stages: cryptographic signature validation and chain validation. Separate validation results are reported for each, with SignatureValidationResult and ChainValidationResult properties respectively.

Use the ValidateSignature and ValidateChain parameters to tell the verifier which stages to include in the validation.

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox 2020 Qt Edition - Version 20.0 [Build 8154]