メインコンテンツへスキップ
管理キーを作成すると、自社サーバーから Phaseo の管理 API(クレジット、アクティビティ、ワークスペース、キー、プリセット、設定、ガードレール)を呼び出せます。管理キーで推論リクエストを送ることはできません。 ダッシュボードの 設定 → 管理用キー で作成します。シークレットは一度しか表示されないため、シークレットマネージャーに保存してください。送信はサーバー側のコードからのみ行い、送信先は Gateway と同じベース URL(https://api.phaseo.app/v1)です。

管理キー、API キー、OAuth トークン

管理ルートが受け付けるのは管理キー(または OAuth トークン)のみです。Gateway API キーでは呼び出せません。 ガードレールは別の制御です。Gateway API キーに適用され、ルーティング制限、予算、プロンプトインジェクションへの対処、機密情報のルールなど、推論トラフィックを管理します。管理キーの機能は、そのキーが呼び出せる管理 API を決めます。

アクセスレベルを選ぶ

各テンプレートは、キーの作成時に明示的な機能のリストに展開されます。Phaseo は all のようなワイルドカードを保存しないため、後から追加された権限をキーが得ることはありません。 クレジットのチャージを開始する billing:write はどのテンプレートにも含まれません。必要な場合は --scopes で明示的に指定してください。すべて は信頼できる管理用の自動化にのみ使ってください。 付与範囲をさらに絞るには、必要な機能を --scopes scope_a,scope_b で指定します。

機能はワークスペースのロールに優先しない

Phaseo は呼び出しのたびに 2 つの点を確認します。キーがその機能を持っていること、そしてキーまたは OAuth ユーザーが、その操作に必要なロールでワークスペースに所属していることです。たとえば keys:write があればキー管理が許可されますが、呼び出し元がそのワークスペースでキーを管理できるかどうかは、引き続きロールのチェックで決まります。機能を使って別のワークスペースにアクセスしたり、オーナーや管理者のチェックを回避したりすることはできません。

キーを安全に保つ

  • 管理キーをブラウザー、デスクトップのログ、ソース管理、チャットに含めないでください。
  • 連携ごとに 1 つのキーを使い、動作する範囲で最も狭いテンプレートを選んでください。
  • 無期限のアクセスが不要な連携には有効期限を設定してください。
  • 使っていないキーはすぐに一時停止するか削除してください。
  • キーが漏えいした場合は、調査を進める前にローテーションしてください。
最終更新日 2026年11月7日