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