API Key Manager
概要
.mbpkey ファイル (AI プロバイダ API キー + Speckle トークンを格納する暗号化ファイル) の作成・編集 UI を起動します。すべてのキーは Windows DPAPI (現在ユーザーアカウント) で暗号化保存されます。
- グループ: 0. License & Setup
- ニックネーム:
ApiKeys - Exposure: Secondary
- v5.2.0 新規 / v5.5.0 で Gemini ヘッダ認証対応 (RC-12)
- 実体コンポーネントは
Comp_L02_ApiKeyManager（v5.6.0 でComp_D10_ApiKeyManagerから改名し License & Setup グループへ移動。ComponentGuidは不変のため既存ドキュメントはそのまま動作。本ページは D10 の名称を維持）
機能
- OpenAI / Anthropic / Gemini の 3 プロバイダ API キーを 1 ファイルで管理
- Speckle トークンも同じ
.mbpkeyファイルに格納 - パスワード入力欄 (
PasswordChar='●', 表示機能なし) - 各プロバイダごとに Test ボタン (最小リクエスト
max_tokens=1でキー有効性を即座検証) - Save / Save As / Load
.mbpkey既定パス自動読み込み
入力パラメータ
| パラメータ名 | 型 | デフォルト | 説明 |
|---|---|---|---|
| Launch | Boolean | false | false→true のエッジで UI を開く |
出力パラメータ
| パラメータ名 | 型 | 説明 |
|---|---|---|
| Status | String | 最終操作のステータス |
セキュリティ仕様 (v5.2.0 監査対応)
- キーは DPAPI 暗号化で
.mbpkeyファイルに保存 (ユーザーアカウント別) - メモリ上では
SecureString/byte[]のクリア徹底 - UI には表示・コピー機能を意図的に持たない
Comp_I06 AI Building Generatorは.mbpkeyパス + プロバイダ ID を指定して暗号化解除のみメモリ内で実施- v5.5.0 (#RC-12): Gemini プロバイダの API キーは URL クエリではなく
x-goog-api-keyヘッダで送信 (proxy/firewall ログ漏洩回避)
Grasshopper メニューからの代替
GH メインメニュー → MakeBuildingPro → AI Setup... からも同じダイアログを起動できます。
関連
- AI 機能 利用規約
Comp_I06_AIBuildingGenerator— 本キーを使って LLM 呼出
更新履歴
| バージョン | 変更内容 |
|---|---|
| v5.9.0 | 機能変更なし |
| v5.6.0 | Comp_D10_ApiKeyManager を Comp_L02_ApiKeyManager に改名し「0. License & Setup」グループへ移動（ComponentGuid 不変） |
| v5.5.0 | Gemini プロバイダの API キーを x-goog-api-key ヘッダで送信（RC-12。URL クエリからの漏洩回避） |
| v5.2.0 | 新規追加 |