on_key_secret_needed Event

Requests the key secret from the application.

Syntax

class DCAuthKeySecretNeededEventParams(object):
  @property
  def key_id() -> str: ...
  @property
  def key_secret() -> str: ...
  @key_secret.setter
  def key_secret(value) -> None: ...

# In class DCAuth:
@property
def on_key_secret_needed() -> Callable[[DCAuthKeySecretNeededEventParams], None]: ...
@on_key_secret_needed.setter
def on_key_secret_needed(event_hook: Callable[[DCAuthKeySecretNeededEventParams], None]) -> None: ...

Remarks

Subscribe to this event to pass the key secret (a pre-shared request authentication code) to the signing component when it is needed. The authentication combination consists of the KeyId, a non-secret unique key identifier, and the KeySecret, shared by the parties, which should be kept private. This event is an alternative for key_secret property. Use it when you expect to process requests from requestors with different KeyIds and secrets. If you only expect to receive requests from a single requestor with a known KeyId, providing the key secret via key_id and key_secret properties would be an easier route.