プレイブック

Zen がアプリ内で不審な挙動を検知したときに IP を自動的にブロックします。

プレイブックは Zen Firewall の自動化ルールです。各プレイブックはイベントとアクションを 1 つずつ組み合わせます。Zen がそのイベントを検知すると、代わりにそのアクションを実行します。誰かがダッシュボードを見張っている必要はありません。

プレイブックは 1 文で表せます: 攻撃の波を検知 → IP を 30 分間ブロック.

プレイブックは早期アクセス機能です。 サポートに問い合わせる ワークスペースで有効化してもらうために。

プレイブックを作成

1. Zen Firewall アプリを開き、 プレイブック タブを選択します。
2. クリックします プレイブックを追加.
3. 次の項目の下で 次の場合、プレイブックをトリガーするイベントを選択します。
4. 次の項目の下で 設定、アクションとその継続時間を選択します。
5. クリックします プレイブックを作成.

When トリガーと Configure action を含むプレイブック作成ダイアログ。

プレイブックは作成するとすぐに有効になります。

Playbooks タブで、攻撃の波の後に IP を 30 分間ブロックする有効なプレイブックが一覧表示されます。

イベント

プレイブックはイベントに反応します。アプリケーションコードから独自のイベントを送ることも、Zen が標準で検知するイベントを使うこともできます。

カスタムイベント

アプリケーションコードからイベントを報告するには trackを使うと、アプリだけが知っていることにもプレイブックが反応できます。例: ログイン失敗、無効なクーポンコード、パスワードリセットのリクエスト、拒否された API キー、支払い失敗。

呼び出す track そのイベントがリクエスト処理中に発生する場所ならどこでも、イベント名を付けて

Node.js

const Zen = require("@aikidosec/firewall");

// Inside any request handler
Zen.track("your.event_name");

Go

// Inside any HTTP handler, pass the request context
zen.Track(r.Context(), "your.event_name")

Ruby

# Inside any request, for example a Rails controller action
Aikido::Zen.track("your.event_name")

イベント名はどんな形式でも構いません。小文字でドット区切りの名前を推奨します。たとえば user.login_failed または coupon.invalid.

を追加した後、 trackイベントを 1 回発生させます。すると、プレイブック作成時に選べるイベントとして表示されます。 track を呼び出しても、単独では何もブロックしません。

Zen はリクエストから IP アドレスを取得するため、渡すのはイベント名だけで構いません。 現在のユーザーを設定 してから trackを呼び出すと、Zen はユーザー情報も含めます。そのため、次のようなプレイブックを作成できます coupon.invalid 5 分間に 10 回 → IP を 1 時間ブロック。カウントはアプリ全体ではなく、IP ごとに行われます。

組み込みイベント

攻撃の波を検知。 IP が体系的にアプリを探査しており、たとえば .env ファイルや隠しディレクトリをスキャンしています。Zen がこれをどう検知するかは 攻撃の波への保護 を参照してください。

アクション

IP をブロック。 イベントの原因となった IP は、このアプリのブロックリストに追加されます。期間は 30 分、1 時間、24 時間、または永久から選べます。

一時的なブロックは自動的に期限切れになります。ブロックが期限切れになると、Zen はその IP のイベント数もリセットするため、プレイブックは最初からやり直されます。

プレイブックは、あなたの バイパスリスト.

プレイブックが実行した内容を確認する

次の アクティビティ Playbooks タブの表示では、プレイブックが行ったすべてのアクションが記録されます。いつ起きたか、どのプレイブックが発動したか、対象の IP、残りのブロック時間が分かります。ドロップダウンでプレイブックごとに絞り込めます。

プレイブックによるブロックも プレイブックルール で この IP がブロックされているのはなぜですか？

プレイブックをオフにする、編集する、または削除する

プレイブック行の右側にあるアクションメニューを使います:

• プレイブックを無効化 するとアクションを実行しなくなります。既存のブロックはそのまま残ります。
• プレイブックを編集 イベント、アクション、または継続時間を変更します。
• プレイブックを削除 すると削除されます。