UnknownKeyReceived Event

Signals that the server has introduced itself with an unknown key.

Syntax

type TUnknownKeyReceivedEvent = procedure (
  Sender: TObject;
  const Algorithm: String;
  Bits: Integer;
  const FingerprintSHA256: String;
  var Action: Integer
) of Object;

property OnUnknownKeyReceived: TUnknownKeyReceivedEvent read FOnUnknownKeyReceived write FOnUnknownKeyReceived;

Remarks

The component fires this event to tell the application that the server has introduced itself with a key not present in TrustedKeysFile. The details of the key are provided. In this event handler, you need to make a decision whether to proceed with the connection.

Use ServerKey to access more key details.

Use Action to tell the component what it should do with the key, supported values: catAcceptOnce = 1, catAcceptPermanently = 2, catReject = 3. Note that accepting an unknown and unchecked key may be risky.