Admin API トークン有効期限 「本番強制の前に」自分で ON にして試せる
原題: Opt in to Admin API token expiry in the Dev Dashboard
- Admin API
- Apps
- Dev Dashboard
- OAuth
- アクセストークン
- トークン有効期限
- GraphQL
- REST
- 仕様変更
図解 : Dev Dashboard で Admin API トークン有効期限を先行 ON にできるように Admin API / Dev Dashboard / 任意設定 Admin API トークン有効期限 「本番強制の前に」自分で ON にして試せる Dev Dashboard のアプリ設定から、期限付きトークン必須モードを先行で有効化できるようになった。既存公開アプリへの強制は 2027 年 4 月 1 日。それまでに移行が正しくできているかを安全に検証できる。 このページの構成 そもそも何が変わるのか(30秒で理解) 仕組み図解 : ON にした後のリクエストの扱い 拒否されるトークン/通るトークン 対象アプリと 2027/4/1 期限の関係 タイムライン 先行検証の手順(3ステップ) 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 そもそも何が変わるのか 既存の公開アプリは 2027 年 4 月 1 日 から「期限付き Admin API トークン」が強制される。 今回、その強制モードを Dev Dashboard のアプリ設定で任意に先行 ON できるようになり、本番の締切前に移行の正しさを確かめられる。 これまで : 締切日まで本番挙動が分からない 移行ガイドに沿って実装しても、実際に「期限なしトークンが拒否される」状態での動作は強制開始まで確認できなかった。 これから : 自分のタイミングで強制を試せる Settings の「Admin API token expiry」カードで Turn on。問題があれば OFF に戻せる。 2 仕組み図解 : ON にした後のリクエストの扱い 設定は アプリ単位 で ON にし、そのアプリがインストールされている すべてのストア に適用される。反映までは 最大 30 分 かかる。 ON にしても 既存トークンの移行や失効は行われない (要件を満たさないトークンでのリクエストが失敗するようになるだけ)。 3 拒否されるトークン/通るトークン ON 時にリクエストが失敗するもの 失敗 期限なし(non-expiring)の offline access token 従来型の「無期限で使い続けられる」オフライントークン。 失敗 有効期限まで 24 時間超が残る delegate access token delegate トークンは残り有効期間が 24 時間以内である必要がある。 対象は GraphQL と REST の両方の Admin API 。失敗時のエラーコード・レスポンス形式の詳細は本記事に記載なし。 4 対象アプリと 2027/4/1 期限の関係 アプリ種別 この設定を使えるか 2027/4/1 の強制 既存の公開アプリ(public app) 使える 対象 期限は設定の ON/OFF に関係なく有効 カスタムアプリ 使える 挙動テスト用途 対象外 マーチャントが自ストア用に作ったアプリ 使える 挙動テスト用途 対象外 設定を ON にしていないアプリ — 影響なし(ON にしたアプリだけに効く) 設定は 任意 。ON にしなくてもよいが、公開アプリは移行ガイドに書かれた 既存の移行期限を守る必要がある 。 5 タイムライン 6 先行検証の手順(3ステップ) 1 移行を完了してログを確認 移行ガイドに沿って実装後、GraphQL / REST ログで該当リクエストを確認。Dev Dashboard は直近 14 日の問題候補をハイライト(検出は最大 1 日遅れ)。 2 Settings で Turn on Dev Dashboard でアプリを開き Settings > Admin API token expiry カードの「Turn on」。要件を満たさないリクエストは失敗することを確認して確定。 3 30 分待って挙動を確認 反映まで最大 30 分。その後ワークフローとログで拒否されたリクエストを確認。 バックグラウンドジョブ も含めて。 問題が出たら設定を OFF に戻せる 。ただし OFF にしても公開アプリの 2027/4/1 の強制期限は変わらない 。 7 技術者が押さえるべき5つのポイント 1. 影響範囲は「全インストール先ストア」 アプリ単位の設定で、インストールされている全ストアに一斉適用。記事上はストアを絞って試す手段の記載なし。本番アプリで ON にする前に影響範囲を把握すること。 2. delegate トークンにも条件あり offline の期限なしトークンだけでなく、 残り 24 時間超の delegate access token も拒否対象。delegate の発行時に有効期間を指定している実装は要確認。 3. 反映ラグ 30 分 / 検出ラグ 1 日 強制は最大 30 分後に効き始め、Dev Dashboard の問題ハイライトは直近 14 日分・最大 1 日遅れ。ON 直後の「問題なし」で即判断しない。 4. バックグラウンドジョブを見落とさない 記事が明示的に「バックグラウンドジョブからのリクエストも含めて確認」と指示。cron・Webhook 後処理・バッチ同期など、オフライントークンを使う経路が主な確認対象。 5. ON は非破壊・OFF は可逆、ただし期限は動かない ON にしても既存トークンの移行・失効は起きないため、 OFF に戻せば元の挙動に戻る前提で試せる 。一方で公開アプリの 2027/4/1 期限はこの設定と無関係に到来する。 8 業務に活かせる3つのユースケース USE CASE 1 公開アプリの「期限前リハーサル」 課題 公開アプリを運用しているが、期限付きトークン移行が本当に完了しているか、強制開始日まで確証が持てない。 打ち手 移行ガイドで実装 → ログと Dev Dashboard のハイライトを確認 → Settings で Turn on → 30 分後から拒否リクエストを監視。 効果 2027/4/1 当日の障害リスクを前倒しで潰せる。問題があれば OFF に戻して修正できる。 技術メモ 全インストール先ストアに効くため、実施は影響の少ない時間帯を選び、OFF 手順を事前に共有しておく。 USE CASE 2 在庫・受注連携などバックグラウンド処理の洗い出し 課題 画面操作は動くが、夜間バッチや定期同期など人目に触れないジョブがどのトークンを使っているか把握しきれていない。 打ち手 検証用アプリで設定を ON にし、一定期間ジョブを回してログ上の拒否リクエストを抽出、該当経路のトークン取得処理を修正。 効果 「たまにしか動かない処理」の移行漏れを本番強制前に発見できる。 技術メモ Dev Dashboard の検出は直近 14 日分・最大 1 日遅れ。週次・月次ジョブは実行周期を考慮して観測期間を取る。 USE CASE 3 カスタムアプリでも期限付きトークン前提の実装を検証 課題 クライアント専用のカスタムアプリ/マーチャント作成アプリは期限の対象外だが、期限付きトークンでの挙動も確かめておきたい。 打ち手 カスタムアプリでも同じ設定を ON にし、期限付きトークンで動作するかをテスト。問題があれば OFF。 効果 強制対象外のアプリでも、期限付きトークンでの動作を確認したうえで実装方針を判断できる。 技術メモ カスタムアプリ・マーチャント作成アプリに 2027/4/1 の期限は適用されない(設定はあくまでテスト用途)。今後の強制予定は記載なし。 9 提案で使える1行サマリ 「Admin API の期限付きトークン強制を、 2027/4/1 の本番強制より前に Dev Dashboard で任意 ON して試せる。 既存トークンは壊さず・いつでも OFF 可能 。バックグラウンドジョブまで含めた移行検証を今のうちに。」 source : shopify.dev / changelog / opt-in-to-admin-api-token-expiry-in-the-dev-dashboard published 2026-11-16