RdpGuard のカスタムアクション

• カスタムアクションについて
• 利用可能なアクション
• 新しいカスタムアクションを追加
• カスタムアクションの編集
• カスタムアクションの削除
• イベント設定

カスタムアクションでは、イベント発生時にメールや Telegram の通知、HTTP エンドポイントの呼び出し、スクリプトの実行ができます。たとえば、IP ブロック時やユーザーのログイン時にメールを送信できます。

SYSTEM 権限でプログラムを実行できるため、アクションの設定とテストには管理者権限が必要です。カスタムアクションのセキュリティ修正を参照してください。

イベント

以下のイベントに対応しています:

IP アドレスのブロックとIP アドレスのブロック解除のアクションは、ローカルで検出した試行に適用されます。IP Cloud のみによるブロックでは、これらのイベントは発生しません。

ツール, すべての IP アドレスのブロックを解除に対応するには、 すべての IP アドレスのブロック解除用のアクションを別途追加します。 このイベントで有効な各アクションは、操作が成功した後に 1 回実行されます。 ブロック一覧がすでに空の場合も実行されます。CLI の ip unblock * と ip unblock * all も同じイベントを発生させます。

一括解除では、アドレスごとのIP アドレスのブロック解除アクションは実行されません。 1 つのアドレスまたは 1 つのソースだけを解除しても、 すべての IP アドレスのブロック解除は発生しません。

カスタムアクション

以下のアクションに対応しています:

• メールを送信
• HTTP POST を送信
• プログラムを実行
• AbuseIPDB に報告
• Telegram メッセージを送信

変数

メールの件名と本文、HTTP POST リクエストの URL と本文、Telegram メッセージ、プログラムの引数に、以下の変数を使用できます:

• %IP% - IP アドレス
• %USER% - ユーザー名
• %DOMAIN% - Windows ドメイン
• %BLOCK_DATE% - サーバーのタイムゾーンでのブロック日時
• %UNBLOCK_DATE% - サーバーのタイムゾーンでのブロック解除日時
• %BLOCK_DATE_UTC% - UTC のブロック日時 (ISO 8601)
• %UNBLOCK_DATE_UTC% - UTC のブロック解除日時 (ISO 8601)
• %PROTOCOL% - プロトコル (理由)
• %TOTAL_IP_BLOCKED% - 現在ブロックされている IP アドレスの総数
• %HOSTNAME% - RdpGuard をインストールしたコンピューターのホスト名
• %NEW_VERSION_NUMBER% - 新しいバージョン番号
• %NEW_VERSION_LINK% - 新しいバージョンのダウンロードリンク
• %MAINTENANCE_DAYS% - 保守の残り日数

UTC 変数は固定の ISO 8601 形式 yyyy-MM-ddTHH:mm:ssZ を使用します。例: 2026-09-14T09:30:00Z。末尾の Z は UTC を示します。この形式はサーバーの地域設定に依存しません。%BLOCK_DATE% と %UNBLOCK_DATE% は、引き続きローカル時刻と地域設定の日時形式を使用します。

2 つのブロック解除変数は、自動解除の予定時刻を示します。

すべての IP アドレスのブロック解除では、%HOSTNAME% と %TOTAL_IP_BLOCKED% を使用できます。個別のアドレス、ユーザー、プロトコル、 ブロック日時や解除日時の変数は、このイベントでは使用できません。

メールを送信

このアクションは、登録済みの SMTP サーバー経由でメールを送信します。

以下の項目を設定できます:

SMTP サーバー - メール送信に使うサーバーを選択します。

一覧の隣の ... ボタンで、SMTP サーバーを追加・編集できます。

差出人 - 送信者のメールアドレス

宛先 - 受信者のメールアドレス

件名 - メールの件名。上記の変数を使用できます。

本文 - メールの本文。上記の変数を使用できます。

HTTP POST リクエストを送信

選択したイベントが発生するたびに、指定した URL へ HTTP POST リクエストを送信します。

以下の項目を設定できます:

エンドポイント - 送信先 URL。サーバー名の後にコロンで区切ってポートを指定できます。例: https://server.com:443/page.aspx。

HTTP Basic 認証を有効にする - パスワード認証を有効にします。この認証方式自体はユーザー名とパスワードを暗号化しないため、TLS/SSL 接続を推奨します。

ユーザー名 - HTTP Basic 認証のユーザー名

パスワード - HTTP Basic 認証のパスワード

POST 本文 - サーバーに送信する HTTP POST リクエストの本文。上記の変数を使用できます。

プログラムを実行

