TsgcWSPClient_MQTTメソッド › Auth

Auth メソッド

ブローカーとの拡張認証を実行または継続するために MQTT 5.0 AUTH パケットを送信します。

構文

procedure Auth(aReAuthenticate: Boolean; aAuthProperties: TsgcWSMQTTAuth_Properties = nil);

パラメータ

名前タイプ説明
aReAuthenticateBooleanTrue の場合、既に接続されているセッションで再認証をトリガーします。False の場合、初期のチャレンジ/レスポンスハンドシェイクの一部として AUTH パケットを送信します。
aAuthPropertiesTsgcWSMQTTAuth_Propertiesオプションの MQTT 5.0 AUTH プロパティ(認証方式、認証データ、理由文字列、ユーザープロパティ)。コンポーネントに設定された値を再利用するには nil を渡してください。

解説

SCRAM や Kerberos などの拡張認証メソッドをネゴシエートした MQTT 5.0 セッションでのみ利用できます。ブローカーは OnMQTTAuth イベントを通じて返信し、そこでアプリケーションは交換が成功または失敗するまで次の認証データブロブを提供します。MQTT 3.1.1 接続で Auth を呼び出しても効果がありません。

使用例

oAuthProps := TsgcWSMQTTAuth_Properties.Create;
try
  oAuthProps.AuthenticationMethod := 'SCRAM-SHA-256';
  oAuthProps.AuthenticationData := vClientFinalMessage;
  MQTT.Auth(False, oAuthProps);
finally
  oAuthProps.Free;
end;

メソッドに戻る