Skip to content

パーソナルアクセストークンを作成する ​

パーソナルアクセストークン(edge_pat_…)を使うと、スクリプト、CI ジョブ、エージェントがブラウザでのサインインなしに、あなたとして Edge を呼び出せます。できることと期限はあなたが選び、いつでも取り消せます。

どのトークンにも次の 3 つのルールがあります。

  • あなた以上の権限は持てません。 付けられるのは自分のロールが持つスコープだけです。token.admin は付けられません。
  • 1 つのワークスペースでだけ使えます。 作成したワークスペースです。別のワークスペースへのリクエストは 403 になります。
  • 表示は一度だけです。 Edge はハッシュしか保存しません。なくした場合は取り消して、新しく作成してください。

権限と有効期限を選ぶ ​

用途に足りる、いちばん狭いものを選んでください。

権限スコープ用途
読み取りのみnamespace.read, distribution.read, deployment.read, domain.read, analytics.read, logs.readダッシュボードやレポート
プレビューの公開distribution.read, deployment.read, deployment.writeプルリクエストのプレビュー。公開中のサイトは変えられません
公開と promote上記に加えて deployment.promotedeployment を公開するリリースジョブ
カスタム自分が持つ任意のスコープそれ以外

有効期限は 7 日、30 日(既定)、60 日、90 日、1 年、1 年以内の任意の日付、または 無期限 から選べます。無期限のトークンは取り消されるまで権限を持ち続けます。期限を付け、切れる前に入れ替えることをおすすめします。

コンソールで作成する ​

  1. サイドバーの Access tokens を開きます(https://app.edge.deca-dev.com/edge/{workspaceId}/access-tokens)。
  2. Create token を選びます。
  3. Name に、使うものがわかる名前を入れます(例: github-actions)。
  4. Permissions と Expiration を選びます。No expiration を選ぶと警告が表示されます。
  5. Review を選び、名前、ワークスペース、スコープ、有効期限を確認します。
  6. Create token を選び、トークンをコピーします。表示されるのはこの一度だけです。

トークンを作成しても、どのサイトも変わりません。

エージェント、CLI、または API で作成する ​

text
プレビューを公開できて 90 日で切れる、github-actions という名前の
パーソナルアクセストークンを作って。作る前にサマリーを見せて。
bash
edge tokens create
bash
# 1. サマリーを取得する。まだ何も作成されない。
curl -s -X POST https://api.edge.deca-dev.com/v1/tokens \
  -H "Authorization: Bearer $EDGE_SIGN_IN_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"github-actions","preset":"publish_previews","expiration":"90d"}'

# 2. 確認したら、同じ本文に "confirm": true を付けて送る。
curl -s -X POST https://api.edge.deca-dev.com/v1/tokens \
  -H "Authorization: Bearer $EDGE_SIGN_IN_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"github-actions","preset":"publish_previews","expiration":"90d","confirm":true}'

1 回目の呼び出しは、確認するサマリーを返します。

json
{
  "confirmation_required": true,
  "summary": {
    "name": "github-actions",
    "namespace_id": "5c1e2a90-3f4b-4d6e-9a17-2b8c0d4e6f13",
    "scopes": ["deployment.read", "deployment.write", "distribution.read"],
    "expires_at": "2027-01-08T12:00:00Z"
  }
}

2 回目は、トークンを一度だけ返します。

json
{
  "id": "01M4B2C9QW7RZJ5K8XYV3NTPDA",
  "name": "github-actions",
  "token": "edge_pat_3kT9vQ…",
  "hint": "edge_pat_…7QxZ",
  "status": "active",
  "notice": "Copy the token now. Edge stores only its hash and cannot show it again."
}

エージェントは edge_token_create を実行します。サマリーをあなたに見せて返事を待ってから、confirm を付けて再び呼び出す必要があります。パーソナルアクセストークンで別のトークンは作成できません。トークンはサインインしたセッションから作成してください。

スコープを個別に選ぶ場合は、preset の代わりに "scopes": ["deployment.read", "deployment.write"] を送ります。日付を指定する場合は、expiration の代わりに "expires_at": "2026-12-31" を送ります。無期限にする場合は "expiration": "never" を送ります。このときサマリーには warning が付きます。

使う ​

サインイン時のトークンと同じように、Bearer トークンとして送ります。

bash
curl -s https://api.edge.deca-dev.com/v1/distributions \
  -H "Authorization: Bearer edge_pat_3kT9vQ…"

HTTP API と、Authorization ヘッダーを設定できるクライアントからの MCP サーバー(https://mcp.edge.deca-dev.com)で使えます。CLI と CI では EDGE_TOKEN として保存してください。GitHub Actions から公開する を参照してください。

一覧と取り消し ​

Access tokens ページに、自分のトークンのスコープ、有効期限、最終使用日時、状態が一覧されます。行の Revoke を選ぶとトークンはすぐに無効になり、それを使っているものは 401 を受け取るようになります。取り消しは元に戻せません。

text
Edge のアクセストークンを一覧して、old-ci という名前のものを取り消して。
bash
edge tokens ls
edge tokens revoke 01M4B2C9QW7RZJ5K8XYV3NTPDA
bash
curl -s https://api.edge.deca-dev.com/v1/tokens -H "Authorization: Bearer $EDGE_SIGN_IN_TOKEN"
curl -s -X DELETE https://api.edge.deca-dev.com/v1/tokens/01M4B2C9QW7RZJ5K8XYV3NTPDA \
  -H "Authorization: Bearer $EDGE_SIGN_IN_TOKEN"

エージェントは edge_token_list と edge_token_revoke を実行します。一覧にトークンそのものは含まれず、edge_pat_…7QxZ のようなヒントだけが表示されます。

token.admin を持つ管理者は、組織内の全員のトークンを一覧し(GET /v1/tokens?all=true)、どれでも取り消せます。メンバーが離れたりロールが変わったりしたときに行ってください。トークンは、期限切れか取り消しまで、作成時のスコープを持ち続けます。

次に読む ​