Guides
環境変数
ToolSetの環境変数を管理する方法
概要
環境変数はToolSet単位で管理されます。APIキーやシークレットなどの機密情報を安全にツールに渡すことができます。
Secret vs Non-secret
環境変数には2種類あります。
| 種類 | 保存 | 表示 | Export |
|---|---|---|---|
| Secret | AES暗号化 | マスク表示 | キーのみ(値なし) |
| Non-secret | AES暗号化 | 値を表示可能 | キーと値を含む |
すべての環境変数はAES暗号化で保存されます。Secret変数はWeb UIで値がマスクされ、Export時にも値が含まれません。
Web UIでの設定
- ToolSetの詳細画面を開く
- 「Environment Variables」セクションで変数を追加
- キー名、値、Secret/Non-secretを選択して保存
ツール内での利用
Python
import os
api_key = os.environ["API_KEY"]
log_level = os.environ.get("LOG_LEVEL", "info")TypeScript
const apiKey = process.env.API_KEY!;
const logLevel = process.env.LOG_LEVEL ?? "info";Import/Exportでの扱い
環境変数はImport/ExportのZIPファイルに含まれます。
- Export: Secret変数はキーのみ、Non-secret変数はキーと値が含まれます
- Import: Secret変数でvalueのないエントリはスキップされます
# toolset.yml
env:
- key: SLACK_BOT_TOKEN
secret: true # Export時は値なし
- key: LOG_LEVEL
value: debug # 値も含まれる