on_encryption_info Event

Reports early information on encryption parameters.

Syntax

class PGPReaderEncryptionInfoEventParams(object):
  @property
  def key_i_ds() -> str: ...
  @property
  def integrity_protected() -> bool: ...
  @property
  def passphrase_used() -> bool: ...

# In class PGPReader:
@property
def on_encryption_info() -> Callable[[PGPReaderEncryptionInfoEventParams], None]: ...
@on_encryption_info.setter
def on_encryption_info(event_hook: Callable[[PGPReaderEncryptionInfoEventParams], None]) -> None: ...

Remarks

The class fires this event to report early encryption information. Use this event to find out what encryption type is used, and to provide appropriate decryption material (the secret keys or the password) via decrypting_keys or passphrase properties.

KeyIDs contains the IDs of the keys that can be used to decrypt the data. PassphraseUsed shows if the message can also be decrypted with a passphrase. Both can be set at the same time, indicating that each of the decryption routes can be taken.

IntegrityProtected parameter specifies whether the message includes a modification detection record.