Repolode
投稿する
TheDuffman85

TheDuffman85/crowdsec-web-ui

アラートの調査、判断の管理、稼働メトリクスの確認、通知送信ができる、セルフホスト型のCrowdSec Webダッシュボード。

GitHub で見る
スター
952
フォーク
48
未解決の Issue
4
最終コミット
13 時間前

これは何？

CrowdSec Web UIは、1つ以上のCrowdSec Local API（LAPI）に接続するセルフホスト型ダッシュボードです。検索やクイックフィルターでアラート履歴を閲覧し、各アラートの背景にあるCrowdSecのコンテキストを確認できます。また、有効な判断と期限切れの判断も表示できます。期間や理由を指定した手動BANを追加でき、同じ画面からクリーンアップ操作も行えます。

ダッシュボード、アラート、判断の各画面で複数のCrowdSecインスタンスを1つの統合ビューにまとめられます。オプションのPrometheusメトリクス画面では、LAPIのアクティビティ、bouncer、AppSec、parser、whitelistを確認できます。アラート、判断、CVE、可用性、更新に関する通知ルールを設定し、Email、Gotify、MQTT、ntfy、またはwebhookで通知できます。

このアプリケーションはReactクライアントを備えたNode.jsサーバーとして動作し、状態をSQLiteに保存します。Dockerイメージとして配布されています。セキュリティ機能として、パスワードとTOTPによるログイン、passkey、グループベースのロールに対応したOIDC SSO、インスタンス全体の読み取り専用モードを利用できます。

主な機能

  • 01検索可能なアラート履歴。CrowdSecのコンテキストに加え、IP、AS、位置情報を確認可能
  • 02有効・期限切れの判断を管理でき、期間を指定した手動BANにも対応
  • 03複数のCrowdSec LAPIへの接続と統合スコープビュー
  • 04LAPI、bouncer、AppSec、parser向けのオプションのPrometheusメトリクス画面
  • 05Email、Gotify、MQTT、ntfy、またはwebhookで通知するルール
  • 06グループベースのロールに対応した、パスワード、TOTP、passkey、OIDC SSOログイン

ユースケース

  • 複数のサーバーでCrowdSecを運用しており、すべてのLAPIを1つのダッシュボードで確認したい運用担当者
  • コマンドラインを使わずにアラートを確認し、IPを手動でBANまたはBAN解除したいチーム
  • 新しいアラートや判断をプッシュ通知で受け取りたいホームラボや小規模チームの管理者
  • 既存のOIDC IDプロバイダーとCrowdSecのアクセス管理を連携したい組織

クイックスタート

  1. 1

    openssl でランダムなパスワードを生成する

    openssl rand -hex 32
  2. 2

    CrowdSec コンテナで Web UI を machine として登録する

    docker exec crowdsec cscli machines add crowdsec-web-ui --password 'replace-with-generated-password' -f /dev/null
  3. 3

    同梱の docker-compose.yml を使って Docker Compose で Web UI を起動する

    docker compose up -d
  4. 4

    ブラウザーで http://localhost:3000 を開き、最初の管理者アカウントを作成する

使う前に知っておきたいこと

  • 接続先となる稼働中の CrowdSec LAPI が必要です。
  • 強いコピーレフトライセンスである AGPL-3.0 の下でライセンスされています。
  • アプリ自体は TLS を処理しないため、一般公開する場合は HTTPS と強化されたリバースプロキシの背後に配置してください。
  • 認証機能が導入される前のインストールから移行した場合、有効化するまで認証なしの状態が維持されます。

収録されている特集

セルフホスト型アプリログイン・SSO・ID認証サーバー

トピック

#crowdsec#security-dashboard#intrusion-detection#self-hosted#docker#prometheus#notifications#oidc#crowdsec-lapi#crowdsec-manager

よくある質問

crowdsec-web-ui とは？
アラートの調査、判断の管理、稼働メトリクスの確認、通知送信ができる、セルフホスト型のCrowdSec Webダッシュボード。 CrowdSec Web UIは、1つ以上のCrowdSec Local API（LAPI）に接続するセルフホスト型ダッシュボードです。検索やクイックフィルターでアラート履歴を閲覧し、各アラートの背景にあるCrowdSecのコンテキストを確認できます。また、有効な判断と期限切れの判断も表示できます。期間や理由を指定した手動BANを追加でき、同じ画面からクリーンアップ操作も行えます。
crowdsec-web-ui は無料で使えますか？ライセンスは？
crowdsec-web-ui は AGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
crowdsec-web-ui は今もメンテナンスされていますか？
活発にメンテナンス中。crowdsec-web-ui の最終コミットは 2026年11月6日 です。
crowdsec-web-ui は何に使えますか？
複数のサーバーでCrowdSecを運用しており、すべてのLAPIを1つのダッシュボードで確認したい運用担当者 コマンドラインを使わずにアラートを確認し、IPを手動でBANまたはBAN解除したいチーム 新しいアラートや判断をプッシュ通知で受け取りたいホームラボや小規模チームの管理者 既存のOIDC IDプロバイダーとCrowdSecのアクセス管理を連携したい組織
crowdsec-web-ui のインストール方法は？
openssl でランダムなパスワードを生成する: openssl rand -hex 32 CrowdSec コンテナで Web UI を machine として登録する: docker exec crowdsec cscli machines add crowdsec-web-ui --password 'replace-with-generated-password' -f /dev/null 同梱の docker-compose.yml を使って Docker Compose で Web UI を起動する: docker compose up -d ブラウザーで http://localhost:3000 を開き、最初の管理者アカウントを作成する
crowdsec-web-ui はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/TheDuffman85/crowdsec-web-ui

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト