TsgcWebSocketProxyServer › イベント › OnAuthentication

OnAuthentication イベント

認証が有効になっているときに発生し、アプリケーションがユーザーとパスワードを確認してダウンストリームクライアント接続を承認または拒否できます。

構文

property OnAuthentication: TsgcWSAuthenticationEvent;
// TsgcWSAuthenticationEvent = procedure(Connection: TsgcWSConnection; aUser, aPassword: String; var Authenticated: Boolean) of object

デフォルト値

—

解説

OnAuthenticationは、Authentication.EnabledがTrueで認証方式が組み込みスキームのいずれか（Basic、Session、URL）の場合に、プロキシサーバーがダウンストリームクライアントから認証リクエストを受け取るたびに発生します。aUserとaPasswordパラメータはクライアントが提供した認証情報を保持します。Authenticatedをtrueに設定して接続を受け入れる（プロキシがその代わりにアップストリームTCPセッションを開く）か、Falseにして拒否します。ここで認証情報が検証されない場合、組み込みのAuthUsersリストがフォールバックとして使用されます。コンポーネントが認識しないカスタムスキーム（JWT Bearerトークンなど）にはOnUnknownAuthenticationを使用してください。

使用例

procedure OnAuthentication(Connection: TsgcWSConnection; aUser, aPassword: string;
  var Authenticated: Boolean);
begin
  if ((aUser = 'user') and (aPassword = 'secret')) then
    Authenticated := True
  else
    Authenticated := False;
end;

イベントに戻る