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 つのキーを使い、動作する範囲で最も狭いテンプレートを選んでください。
- 無期限のアクセスが不要な連携には有効期限を設定してください。
- 使っていないキーはすぐに一時停止するか削除してください。
- キーが漏えいした場合は、調査を進める前にローテーションしてください。