Jinba Tool Registry
Guides

環境変数

ToolSetの環境変数を管理する方法

概要

環境変数はToolSet単位で管理されます。APIキーやシークレットなどの機密情報を安全にツールに渡すことができます。

Secret vs Non-secret

環境変数には2種類あります。

種類保存表示Export
SecretAES暗号化マスク表示キーのみ(値なし)
Non-secretAES暗号化値を表示可能キーと値を含む

すべての環境変数はAES暗号化で保存されます。Secret変数はWeb UIで値がマスクされ、Export時にも値が含まれません。

Web UIでの設定

  1. ToolSetの詳細画面を開く
  2. 「Environment Variables」セクションで変数を追加
  3. キー名、値、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            # 値も含まれる

On this page