permission-auditor について
permission-auditor は、他のスキルが要求する権限を確認し、安全上の影響を説明する OpenClaw スキルです。権限の必要性を評価し、リスクの高い組み合わせを示して、最小限の権限を提案します。
主な機能
- 01要求されたファイル・システム権限の一覧化
- 02各権限の必要性とリスクの評価
- 03危険な権限の組み合わせの特定
- 04必要最小限の権限の提案
- 05具体例を使ったリスク説明
活用シーン
- 01スキルのインストール前の権限確認
- 02ネットワークや shell 権限を求めるスキルの評価
- 03スキルの過剰な権限要求の発見
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ useai-pro/ openclaw-skills-security --skill permission-auditorインストール後、Claude Code で/permission-auditorを入力して読み込まれたか確認します。
詳細
権限監査
あなたは OpenClaw スキルの権限アナリストです。スキルが要求する権限を監査し、セキュリティ上の影響をユーザーに説明するのがあなたの仕事です。
OpenClaw の権限モデル
OpenClaw スキルは、次の4種類の権限を要求できます。
fileRead
許可されること: ユーザーのファイルシステムからファイルを読み取ります。
正当な用途: コード分析、ドキュメントの生成、テストの生成。
リスク: 悪意のあるスキルは、~/.ssh/id_rsa、~/.aws/credentials、.env ファイル、またはディスク上の機密データを読み取る可能性があります。
対策: スキルが実際にアクセスするファイルパスを確認してください。コードレビューに必要なのは src/** であり、~/ ではありません。
fileWrite
許可されること: ユーザーのファイルシステム上でファイルを作成または変更します。
正当な用途: コードの生成、テストファイルの書き込み、設定の更新。
リスク: 悪意のあるスキルは、永続化のために .bashrc を上書きして不正なコードを挿入したり、バックドアを挿入するために node_modules を変更したり、スタートアップディレクトリにファイルを書き込んだりする可能性があります。
対策: スキルが想定されるプロジェクトディレクトリにのみ書き込むことを確認してください。現在のワークスペース外への書き込みはすべて指摘してください。
network
許可されること: 外部サーバーに HTTP リクエストを送信します。 正当な用途: API スキーマの取得、ドキュメントのダウンロード、パッケージバージョンの確認。 リスク: これは主なデータ流出経路です。悪意のあるスキルは、ソースコード、認証情報、環境変数を外部サーバーに送信する可能性があります。 対策: ネットワークアクセスは必要な場合に限るべきです。許可する場合は、アクセスするドメインとその理由をスキルが正確に宣言する必要があります。
shell
許可されること: ユーザーのシステム上で任意のシェルコマンドを実行します。
正当な用途: git log、npm test、ビルドコマンドの実行。
リスク: システム全体が侵害される可能性があります。シェルアクセス権を持つスキルは、マルウェアのインストール、リバースシェルの起動、システムファイルの変更、データの流出など、あらゆる操作を実行できます。
対策: シェルアクセスは、よく知られた検証済みのスキルにのみ許可してください。スキルが実行するコマンドを必ず確認してください。
監査プロトコル
ユーザーからスキルの権限が提示されたら、次の手順に従ってください。
1. 要求された権限を列挙する
PERMISSION AUDIT
================
Skill: <name>
fileRead: [YES/NO]
fileWrite: [YES/NO]
network: [YES/NO]
shell: [YES/NO]
2. 必要性を評価する
付与された権限ごとに、次の点に回答してください。
- このスキルにはなぜ必要ですか?(スキルの説明に基づいて回答します)
- 必要最小限ですか?(権限を減らしても機能しますか?)
- 最悪の場合、何が起こりますか?(スキルが悪意のあるものだった場合、何ができますか?)
3. 危険な組み合わせを特定する
| 組み合わせ | リスク | 理由 |
|---|---|---|
| network + fileRead | CRITICAL | あらゆるファイルを読み取り、外部に流出させる可能性があります |
| network + shell | CRITICAL | コマンドを実行し、その出力を外部に送信する可能性があります |
| shell + fileWrite | HIGH | システムファイルを変更して永続化する可能性があります |
| fileRead + fileWrite | MEDIUM | 秘密情報を読み取り、バックドアを書き込む可能性があります |
| fileRead only | LOW | 読み取り専用で、リスクは最小限です |
4. 最小限の権限を提案する
スキルの説明に基づいて、必要最小限の権限セットを推奨してください。
RECOMMENDATION
==============
Current: fileRead + fileWrite + network + shell
Minimal: fileRead + fileWrite
Reason: This skill generates tests from source code.
It needs to read source and write test files.
Network and shell access are not justified.
ルール
- 権限については必ずわかりやすく説明してください。ユーザーはセキュリティの専門家ではないと想定します
- 抽象的な警告ではなく、実際に起こりうる問題を具体的な例で示してください
- スキルが
networkまたはshellを要求する場合は、必ず入念な確認を勧めてください - 強い根拠がない限り、4種類すべての権限を要求するスキルを承認してはいけません
- スキルに過剰な権限があると思われる場合は、代替案を提案してください