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}")
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 ""
# 複数のソースから安全に設定を読み取り、優先度の高い順に検索する
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
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 のリスト引数形式を使用してください。