権限スコープ
すべての HTTP ルートとすべての MCP ツールは、ひとつのスコープを検査します。どちらのインターフェースも同じハンドラを実行するため、検査されるスコープも同じです。
Auth0 はトークン上の Edge ロールを通じてスコープを付与します。必要なスコープを持たないトークンには 403 が返り、メッセージに必要なスコープ名が含まれます。Edge ロールを持たないユーザーには Edge のスコープは付きません。
スコープ一覧
現在 Edge が検査する文字列は次のとおりです。
| スコープ | 許可される操作 |
|---|---|
namespace.read | 組織が持つワークスペースの一覧 |
distribution.read | distribution の一覧と取得、slug の空き確認、リダイレクトとヘッダーのチェック、リダイレクトのエクスポート |
distribution.write | distribution の作成、更新、複製、リダイレクトのインポート |
distribution.destroy | distribution の削除 |
deployment.read | deployment の一覧と取得、2 つの差分、公開済みファイルの一覧と取得、予約の一覧 |
deployment.write | deployment の作成と commit、pending deployment へのファイル書き込みと削除 |
deployment.promote | deployment の promote(すぐに、または予約して)、切り戻し、公開停止と復元、予約の取り消し、キャッシュの無効化 |
document.read | データオブジェクトの読み取り(MCP のみのバージョン履歴を含む) |
document.write | データオブジェクトの書き込み、削除、切り戻し |
domain.read | ドメインの一覧と取得 |
domain.manage | ドメインの作成、検証、割り当て、割り当て解除 |
domain.destroy | ドメインの削除 |
analytics.read | アナリティクスの照会、パスの探索、リアルタイム訪問者、プロパティ、distribution の health |
goals.read | コンバージョンゴールの一覧、取得、チェック |
goals.write | コンバージョンゴールの作成、更新、アーカイブ |
funnels.read | グループとファネルの一覧、定義の検証、結果の照会 |
funnels.write | グループの作成と更新、ファネルの作成・更新・アーカイブ |
properties.write | アナリティクスプロパティの宣言、更新、アーカイブ |
pii.read | PII ディテクタ、実効ポリシー、検出レポートの参照 |
pii.policy.write | PII ポリシーの変更、プロパティの免除の付与と取り消し |
logs.read | リクエストログの参照 |
access.read | 訪問者アクセスのルール、ネットワークルール、サインアウトの参照 |
access.write | 訪問者アクセスのルールとネットワークルールの変更と、訪問者のサインアウト |
function.read | 関数ランタイムの一覧と検査、呼び出し、ログの参照 |
function.write | 関数ランタイムの作成、更新、削除 |
cron.read | cron の一覧とその実行履歴の参照 |
cron.write | cron の作成、更新、一時停止、今すぐ実行、削除 |
queue.read | キューの一覧、統計と実行履歴の参照、メッセージの確認 |
queue.write | キューの作成、更新、一時停止、purge、redrive、削除 |
queue.send | キューへのメッセージ送信だけ |
workflow.read | ワークフローの実行の一覧とそのステップの参照 |
workflow.write | ワークフローの実行の開始、シグナル送信、キャンセル、再試行 |
webhook.read | Webhook サブスクリプションとその配信の一覧と取得 |
webhook.write | Webhook サブスクリプションの作成、更新、テスト、ローテーション、再配信、削除 |
hook.read | フックとその受信記録の一覧と取得 |
hook.write | フックの作成、更新、削除 |
form.forward | Webhook でフォームの送信(form.*)を購読する。webhook.write に加えて必要 |
submission.read | ワークスペース内のすべてのフォームの送信内容とアップロードされたファイル、およびその読み取りのアクセスログの参照 |
token.admin | 組織内のすべてのパーソナルアクセストークンの一覧と取り消し |
名前について
スコープ文字列は Edge の内部名であり、このドキュメントで使う語と一致しないものがあります。特にワークスペースに関するスコープは workspace.read ではなく namespace.read、データオブジェクトは endpoint.read ではなく document.read / document.write、関数ランタイムは function.read / function.write です。上記のとおりに送信してください。
data.read や data.write は送らないでください。これらの名前は廃止されています。
標準ロール
ロールは Auth0 のプリセットです。ひとりが複数の Edge ロールを持つ場合、スコープは合算されます。各操作のスコープ検査が最終的な判断です。
| ロール | 付与対象 |
|---|---|
edge:member | コンソールの読み取りのみ |
edge:publisher | エージェントによる公開に加え、関数、ゴール、ファネル、プロパティ。ドメイン、PII、destroy は含まない |
edge:manager | member + publisher + ドメイン管理、Webhook とフック、フォームの送信内容の参照。destroy、PII、フォームの転送、トークン管理は含まない |
edge:admin | publisher + destroy、すべてのドメインスコープ、PII、Webhook、フック、フォームの送信内容の参照、フォームの転送、トークン管理 |
権限マトリクス
行は「誰ができるか」でまとめてあるので、ロールの差が隣り合って見えます。行が yes でも、必要なスコープがトークンに無ければ操作は 403 になります。各操作のスコープ検査が最終的な判断です。
全員が ワークスペース、distribution、deployment、アナリティクス、ログを読めます。 publisher はそこに 作成・更新 が加わります。manager は ドメイン管理 が加わり、 publisher には無い member のドメイン参照も持ちます。admin は destroy と PII が加わります。
| できること | スコープ | member | publisher | manager | admin |
|---|---|---|---|---|---|
| ワークスペースの参照 | namespace.read | yes | yes | yes | yes |
| distribution の参照 | distribution.read | yes | yes | yes | yes |
| deployment と公開済みファイルの参照 | deployment.read | yes | yes | yes | yes |
| アナリティクスの参照 | analytics.read | yes | yes | yes | yes |
| リクエストログの参照 | logs.read | yes | yes | yes | yes |
| 訪問者アクセスの参照 | access.read | yes | — | yes | yes |
| 訪問者アクセスの変更とサインアウト | access.write | — | — | yes | yes |
| カスタムドメインの参照 | domain.read | yes | — | yes | yes |
| distribution の作成、更新、複製 | distribution.write | — | yes | yes | yes |
| deployment の作成、commit、パッチ | deployment.write | — | yes | yes | yes |
| promote、予約、公開停止、切り戻し、キャッシュ無効化 | deployment.promote | — | yes | yes | yes |
| データオブジェクトの読み書き | document.read, document.write | — | yes | yes | yes |
| ゴールの作成と更新 | goals.read, goals.write | — | yes | yes | yes |
| ファネルの作成と更新 | funnels.read, funnels.write | — | yes | yes | yes |
| プロパティの宣言 | properties.write | — | yes | yes | yes |
| 関数ランタイムの管理 | function.read, function.write | — | yes | yes | yes |
| cron とその実行履歴の参照 | cron.read | yes | yes | yes | yes |
| cron の作成、変更、実行、削除 | cron.write | — | yes | yes | yes |
| キューとメッセージの管理 | queue.read, queue.write | — | yes | yes | yes |
| キューへのメッセージ送信 | queue.send | — | yes | yes | yes |
| ワークフローの実行の参照 | workflow.read | yes | yes | yes | yes |
| ワークフローの実行の開始、シグナル送信、キャンセル、再試行 | workflow.write | — | yes | yes | yes |
| ドメインの割り当てと管理 | domain.manage | — | — | yes | yes |
| Webhook とフックの管理 | webhook.read, webhook.write, hook.read, hook.write | — | — | yes | yes |
| フォームの送信内容とアップロードされたファイルの参照 | submission.read | — | — | yes | yes |
| distribution の削除 | distribution.destroy | — | — | — | yes |
| ドメインの削除 | domain.destroy | — | — | — | yes |
| PII ポリシーの参照と変更 | pii.read, pii.policy.write | — | — | — | yes |
| フォームの送信を Webhook に転送 | form.forward | — | — | — | yes |
| 全員のアクセストークンの管理 | token.admin | — | — | — | yes |
どのロールも 自分の パーソナルアクセストークン を作成、一覧、取り消しできます。スコープは不要です。トークンには作成者が持つスコープしか付けられず、token.admin は付けられません。
admin は「member に全部足したもの」ではありません。publisher を土台に、destroy、ドメイン、 PII を足します。domain.read は admin のプリセットにあるので、admin はドメインを読めます。 publisher のトークンは、いまも health.read を持つことがあります。Edge はこの文字列を検査しません。ファイルは deployment.read / deployment.write、health は analytics.read です。
不足しているスコープを見つける
- 公開と本番切り替えは別です。
deployment.writeは deployment をビルドしてプレビューを公開します。本番にするにはdeployment.promoteが必要です。 - 削除は常に独立しています。
distribution.destroyとdomain.destroyは、対応するwriteやmanageには含まれません。 - コンテンツ専用のスコープはありません。 deployment のファイルは
deployment.readとdeployment.writeでカバーされます。ツール名がedge_content_*で、パスが/v1/deployments/{id}/contentであっても同じです。 - ドメインは publisher にはありません。
domain.readは member(と admin)にあります。domain.manageは manager と admin にあります。公開は通るのにドメインの呼び出しが 403 になる場合はこれが理由です。 - データオブジェクトは publisher にあります。
/_apiのマッピングはdistribution.writeを使います。関数ランタイムはfunction.read/function.writeで、publisher(したがって manager と admin)にあります。 - ログはアナリティクスとは別です。
analytics.readはlogs.readを含みません。どちらも member、publisher、manager、admin にあります。 - コンバージョンの参照と作成は別です。
analytics.readはコンソールでコンバージョン結果を表示します。ゴール、ファネル、プロパティの作成にはgoals.write、funnels.write、properties.writeが必要です。標準ロールでは publisher、manager、admin です。 - PII ポリシーは管理操作です。
pii.policy.writeは admin のみです。 - フォームのデータには個別の承認が必要です。
webhook.writeはフォームの送信を除くすべてのイベントを対象とします。form.*を購読するには、さらにform.forward(admin のみ)が必要で、リクエストに"confirm": trueを含める必要があります。 - 送信内容の参照は独立したスコープです。
submission.readは、ワークスペース内のすべてのフォームの送信内容とアップロードされたファイル、つまり訪問者の個人データを対象とします。manager と admin が持っています。パーソナルアクセストークンに付くのは、作成者が選んだ場合だけです。どのプリセットにも含まれず、作成時に個人データについての警告が表示されます。エージェントとトークンの読み取りには 1 日の上限があり、記録されます。フォームの送信内容をエージェントに読ませる を参照してください。