メインコンテンツまでスキップ

インストールおよび初期化

概要​

BotManager-Cloudflare-AgentはOriginサーバーを修正せずにCloudflareのWorkers機能を活用してBotManagerの検出機能を簡単に適用できるように設計されました。

BotManagerは多様な分析技法（ヘッダー分析、行動分析、海外IPブロック、接続統計など）を通じてボットおよびマクロユーザーを検出するソリューションです。これを通じてウェブサービスを保護し、悪性ユーザーおよび自動化されたボットの脅威からデータを安全に管理できます。

Cloudflare Workersとは？​

Cloudflare WorkersはCloudflareのグローバルネットワーク上でJavaScript、TypeScript、WebAssemblyなどを実行できるサーバーレスコンピューティングプラットフォームです。

主要特徴：

  • グローバルエッジネットワークベース実行 - 全世界300個以上の都市で実行され、ユーザーにより近い位置でコードを実行することで低い遅延時間と速い応答速度を提供します。
  • Originサーバー負荷減少 - エッジで直接リクエストを処理するかキャッシュ、認証、リダイレクションなどの作業を実行でき、Originサーバーの負荷を減らすことができます。
  • 速いデプロイと拡張性 - 複雑なインフラ設定なしに、コードを記述してすぐにデプロイでき、自動でグローバル拡張されます。

Cloudflareに関する詳細内容は公式文書を参照してください：

インストール方法​

1. Worker生成および設定値セッティング​

  1. Cloudflare管理コンソールでWorkersおよびPagesメニューに移動します。
  2. 生成をクリックし、WorkersをHello worldで生成してください。
  3. 生成されたWorkersを選択して設定に移動します。
    • ドメインおよびパスでパスを追加します。
      • 領域：Cloudflareに登録したドメインリストから使用するドメインを選択します。
      • パス：workersが実行されるサブドメインまたはドメインを入力してください。最後に/*を追加する必要があり、下位パスまで含まれます。
  4. 変数および暗号に以下の環境変数を追加します。
RequiredTypeNameDefault ValueDescription
YESテキストBM_DOMIN{{domain}}ユーザーがBotManagerに登録したドメイン
YESテキストBM_TENANT_ID{{tenantId}}顧客社tenantId
NoテキストBM_PROTECTION_SERVER_URLhttps://cdn-botmanager.stclab.comボットと判定されたときredirectするアドレス
NoテキストBM_SERVER_API_URL/api/v1/macroBotManager検出pathname
NoテキストBM_SERVER_URLhttps://botmanager.stclab.comBotManager検出サーバーアドレス
NoテキストBM_SERVER_TIMEOUT3000BotManager検出サーバーへのtimeout
NoテキストBM_BYPASSfalseBotManagerが動作しないようにするフラグ
NoテキストBM_LOG_LEVELERRORBotManager連動時のログレベル（DEBUG、INFO、WARN、ERROR）
  1. ボットマネージャーエージェントコードファイルであるbotmanager-cloudflare-agent.jsを以下のパスからダウンロードします。
  2. ダッシュボード右上にあるコード編集をクリックしてボットマネージャーエージェントコードファイルをimportし、worker.jsファイルのコードを修正した後デプロイをクリックします。

worker.js Code：

import bmEvent from './botmanager-cloudflare-agent.js'

export default {
    async fetch(request, env, ctx) {
        return await bmEvent(request, env, ctx);
    },
};
  1. デプロイタブに移動してデプロイ状態を確認します。

2. インストール完了​

BotManager-Cloudflare-Agentが正常にインストールされました。設定したポリシーどおりに動作するか確認してください。