APIキーは組織に属し、明示的な権限を持ちます。エージェントの取り込み、ポリシー配信、評価器、CI自動化、管理スクリプトにはそれぞれ専用のキーを使用してください。
キーの作成とローテーション
- 管理 → キー に移動し、新規キー を選択してワークロード名を入力します。
- 権限セットを選択し、プリセットが不十分な場合のみ個別の権限を調整します。
- キーを作成し、ワンタイムシークレットをすぐにコピーします。
- 後でキーを開いて、付与内容の更新、無効化、またはシークレットの再生成を行います。
作成ドロワーでは、ワークロードに必要な最小限の権限を選択します。
作成後、キーページには永続的なメタデータと管理アクションが表示されます。ワンタイムシークレットは再表示されません。
このリストを使用して付与内容を定期的に確認し、有効なワークロードに対応しなくなったキーを無効化してください。作成・再生成時の出力は安全にリダイレクトまたはキャプチャしてください。シークレットは一度だけ返されます。
events:add はイベントとセッションデータを送信します。policies:pull は割り当てられたポリシーデプロイメントを取得します。
キーシークレットは作成時または再生成時に表示されます。シークレットマネージャーに保存し、オペレーターのインタラクティブな認証情報を再利用せずにローテーションしてください。
権限カタログ
orgs:admin はインスタンスオペレーター専用に予約されており、組織キーや一般メンバーには付与できません。廃止された incidents:* および alerts:ack トークンは互換性のために受け入れられ、現在の issues:* 権限に正規化されます。
組み込みの権限セットは read-only、standard、admin です。standard は読み取り権限に加えて、評価のトリガー、クエリの実行、課題への対応、アシスタントの使用が追加されます。キー作成時に権限セットにヒューマン専用の付与が含まれていても、それらは除外されます。
インスタンススコープのキーは X-AgentEye-Org ヘッダーで組織を選択できます。マルチ組織デプロイメントでは明示的に設定してください。省略した場合、デフォルトの組織が選択される可能性があります。
