コンテンツにスキップ

Nodejs (Google Cloud Pub/Sub)

このガイドでは、アプリケーションに Zen Firewall by Aikido をインストール・設定する手順を説明します。以下の手順に従って、アプリケーションを保護してください。

問題や不明点がある場合は、遠慮なくサポートチャットまたは Github issues までご連絡ください。

https://github.com/AikidoSec/firewall-node

1. Zen Firewall by Aikido をインストールする

Section titled “1. Zen Firewall by Aikido をインストールする”

プロジェクトに Zen をインストールします。

npm

Terminal window
npm install --save-exact @aikidosec/firewall

Yarn

Terminal window
yarn add --exact @aikidosec/firewall

pnpm

Terminal window
pnpm add --save-exact @aikidosec/firewall

Pub/Sub クライアントを作成する前に Zen を読み込みます。

+require("@aikidosec/firewall");
const { PubSub } = require("@google-cloud/pubsub");
const client = new PubSub();

2. Zen Firewall をドライ / 検知専用モードで起動する

Section titled “2. Zen Firewall をドライ / 検知専用モードで起動する”

実行時の環境変数を設定します。

Terminal window
AIKIDO_TOKEN=AIK_RUNTIME_...
AIKIDO_BLOCK=false

Aikido Zen エージェントがトークンを認識できるように、環境変数としてトークンを設定します。まだトークンをお持ちでない場合は、こちらの手順に従ってください。

Terminal window
AIKIDO_TOKEN=AIK_RUNTIME_

まずは dry mode でアプリを起動し、リクエストをブロックせずに期待どおり動作することを確認することをお勧めします。誤検知(false positives)を避けるため、ステージング環境で 2 週間ほど Zen Firewall を実行することをお勧めします。

Terminal window
AIKIDO_BLOCK=false

いくつかのテストメッセージを publish・consume してみてください。

アプリケーションにアクセスし、いくつかの操作を行うか、いくつかのページを開いてみてください。Zen はアプリケーション内のルートを自動的に検出します。

エージェントが正しく動作していることは、Zen アプリケーションの以下のページで確認できます。

  • Events: 「Application started」イベントが表示されるはずです。
  • Routes: しばらくすると、アプリケーションのルートがメソッド・ルート・リクエスト数とともにここに表示され始めます。
  • Instances: Zen がインストールされているアプリケーションのアクティブなインスタンス数が表示されるはずです。

おめでとうございます。Zen Firewall のインストールに成功しました。問題が発生した場合や、ご要望・機能リクエストがある場合は、遠慮なくサポートまでご連絡ください。

Zen Firewall が提供する多くの機能を、これから探ってみてください。

追加情報: