Skills 権限とセキュリティ制御

Skills はファイルシステムへのアクセス、外部 API の呼び出し、スクリプトの実行ができます。これらの機能が悪用されると、セキュリティリスクが生じます。

本記事では、設計段階でセキュリティ境界を確立し、Skill が想定外の操作を行わないようにする方法を紹介します。


Skills のデフォルト権限範囲

Claude の実行環境では、Skills の権限はサンドボックス環境によって決まり、無制限ではありません。

操作タイプ権限ステータス説明
アップロードファイルの読み取り許可/mnt/user-data/uploads/ のみ
出力ファイルの書き込み許可/mnt/user-data/outputs/ と /home/claude/ のみ
システムファイルの読み取り制限付き読み取り専用マウントのため、システムファイルを変更できません
外部ネットワークへのアクセス制限付きホワイトリスト登録されたドメインのみアクセスを許可
任意のシステムコマンドの実行制限付きsudo を使用できず、システム設定を変更できません
他のユーザーデータへのアクセス禁止サンドボックス分離による保証

Skills は設計上、「最小権限」の原則を実践しています。Skill は明示的に必要なリソースにのみアクセスできます。Skill が上記の範囲を超える権限を必要とする場合は、設計を再検討する必要があります。


SKILL.md で権限境界を明確にする

Skill ドキュメントでアクセスするリソースを明確に宣言し、ユーザーが使用前に Skill の動作範囲を理解できるようにします。

## 权限说明

本 Skill 会进行以下操作,请确认你已了解:

**文件访问**
- 读取:/mnt/user-data/uploads/ 下用户上传的文件
- 写入:/mnt/user-data/outputs/ 下的输出文件

**网络访问**
- 无(本 Skill 不访问任何外部网络)

**不会进行的操作**
- 不读取系统文件
- 不修改已上传的原始文件
- 不访问任何外部服务

パストラバーサル攻撃の防止

スクリプトがユーザー提供のファイルパスを受け取る場合、パスが許可された範囲内にあるかを検証し、ユーザーが../アクセスすべきでないディレクトリにアクセスするのを防ぐ必要があります。

例

# ファイルパス: scripts/safe_path.py
import os

# 読み取りを許可するディレクトリ
ALLOWED_READ_DIRS = [
    "/mnt/user-data/uploads",
    "/mnt/skills/public",
]

# 書き込みを許可するディレクトリ
ALLOWED_WRITE_DIRS = [
    "/mnt/user-data/outputs",
    "/home/claude",
]

def is_safe_path(path: str, allowed_dirs: list) -> bool:
    """
パスが許可されたディレクトリの範囲内にあるかを確認する

../../../etc/passwd タイプのパストラバーサル攻撃を防ぐ
    """

    # 絶対パスに解決する(.. とシンボリックリンクを排除)
    real_path = os.path.realpath(os.path.abspath(path))

    for allowed in allowed_dirs:
        real_allowed = os.path.realpath(allowed)
        # real_path が allowed ディレクトリで始まるか確認する
        if real_path.startswith(real_allowed + os.sep) or real_path == real_allowed:
            return True
    return False

def safe_read_path(user_input: str) -> str:
    """読み取りパスを検証し、不正な場合は例外を送出する"""
    if not is_safe_path(user_input, ALLOWED_READ_DIRS):
        raise PermissionError(
            f"アクセス拒否: {user_input}\n"
            f"以下のディレクトリのみ読み取り可能: {ALLOWED_READ_DIRS}"
        )
    return os.path.realpath(user_input)

def safe_write_path(user_input: str) -> str:
    """書き込みパスを検証し、不正な場合は例外を送出する"""
    if not is_safe_path(user_input, ALLOWED_WRITE_DIRS):
        raise PermissionError(
            f"書き込み拒否: {user_input}\n"
            f"以下のディレクトリのみ書き込み可能: {ALLOWED_WRITE_DIRS}"
        )
    return os.path.realpath(user_input)

# 使用例
if __name__ == "__main__":
    # 正常なパス: 許可
    ok_path = safe_read_path("/mnt/user-data/uploads/サンプル.csv")
    print(f"許可: {ok_path}")

    # トラバーサルパス: 拒否
    try:
        bad_path = safe_read_path("/mnt/user-data/uploads/../../etc/passwd")
    except PermissionError as e:
        print(f"ブロックされました: {e}")
通过:/mnt/user-data/uploads/サンプル.csv
已拦截:拒绝访问:/mnt/user-data/uploads/../../etc/passwd
只允许读取以下目录:['/mnt/user-data/uploads', '/mnt/skills/public']

API キーの安全な保存

キー管理の方法によって、セキュリティレベルは大きく異なります。

方法安全性推奨度
スクリプトへのハードコーディング非常に低い、Git にコミットされる恐れがある禁止
環境変数中、プロセス分離推奨(開発段階)
.env ファイル(.gitignore に追加)中、ファイルのローカル保存推奨(ローカル使用)
システムキーマネージャー(Vault など)高、集中管理推奨(本番環境)

例

# ファイルパス: scripts/config.py
# 複数のソースから安全に設定を読み取り、優先度の高い順に検索する

import os

def get_secret(key: str, required: bool = True) -> str:
    """
優先度に従って、以下のソースからキーを読み取ります:
1. 環境変数(最優先)
2. /home/claude/.skill_secrets ファイル(ローカルキーファイル)
3. required=True の場合に見つからないときは、例外を送出する
    """

    # 1. 環境変数
    value = os.environ.get(key)
    if value:
        return value

    # 2. ローカルキーファイル(各行の形式: KEY=VALUE)
    secrets_file = "/home/claude/.skill_secrets"
    if os.path.exists(secrets_file):
        with open(secrets_file) as f:
            for line in f:
                line = line.strip()
                if line.startswith(f"{key}="):
                    return line[len(key)+1:]

    # 3. 見つからない場合
    if required:
        raise EnvironmentError(
            f"必要なキーがありません: {key}\n"
            f"環境変数を設定してください: export {key}='あなたのキー'"
        )
    return ""

入力内容の安全なフィルタリング

Skill がユーザー入力をシェルコマンドに渡す場合、コマンドインジェクションを防ぐため、入力をエスケープ処理する必要があります。

例

# ファイルパス: scripts/safe_exec.py
import subprocess
import shlex

def safe_shell_exec(template: str, user_input: str) -> str:
    """
ユーザー入力をシェルコマンドに安全に埋め込む

誤った方法: os.system(f"process {user_input}") # コマンドインジェクションのリスク!
正しい方法: 引数リストを使用して、subprocess にエスケープ処理を任せる
    """

    # 文字列ではなくリストを使用すると、subprocess が自動的にエスケープ処理を行います
    cmd = ["python", "scripts/process.py", user_input]
    result = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
    return result.stdout

# どうしても文字列コマンドを構築する必要がある場合は、shlex.quote でユーザー入力をエスケープします
def safe_string_exec(user_filename: str) -> str:
    safe_name = shlex.quote(user_filename)   # 自動的に引用符を追加し、特殊文字をエスケープします
    cmd = f"wc -l {safe_name}"
    result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
    return result.stdout

絶対にこの方法でos.system(f"cmd {user_input}")コマンドを実行しないでください。ユーザー入力に; rm -rf /そのような内容が含まれると、壊滅的な結果を招きます。常に subprocess のリスト引数形式を使用してください。

その他の拡張