SecureBlackbox 2020 Python Edition

Questions / Feedback?

on_signature_found Event

Signifies the start of signature validation.

Syntax

class ArchiveReaderSignatureFoundEventParams(object):
  @property
  def issuer_rdn() -> str: ...
  @property
  def serial_number() -> bytes: ...
  @property
  def subject_key_id() -> bytes: ...
  @property
  def cert_found() -> bool: ...
  @property
  def validate_signature() -> bool: ...
  @validate_signature.setter
  def validate_signature(value) -> None: ...
  @property
  def validate_chain() -> bool: ...
  @validate_chain.setter
  def validate_chain(value) -> None: ...

# In class ArchiveReader:
@property
def on_signature_found() -> Callable[[ArchiveReaderSignatureFoundEventParams], None]: ...
@on_signature_found.setter
def on_signature_found(event_hook: Callable[[ArchiveReaderSignatureFoundEventParams], None]) -> None: ...

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 signature_validation_result and chain_validation_result 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 Python Edition - Version 20.0 [Build 8154]