Skip to content

権限スコープ ​

すべての HTTP ルートとすべての MCP ツールは、ひとつのスコープを検査します。どちらのインターフェースも同じハンドラを実行するため、検査されるスコープも同じです。

Auth0 はトークン上の Edge ロールを通じてスコープを付与します。必要なスコープを持たないトークンには 403 が返り、メッセージに必要なスコープ名が含まれます。Edge ロールを持たないユーザーには Edge のスコープは付きません。

スコープ一覧 ​

現在 Edge が検査する文字列は次のとおりです。

スコープ許可される操作
namespace.read組織が持つワークスペースの一覧
distribution.readdistribution の一覧と取得、slug の空き確認、リダイレクトとヘッダーのチェック、リダイレクトのエクスポート
distribution.writedistribution の作成、更新、複製、リダイレクトのインポート
distribution.destroydistribution の削除
deployment.readdeployment の一覧と取得、2 つの差分、公開済みファイルの一覧と取得、予約の一覧
deployment.writedeployment の作成と commit、pending deployment へのファイル書き込みと削除
deployment.promotedeployment の 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.readPII ディテクタ、実効ポリシー、検出レポートの参照
pii.policy.writePII ポリシーの変更、プロパティの免除の付与と取り消し
logs.readリクエストログの参照
access.read訪問者アクセスのルール、ネットワークルール、サインアウトの参照
access.write訪問者アクセスのルールとネットワークルールの変更と、訪問者のサインアウト
function.read関数ランタイムの一覧と検査、呼び出し、ログの参照
function.write関数ランタイムの作成、更新、削除
cron.readcron の一覧とその実行履歴の参照
cron.writecron の作成、更新、一時停止、今すぐ実行、削除
queue.readキューの一覧、統計と実行履歴の参照、メッセージの確認
queue.writeキューの作成、更新、一時停止、purge、redrive、削除
queue.sendキューへのメッセージ送信だけ
workflow.readワークフローの実行の一覧とそのステップの参照
workflow.writeワークフローの実行の開始、シグナル送信、キャンセル、再試行
webhook.readWebhook サブスクリプションとその配信の一覧と取得
webhook.writeWebhook サブスクリプションの作成、更新、テスト、ローテーション、再配信、削除
hook.readフックとその受信記録の一覧と取得
hook.writeフックの作成、更新、削除
form.forwardWebhook でフォームの送信(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:managermember + publisher + ドメイン管理、Webhook とフック、フォームの送信内容の参照。destroy、PII、フォームの転送、トークン管理は含まない
edge:adminpublisher + destroy、すべてのドメインスコープ、PII、Webhook、フック、フォームの送信内容の参照、フォームの転送、トークン管理

権限マトリクス ​

行は「誰ができるか」でまとめてあるので、ロールの差が隣り合って見えます。行が yes でも、必要なスコープがトークンに無ければ操作は 403 になります。各操作のスコープ検査が最終的な判断です。

全員が ワークスペース、distribution、deployment、アナリティクス、ログを読めます。 publisher はそこに 作成・更新 が加わります。manager は ドメイン管理 が加わり、 publisher には無い member のドメイン参照も持ちます。admin は destroy と PII が加わります。

できることスコープmemberpublishermanageradmin
ワークスペースの参照namespace.readyesyesyesyes
distribution の参照distribution.readyesyesyesyes
deployment と公開済みファイルの参照deployment.readyesyesyesyes
アナリティクスの参照analytics.readyesyesyesyes
リクエストログの参照logs.readyesyesyesyes
訪問者アクセスの参照access.readyes—yesyes
訪問者アクセスの変更とサインアウトaccess.write——yesyes
カスタムドメインの参照domain.readyes—yesyes
distribution の作成、更新、複製distribution.write—yesyesyes
deployment の作成、commit、パッチdeployment.write—yesyesyes
promote、予約、公開停止、切り戻し、キャッシュ無効化deployment.promote—yesyesyes
データオブジェクトの読み書きdocument.read, document.write—yesyesyes
ゴールの作成と更新goals.read, goals.write—yesyesyes
ファネルの作成と更新funnels.read, funnels.write—yesyesyes
プロパティの宣言properties.write—yesyesyes
関数ランタイムの管理function.read, function.write—yesyesyes
cron とその実行履歴の参照cron.readyesyesyesyes
cron の作成、変更、実行、削除cron.write—yesyesyes
キューとメッセージの管理queue.read, queue.write—yesyesyes
キューへのメッセージ送信queue.send—yesyesyes
ワークフローの実行の参照workflow.readyesyesyesyes
ワークフローの実行の開始、シグナル送信、キャンセル、再試行workflow.write—yesyesyes
ドメインの割り当てと管理domain.manage——yesyes
Webhook とフックの管理webhook.read, webhook.write, hook.read, hook.write——yesyes
フォームの送信内容とアップロードされたファイルの参照submission.read——yesyes
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 日の上限があり、記録されます。フォームの送信内容をエージェントに読ませる を参照してください。

あわせて読む ​