README-JA.md

May 23, 2026 · View on GitHub

中文 English

GitHub stars License

紹介

Wolfは、すべてのHTTPアプリケーションに適した汎用のロールベースアクセス制御（RBAC）権限システムであり、統一された認可とアクセス制御機能を提供します。

企業内では、さまざまなバックエンドサービスとそれに対応する管理インターフェースが異なるアカウントシステムと権限モジュールを持つことが一般的です。この冗長性はリソースの浪費と管理の混乱を引き起こし、特に異なるチームがこれらのシステムを開発する場合に問題が顕著になります。Wolfは、既存のシステムに変更を加えることなく、さまざまなプラットフォームやシステム全体で統一されたアカウントと認可管理を実現します。

特徴

Wolfシステムには以下の主な特徴があります：

1. 汎用性と柔軟性

  • 言語非依存：純粋な静的Webページ、JSP、PHP、ASP、Python、Node.jsなど、あらゆるHTTPアプリケーションに適用可能
  • 低結合＆非侵入型：新しいアプリケーションを変更なしに統合でき、プロキシ層でリソース権限を管理
  • Restfulインターフェースとバックエンドでレンダリングされた純粋なHTMLアプリケーションの両方をサポート

2. 多様な認証と認可

  • 認証ソース：
    • パスワード認証：内部に保存されたユーザー名とパスワードを使用
    • LDAP認証：外部LDAPサーバーを通じたユーザー認証
  • 認証プロトコル：
    • JWT（JSON Web Token）：アクセストークンの生成と検証用
    • HTTP Basic認証：ユーザー名とパスワードによる基本認証をサポート
  • 認可プロトコル：
    • OAuth 2.0：他のアプリケーションでWolfアカウントを使用したログインと認可をサポート

3. 包括的な管理機能

  • 内蔵の管理コンソール（consoleモジュール）：アプリケーション、ユーザー、ロール、権限、リソースを管理
  • アクセスログの記録と照会をサポートし、監査と問題追跡を容易に
  • アプリケーションのRBACオブジェクト関係図の表示をサポート
  • 多言語サポート（i18n）：コンソールは中国語と英語の言語切り替えをサポート
  • RBACリレーションシップダイアグラムの可視化により、権限構造の理解を容易に

4. 高性能とスケーラビリティ

  • 高性能で複雑なURL照合のための高度なradixtreeルーティングをサポート
  • PostgreSQLとMySQLデータベースと互換性あり
  • パフォーマンス向上のためのRedisキャッシュ
  • APISIXゲートウェイとの統合をサポート

5. AIアシスタント（0.8.x で新登場）

  • Console に組み込まれた対話型 RBAC 管理：アプリケーション、ユーザー、ロール、権限、リソース、監査ログの照会と更新を自然言語で実行可能
  • ツール呼び出しは既存の Controller を再利用するため、手動操作で行われるパラメータ検証、権限チェック、キャッシュ更新、監査ログがそのまま AI 操作にも適用される
  • マルチプロバイダ対応：OpenAI、Anthropic Claude、Google Gemini、Mistral、Groq、xAI、OpenRouter、および OpenAI 互換ゲートウェイ（dashscope、vLLM、Ollama など）
  • ストリーミング UI + ツール呼び出しの可視化カード（running / done / error）、ユーザーごとのセッション履歴、セッションをまたぐユーザーメモリ機能
  • AI による書き込み操作はすべて appID = 'ai-agent' で access_log テーブルに記録され、人手による操作と明確に区別され、完全に監査可能
  • 詳細：AI アシスタント概要 · AI アシスタント利用ガイド

6. システムアーキテクチャ

  • 3つの主要モジュール：
    • Wolf-Server：サービス実装とバックエンド管理機能
    • Wolf-Console：管理コンソール用フロントエンドコード
    • Wolf-Agent：RBACアクセスチェックプロキシ