選択したイベントが発生すると、プログラムまたはスクリプトを実行します。

以下の項目を設定できます:

プログラムまたはスクリプト - 実行するプログラムまたはスクリプト

引数 - プログラムの引数。上記の変数を使用できます。

タイムアウト (秒) - 待機時間を秒で指定します。0 は無制限です。

タイムアウト時にプログラムを終了 - 時間切れでプログラムの終了を試みます。オフの場合、RdpGuard は時間超過を記録し、プログラムの終了を待ちます。

最大 8 つのプログラムを同時に実行できます。他のアクションは別のキューを使うため、処理の遅いプログラムが通知を遅らせることはありません。

AbuseIPDB に報告

ブロックした IP を AbuseIPDB に報告します。このアクションはIP アドレスのブロックイベントでのみ使用できます。

以下の項目を設定できます:

API キー - AbuseIPDB の API キー

Telegram メッセージを送信

Telegram のチャットまたはチャンネルにメッセージを送信します。

以下の項目を設定できます:

• ボットトークン - Telegram ボットのトークン
• チャット - 一覧から Telegram チャットまたはチャンネルを選択します。
• メッセージ - 送信するメッセージ。変数を使用できます。

手順に従って Telegram ボットを作成し、トークンを取得してください。

一覧にチャットを表示するには、ボットとの会話を開始してチャットを取得をクリックします。

1. ツール, カスタムアクション / 通知をクリックします。

   

   カスタムアクションダイアログが開きます:

   

2. 追加をクリックします (または Insert キーを押します)。

   新しいカスタムアクションを追加ダイアログが開きます:

   

3. イベントを選択します:

4. タスクを選択します。

5. カスタムアクションを設定します。

6. アクションを追加をクリックし、続いてカスタムアクションで変更を保存をクリックします。

1. ツール, カスタムアクション / 通知をクリック

   

   カスタムアクションダイアログが開きます:

   

2. 変更するアクションを選択し、編集をクリックします (または F2 キーを押します)。

   カスタムアクションを編集ダイアログが開きます:

   

3. カスタムアクションの設定を変更します。

4. 編集画面で変更を保存をクリックし、カスタムアクションでも変更を保存します。

一時的に無効にするには、表のチェックボックスをオフにして変更を保存をクリックします。

1. ツール, カスタムアクション / 通知をクリック

   

   カスタムアクションダイアログが開きます:

   

2. 削除するアクションを選択し、削除をクリックします (または Delete キーを押します)。

3. カスタムアクションで変更を保存をクリックします。

ログイン失敗とユーザーのログインには追加設定があります。

ログイン失敗

ログイン失敗を使うと、IP アドレスがブロックのしきい値に達する前に、検出時点で通知やスクリプトの実行ができます。

カスタムアクションを追加し、イベント一覧でログイン失敗を選択して、隣の設定...をクリックします。

イベント設定ダイアログが開きます:

プロトコル:すべてのプロトコル (既定) または選択したプロトコルを選び、対象を指定します。有効な保護モジュールのみがイベントを生成し、その検出除外ルールも引き続き適用されます。

その他の検出された脅威も含める - ログイン失敗に加え、HTTP スキャン、SMTP のスパムやリレー試行、SQL スキャンなどの検出も対象にします。

ホワイトリストのIPアドレスからの試行を無視する - 許可リストのアドレスからの試行を除外します。既定ではオフのため、これらのアドレスについても通知を受け取れます。

除外ルール: 1 行に 1 つ入力します。たとえば、TargetUserName=backup-service はそのアカウントへの試行を除外します。IpAddress、TargetUserName、TargetDomainName、Protocol を使用できます。いずれかに一致するとこのアクションを実行しませんが、ブロックルールは変わりません。除外ルールの構文を参照してください。

繰り返し通知を制限する - オンにして秒または分単位で間隔を指定します。最初の一致で直ちに実行し、同じ IP アドレス・プロトコルからの試行では、指定時間内は再実行しません。制限はアクションごとに適用されます。オフの場合は、一致する試行ごとに実行します。

変更を保存をクリックし、通知またはスクリプトを設定して、アクションとアクション一覧を保存します。メッセージには %IP%、%USER%、%PROTOCOL%、%HOSTNAME% を使用できます。

ユーザーのログイン

ログイン成功通知を設定するには、カスタムアクションを追加し、ユーザーのログインを選択して、イベント一覧の隣の設定...をクリックします。

ログイン成功の除外ルールダイアログが開きます:

ここでログイン成功の除外を設定できます。詳細は除外ルールの構文を参照してください。