on_recipient_found Event

Informs the application that an archive is encrypted with a digital certificate.

Syntax

class ArchiveReaderRecipientFoundEventParams(object):
  @property
  def recipient_hash() -> bytes: ...
  @property
  def cert_found() -> bool: ...

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

Remarks

The class fires this event when processing archives encrypted with an X.509 certificate. CertFound indicates whether the matching certificate has been found in decryption_certificates collection.

This event is an opportunity to add the decryption certificate on a later stage if it was not known at the start of the processing.