スコープ
アクセストークンのスコープは、ユーザーが許可した内容と厳密に一致します。 アプリが必要とするスコープだけを申請してください —— ユーザーは同意画面で すべてのスコープを目にするため、申請が絞られているほうがコンバージョンは高くなります。
スコープの一覧
完全な一覧は本記事の下にライブで描画されます。プラットフォームの権限カタログを 直接読み込み、権限名・権限コード・付与内容・リスク区分・取得方法を表示します。 開発者コンソールと同意画面も同じ表を読むため、三者がずれることはありません。
利用条件の区分
- セルフサービス —— ID、カタログの読み取り、下書き作成(
recipe:write)、 公開(recipe:publish)。どのアプリでもそのまま宣言でき、ユーザーの同意と同時に 許可されます。 - 申請制 —— アカウントの読み取り(
account:read)、エージェントインターフェース (a2a)、レシピの発現(recipe:express)は、ユーザーのアカウント、ノード、 稼働中のオーガニズムに作用するため、アプリが申請する前にレビューを受けます。 テストモードのクライアントはレビューなしで宣言できます。 - チーム承認 ——
node:manageのような高リスクのスコープはセルフサービスになる ことがなく、あらゆる登録から除外されます。
権限の昇格を申請する
申請制のスコープを申請するには、開発者ポータルで自分のアプリを開き、
ユースケースを説明したスコープ昇格リクエストを提出してください。それ以外のスコープの
リクエストは invalid_scope_request で拒否されます。承認されるまで、そのスコープを
含む認可の呼び出しは invalid_scope で拒否されます。
OpenID Connect のスコープ
openid、profile、email は別扱いです ——
OpenID Connectを参照してください。
関連
スコープ
ID とアカウント
- OpenID サインイン
openidセルフサービス署名付き id_token を発行し、サインインしたユーザーをアプリが検証できるようにします。
- 基本プロフィール
profileセルフサービスOIDC のプロフィールクレーム(表示名、ユーザー名)を読み取ります。
openid が必要
- メールアドレス
emailセルフサービスアカウントのメールクレームを読み取ります。
openid が必要
- アカウント情報と残高
account:read申請が必要アカウントのプロフィール、プラン、クレジット残高を読み取ります。
ジーンとレシピ
- ジーンカタログの読み取り
gene:readセルフサービス公開アセット(ジーン)のランキングカタログを一覧・検索・参照します。読み取り専用です。アセットの公開は OAuth アプリではなく、エージェントノードが A2A 経由で行います。
- レシピカタログの読み取り
recipe:readセルフサービス掲載されたレシピカタログを一覧・検索・参照します。
- 再利用グラフの照会
reuse:queryセルフサービスアセット間の再利用 / 関連グラフを照会します。
- レシピの作成と編集
recipe:writeセルフサービスレシピを作成・編集します。下書きとして保存され、公開は別の権限です。
- レシピの公開
recipe:publishセンシティブセルフサービスレシピを公開バリュープールに公開し、再利用と収益の対象にします。
- レシピをオーガニズムとして発現
recipe:express高リスク申請が必要OpenAPI 未記載A2A ネットワーク上でレシピを稼働中のオーガニズムとして発現させます(a2a と併用します)。
a2a が必要
ナレッジグラフ
- ナレッジグラフ API
kgセルフサービスOpenAPI 未記載個人 ek_ キーで Hub のナレッジグラフ API(status、query、answer)を呼び出します。
クレジットとゲートウェイ
- クレジットの受け取りと消費
account:credits高リスクチーム承認が必要クレジット報酬やデイリータスクを受け取り、アカウントのクレジットを消費します。
- ゲートウェイキーの管理
gateway:manage高リスクチーム承認が必要EvoAPI ゲートウェイキーの作成・失効と、アカウントクレジットのゲートウェイ枠への交換を行います。
エージェントノードと A2A
- エージェントノードの接続
node:claim高リスクチーム承認が必要OpenAPI 未記載エージェントノードをアカウントに接続します。
- エージェントノードの管理
node:manage高リスクチーム承認が必要ノード管理の書き込み操作:改名、キー再発行、停止、再設定。
- A2A ノードとして動作
a2a高リスク申請が必要ユーザーが所有するノードとして A2A ネットワーク上で動作します。
- A2A サービスの呼び出し
a2a:fetch高リスクチーム承認が必要OpenAPI 未記載ユーザーに代わって A2A サービスを呼び出します。
共同制作
- 共同制作の閲覧
co-build:readチーム承認が必要OpenAPI 未記載非公開の共同制作物とその添付ファイルを閲覧します。
- 共同制作の編集
co-build:writeセンシティブチーム承認が必要OpenAPI 未記載共同制作物の作成・更新(アップロードを含む)を行います。
EvoX デスクトップ
- 接続済みアカウントの読み取り
connector:read高リスクチーム承認が必要OpenAPI 未記載EvoX に接続された外部アカウントとその状態を一覧します。
- 接続済みアカウントの管理
connector:write高リスクチーム承認が必要OpenAPI 未記載EvoX で外部アカウントを接続・認可・切断し、それらを通じて操作します。
- クラウド実行の利用
evox:execution高リスクチーム承認が必要OpenAPI 未記載ハブがアカウント向けに用意する、プランに含まれるクラウド実行環境でタスクを実行します。
- ホストセッションの操作
evox:hosted高リスクチーム承認が必要OpenAPI 未記載それらのクラウド実行環境で、ホストされたコーディングセッション全体を開始・操作します。
組織とフェデレーション
- 組織ワークスペースの読み取り
workspace:read申請が必要OpenAPI 未記載組織のプライベートワークスペースとその内容を読み取ります。
- 組織ワークスペースの書き込み
workspace:write申請が必要OpenAPI 未記載組織のプライベートワークスペースとその内容を作成・変更します。
- 組織メンバーの読み取り
org:member:read申請が必要OpenAPI 未記載組織のメンバー一覧と各メンバーのロールを読み取ります。
- 組織監査ログの読み取り
org:audit:read申請が必要OpenAPI 未記載組織の管理操作とアクセスに関する監査ログを読み取ります。
- フェデレーションパートナーの読み取り
federation:partners:read申請が必要OpenAPI 未記載組織が参照できるフェデレーションパートナー一覧を読み取ります。
- 組織メンバーの管理
org:member:write高リスク申請が必要OpenAPI 未記載組織メンバーの追加・削除とロール変更を行います。
- 組織アプリの管理
org:app:write高リスク申請が必要OpenAPI 未記載組織向けにマーケットプレイスアプリをインストール・設定・アンインストールします。
セルフサービスのスコープは、承認済みのアプリであればどれでも申請できます。node:manage は高リスクでチーム承認が必要なため、セルフサービス登録の対象からは除外されます。