オペレーターのスコープ

Operator スコープは、Gateway クライアントが認証後に実行できることを制限します。 これは、1つの信頼された Gateway オペレーター ドメイン内の制御プレーンのガードレールであり、 敵対的なマルチテナント分離ではありません。人、チーム、またはマシン間で強い分離が必要な場合は、 別々の OS ユーザーまたはホストで別々の Gateway を実行してください。 関連: セキュリティ, Gateway プロトコル, Gateway ペアリング, デバイス CLI.

​

ロール

すべての Gateway WebSocket クライアントは、1つのロールで接続します。

• operator: CLI、Control UI、自動化、および 信頼されたヘルパープロセスなどの制御プレーンクライアント。
• node: node.invoke を通じて コマンドを公開する機能ホスト (macOS、iOS、Android、ヘッドレス)。

Operator RPC メソッドには operator ロールが必要です。node 発のメソッドには node ロールが必要です。

​

スコープ レベル

将来の未知の operator.* スコープは、呼び出し元がすでに operator.admin を 保持していない限り、完全一致が必要です。

​

メソッド スコープは最初のゲートにすぎない

各 Gateway RPC には、リクエストがハンドラーに到達できるかどうかを決める 最小権限のメソッド スコープがあります。その後、一部のハンドラーは、承認または変更される 具体的な対象に基づいて、より厳密なチェックを適用します。

• device.pair.approve は operator.pairing で到達できますが、operator デバイスの承認で 発行または維持できるのは、呼び出し元がすでに保持しているスコープだけです。
• node.pair.approve は operator.pairing で到達でき、その後、保留中の node が宣言したコマンド一覧から 追加の承認スコープを導出します。
• chat.send は write スコープのメソッドですが、/config set および /config unset チャット コマンドには、呼び出し元の chat-send スコープに関係なく、 さらに operator.admin が必要です。

これにより、低スコープの operator は、すべてのペアリング承認を admin 限定にすることなく、 低リスクのペアリング アクションを実行できます。

​

デバイス ペアリング承認

デバイス ペアリング レコードは、承認済みロールとスコープの永続的なソースです。 すでにペアリング済みのデバイスが、暗黙的により広いアクセスを得ることはありません。より広いロールまたは より広いスコープを要求する再接続は、新しい保留中のアップグレード リクエストを作成します。 デバイス リクエストの承認:

• operator ロールを含まないリクエストには、operator スコープ承認は不要です。
• 非 operator デバイス ロール (たとえば node) のリクエストには、 device.pair.approve 自体は operator.pairing だけを必要とする場合でも、 operator.admin が必要です。
• operator.read、operator.write、operator.approvals、 operator.pairing、または operator.talk.secrets のリクエストには、呼び出し元がすでに そのスコープ、または operator.admin を保持している必要があります。
• operator.admin のリクエストには operator.admin が必要です。
• 明示的なスコープを含まない修復リクエストは、既存の operator トークンのスコープを継承できます。そのトークンが admin スコープの場合でも、承認には operator.admin が必要です。

非 admin の共有シークレット セッションと信頼済みプロキシ セッションは、自身が宣言した operator スコープ内でのみ operator-device リクエストを承認できます。これらのセッションが それ以外では operator.pairing を使用できる場合でも、非 operator ロールの承認は admin 限定です。 ペアリング済みデバイス トークン セッションでは、呼び出し元が operator.admin を持たない限り、 管理は自己スコープです。非 admin の呼び出し元は自身のペアリング エントリだけを確認でき、 自身のデバイス エントリだけを承認、拒否、ローテーション、取り消し、または削除できます。

​

Node ペアリング承認

従来の node.pair.* メソッドは、Gateway 所有の別個の node ペアリング ストアを使用します。 WS node は代わりにデバイス ペアリング (role: node) を使用しますが、同じ承認 語彙が適用されます。2つのストアの関係については、Gateway ペアリング を参照してください。 node.pair.approve は、保留中のリクエストのコマンド一覧から追加の必須スコープを導出します。 Node ペアリングはアイデンティティと信頼を確立します。node 自身の system.run exec 承認ポリシーを置き換えるものではありません。

​

共有シークレット認証

共有 gateway トークン/パスワード認証は、その Gateway に対する信頼された operator アクセスとして扱われます。 OpenAI 互換 HTTP サーフェス、/tools/invoke、および HTTP セッション履歴エンドポイントは、呼び出し元がより狭い宣言済みスコープを送信した場合でも、 共有シークレット bearer 認証に対して完全なデフォルト operator スコープ セットを復元します。 信頼済みプロキシ認証や private-ingress none などの identity-bearing モードは、 明示的な宣言済みスコープを引き続き尊重できます。実際の信頼境界の分離には、別々の Gateway を使用してください。