7. コアエンティティオブジェクト

  • アプリケーション：複数のアプリケーションをサポートし、それぞれに異なる権限、ロール、リソースを持つ。各アプリケーションのRBACオブジェクト関係図の表示が可能。

  • ユーザー：システム全体で共有。ユーザー固有の認可には以下が含まれる：

    • 管理者権限：管理者に設定されたユーザーはConsoleバックエンドにログインしてアプリケーション管理が可能。
    • アプリケーションリスト：ユーザーは0から複数のアプリケーションに割り当て可能。ユーザータイプによって意味が異なる：
      • 管理者ユーザーの場合、管理可能なアプリケーションを示す。
      • 非管理者ユーザーの場合、ログインして使用可能なアプリケーションを示す。
    • ロール：ユーザーは複数のロールを割り当てられ、全てのロールから権限を累積。
    • 権限：直接の権限割り当ても可能で、典型的なRBACモデルから逸脱。

  • ロール：一連の権限を含むことができる。

  • 権限カテゴリ：管理を容易にするための権限のカテゴリ化（グループ化）方法で、通常は主要な機能モジュールに合わせている。システムの権限選択ボックスでは、権限はカテゴリごとにグループ化して表示される。

  • 権限：リソースと1対多の関係を持つ。1つのリソースに1つの権限を割り当てるか、複数のリソースが同じ権限を共有できる。

  • リソース：主にHTTPリクエストを指す。リソースはマッチタイプ+名前+アクションの組み合わせで一意に識別される。主な属性は以下の通り：

    • マッチタイプ：
      • radixtreeルーティングなし：URLマッチング方法には完全一致、サフィックス一致、プレフィックス一致がある。
      • radixtreeルーティングあり：radixtreeモードをサポートし、名前の構文を通じて完全一致、サフィックス一致、プレフィックス一致を実装。
    • 名前：HTTPのURLを指す。
      • radixtreeルーティングなし：完全一致とプレフィックス一致の場合、通常は/で始まる。サフィックス一致の場合、通常は.jpg、.jsなどの共通リソースサフィックス。ワイルドカードや正規表現はサポートされていない。
      • radixtreeルーティングあり：デフォルトは完全一致。プレフィックス一致には*を使用：/foo*は/foobarにマッチするが/foo/barにはマッチしない。任意のマッチには**を使用：/foo**は/foo/barと/foo/car/farにマッチする。サフィックス一致には**を使用：**.jpgは/images/photo.jpgと/uploads/profile.jpgにマッチする。
    • アクション：HTTPメソッドを指す。ALLは全てのメソッドにマッチする。
    • 権限：リソースにアクセスするために必要な権限を示す。2つの組み込み権限がある：Allow Allは全てのユーザーがアクセス可能、Deny Allは全てのユーザーがアクセス不可。

  • 監査ログ：システム（Wolf-Consoleとシステムで管理されるアプリケーションを含む）を通じた全てのアクセスを記録。主な記録情報：

    • ユーザーID、ユーザー名、ユーザーニックネーム
    • アクセス日時とアクセス元のIP
    • HTTPメソッドとURL
    • マッチしたリソース
    • アクセス応答のステータスコード
    • リクエストパラメータまたはリクエストボディ（Wolf-Consoleの記録のみサポート）

8. その他の特徴

  • 90%以上のコードカバレッジを持つ広範なテストケース
  • リソースマッチングは異なる優先順位ルールをサポート：
    • マッチタイプの優先順位（高から低）：完全一致、サフィックス一致、プレフィックス一致
    • アクション（HTTPメソッド）の優先順位：ALLは低い優先順位、他のメソッド（GET、POST、PUTなど）は同等の優先順位だがALLより高い
    • 名前（HTTP URL）の優先順位はURL長に関

アーキテクチャ

アーキテクチャ

関係

関係

技術

  • サーバー: NodeJS, KOA, Sequelize, JWT
  • コンソール: Vue 3, Element Plus, Vite, TypeScript, Pinia, Tailwind CSS
  • エージェント: OpenResty(ngx_lua)
  • データベース: PostgreSQL.
  • キャッシュ: Redis

クイックスタート

Docker Composeを使用してWolfシステムを素早く起動：

# リポジトリをクローン
git clone https://github.com/iGeeky/wolf.git
cd wolf/quick-start-with-docker

# すべてのサービスを起動
docker-compose up

起動後のアクセス：

詳細な手順については、クイックスタートガイドをご覧ください

プレビュー

コンソール

アプリケーションリスト
アプリケーションリスト
アプリケーションリスト
アプリケーション、ユーザー、ロール、権限の関係
ユーザー管理
ユーザー管理
ロール管理
ロール管理
ロールの権限の詳細
ロールの権限の詳細/権限のグループ表示
権限管理
権限管理
監査ログ
監査ログ

クライアント/デモ

クライアントログイン
クライアントログイン
メインページ
メインページ (注: 上部に情報バーを追加)
権限なしページ
権限なしページ

デプロイ

デプロイドキュメント

LDAP構成

APIドキュメント

OAuth2インターフェースドキュメント

AI アシスタント

Wolf 0.8.x には対話型 RBAC 管理のための AI アシスタントが組み込まれています。

AI アシスタント概要

AI アシスタント利用ガイド

テスト

サーバーAPIユニットテスト

パフォーマンス

エージェント APIパフォーマンステスト

マニュアルドキュメント

使用方法

変更履歴

変更履歴

ライセンス

MIT