Next.js Server Actionsの認証・認可|画面のアクセス制限と更新処理の確認方法
Next.js Server Actionsの認証・認可を、更新前の権限確認と操作後の保存結果から解説。ページやlayoutの制限、redirect、MFA、Action IDの役割を整理し、別ユーザーでの検証項目を示します。
Next.jsのServer Actionsでは、ページのアクセス制限に加えて、更新処理でも呼び出した利用者と対象データへの権限を確認します。 認証・認可の確認を置く場所は、Action自身か、そのActionが必ず通るデータアクセス層です。データを保存する前に、必要な条件を満たしているか判定します。
確認するときは、許可された操作が成功することと、拒否した操作で保存内容が変わらないことを一組で試します。認証画面へのリダイレクトだけを見て、更新を拒否できたと判断すると見落とす場合があります。
この記事は、Next.js App Routerで実装する開発者や、AIで開発を進める技術担当者向けです。説明には架空の文書編集機能を使います。アプリ全体の確認範囲は、バイブコーディングのセキュリティ対策を参照してください。
Server Actionsの認証は、ページとは別に確認する
Server Actionsは、フォーム送信などからサーバー上の更新処理を呼び出す仕組みです。画面のコードと近い場所に書けても、外部からPOSTで呼ばれる入口として扱います。Next.js公式も、ページの認証確認は、そのページ内のActionへ引き継がれないと説明しています。Next.js公式:認証と認可
たとえば、page.tsxでログイン状態を確認し、未ログインなら編集フォームを表示しない実装があるとします。この確認が守るのは、その画面での表示です。フォームの送信先となるActionでも、誰から届いた要求かを確認する必要があります。
同じように、layout.tsxで画面を隠しても、配下の処理すべてを保護したことにはなりません。レイアウトは画面遷移のたびに再描画されるとも限らないため、データに近い場所へ確認を置きます。Next.js公式:レイアウトと認証確認
| 確認する場所 | 担当すること |
|---|---|
| ページ・レイアウト | 認証状態に応じて表示や画面遷移を決める |
| Proxy/旧Middleware | 対象リクエストを早い段階で振り分け、必要に応じてログインへ案内する |
| Server Action・データアクセス層 | 現在の利用者と対象データへの権限を確認し、許可した更新だけを実行する |
| DBの権限・RLS | DBへ届く操作について、アクセスできるテーブルや行を制限する |
Proxyにも認証確認を置けますが、保護したい操作の直前でも検査します。設定した対象パスの変更や、別の呼び出し経路が増えたときにも、データを扱う処理で条件を確かめられるようにするためです。
保存前に、本人・認証段階・対象データの権限を確認する
「認証」は誰が操作しているかの確認、「認可」はその人にどの操作を許すかの判定です。ログイン済みの会員Bが、会員Aの非公開文書を編集してよいわけではありません。文書IDが正しい形式であることと、編集権限があることも、それぞれ確認します。
二段階認証などの追加確認を必須にした操作では、その完了状態も条件に含めます。SupabaseのMFAなら、追加認証前のaal1と完了後のaal2を区別します。DBやAPIでも、操作に必要な認証段階を満たしているか確認します。Supabase公式:MFAの適用
次は「本人の文書だけを更新できる」という仕様の構成例です。認証・入力・DBのヘルパーは説明用の名前で、各関数の責務はコードの下に示します。自分の認証ライブラリとデータ構造に合わせて実装する部分です。
'use server'
import { redirect } from 'next/navigation'
import { getVerifiedSession } from '@/lib/auth'
import { parseNoteUpdate } from '@/lib/validation'
import { updateNoteForOwner } from '@/data/notes'
export async function updateNote(formData: FormData) {
const session = await getVerifiedSession()
if (!session) redirect('/login')
const input = parseNoteUpdate(formData)
if (!input.ok) {
return { ok: false, message: '入力内容を確認してください' }
}
const updated = await updateNoteForOwner({
noteId: input.noteId,
ownerId: session.userId,
body: input.body,
})
if (!updated) {
return { ok: false, message: '更新できる文書がありません' }
}
redirect('/notes')
}
| ヘルパー | 実装する責務 |
|---|---|
getVerifiedSession | 認証ライブラリなどで現在のセッションを検証し、本人のIDを返す。未認証ならnullを返す |
parseNoteUpdate | 文書IDの形式、本文の型・長さ、受け付ける項目を検証する |
updateNoteForOwner | 文書IDと検証済みの本人IDを条件に更新する。対象がなければ更新せずfalseを返し、DB障害は成功として扱わない |
本人IDは検証済みセッションから渡します。フォームのhidden項目にownerIdやisAdminがあっても、それを権限の証明には使いません。DBの更新条件にも本人IDを含めることで、「文書を探すときだけ所有者を確認し、更新はIDだけで実行する」という取りこぼしを避けます。
この例は本人だけが編集する単純な仕様です。チームの編集者や管理者も操作できるなら、所属や役割、その取消も判定に含めます。認証と権限の確認を共通化する場合は、サーバー専用のデータアクセス層にまとめ、各Actionが必ずそこを通る構成にします。Next.js公式:更新処理のデータアクセス層
セッションの検証や権限の照会に失敗したときは、保存へ進めません。「未認証」「権限なし」「確認に必要な処理が失敗した」を記録上は区別し、DB障害などの内部情報をそのまま利用者へ返さないようにします。
Actionの返り値もクライアントへ渡る情報です。更新結果としてDBの行全体を返す前に、画面で必要な項目へ絞ります。
redirectの応答と、DBへの保存結果を分けて確認する
Server Actionsの動作を確認するときは、処理が返した応答と、DBの保存状態を照合します。画面遷移は利用者への案内であり、保存が行われたかどうかはデータ側で確かめます。
更新後の再描画で、認証画面へ転送される場合がある
Server Actionsは、更新処理の結果と新しい画面を一つの応答に含められます。キャッシュの再検証に伴って現在のルートを再描画する経路では、Actionの実行後にも画面側の処理が続きます。Next.js公式:データと画面を返す応答
権限を確認する位置によって、処理の順序は次のように変わります。
| 確認を置く場所 | 起こり得る処理の順序 |
|---|---|
| 権限確認が再描画側にあり、更新処理では確認していない | 更新要求 → DBへ保存 → 画面を再描画 → 権限不足により画面表示を拒否 |
| 更新前に権限を確認する | 更新要求 → 対象データへの権限を検査 → 権限がなければ保存せず拒否 |
前者の順序では、画面表示を拒否する前に保存が完了しています。拒否したい条件では、保存を実行する前に処理を止め、操作後にも値が変わっていないことを確認します。
redirectは例外を投げるため、catchの配置にも注意する
redirect()は、Next.jsが画面遷移として扱う例外を投げます。tryの中で呼び、それを通常のエラーとしてcatchすると、意図した遷移を妨げる場合があります。公式は、try/catchを使う場合のredirect()をtryの外に置くよう案内しています。Next.js公式:redirect
保存後に成功画面へ移るなら、DB処理の成功を確かめてからredirect()を呼びます。認証不足で止めるなら、保存前に判定します。redirect()はDBのロールバックを担当しません。複数の保存をまとめて取り消す必要がある処理では、DBのトランザクションも設計します。
また、転送の伝わり方は、通常のフォーム送信とJavaScript経由の呼び出しなどで異なります。特定のHTTPステータスだけを合否条件にせず、画面遷移、処理の返り値、保存状態を照合してください。
Action IDと送信元チェックの役割を確認する
Next.jsにはAction IDの保護や、リクエストのOriginとHostなどを照合する仕組みがあります。Action IDはクライアントから処理を参照するためのものです。送信元の照合は、別サイトから意図せず要求を送らせるCSRFへの対策を担います。Next.js公式:組み込みの保護、送信元の照合
これらに加えて、アプリ側で「この利用者が、この文書を、今の認証状態で更新できるか」を判定します。正規の画面から得たAction IDやフォーム情報があっても、利用者や権限が変わった後の操作を許してよいとは限りません。
Supabaseへの直接APIなど、同じデータを更新できる別経路があるなら、そこでの制限も確認します。RLS・DB関数・Storageは、Supabaseのセキュリティチェックにまとめています。
未ログイン・本人・別ユーザーで、応答と保存内容を照合する
自分が管理する検証環境に、利用者A・Bと、それぞれの架空の文書を用意します。本人だけが編集できる仕様なら、次の組み合わせを試せます。テスト前に文書の内容を保存し、操作後に所有者の正規の権限や検証用DB接続から読み直します。
| 操作 | 期待する結果 |
|---|---|
| 未ログインでAの文書の更新を要求する | 拒否され、内容は変わらない |
| A・Bがそれぞれ自分の文書を更新する | 指定した内容が保存される |
| BがAの文書IDを指定して更新する | 拒否され、Aの文書は変わらない |
| Aが不正な型や許容範囲外の本文を送る | 入力が拒否され、内容は変わらない |
| セッションの検証や対象の権限確認で障害が起きる | 保存へ進まず、確認の失敗が記録される |
追加認証を必須にする操作では、その未完了・完了も分けて試します。別ユーザーの権限や入力値を調べる試験では、先に必要な認証を完了してください。認証不足で止まっただけでは、対象データの権限や入力の検証が働いたと判断できないためです。
チームの編集権限があるアプリでは、フォームを開いた後に権限を取り消し、同じログイン状態から送信する条件も追加します。どの時点で取消を反映する仕様かを決め、その期待値と比べます。
検証は、関数を直接呼ぶ試験と、Next.jsを通したHTTP試験を分けて記録します。関数だけの試験では、フォーム情報の扱い、Cookie、更新後の再描画や転送まで確認したことにはなりません。DBの権限を試す場合は、SupabaseのRLSテスト手順も併用できます。
拒否の試験と同時に、本人による正規の更新も試してください。全員の更新を止めた状態を、権限の修正が完了した状態と取り違えないためです。
Actionごとの確認結果を残し、変更後に再検証する
Actionごとに、利用者、対象データ、必要な認証段階、呼び出すDB処理を一覧にします。確認結果には、コードの版と接続先を添え、期待した結果、実際の応答、保存状態を対応させます。確認していない経路は未確認として残してください。
Next.jsの依存バージョンを更新する作業と、アプリの権限条件を修正する作業は、それぞれ必要です。本稿はアプリ側の認証・認可を扱っています。フレームワークの更新を検討するときは、Next.jsのセキュリティ更新と確認事項も参照し、利用中の版に対応する公式告知を確認してください。
本稿のコードは処理順と各ヘルパーの責務を示す構成例です。認証プロバイダーやDBを含む実装一式ではありません。適用後は、自分の環境で上の許可・拒否の条件を再検証します。
確認範囲や修正の優先度を相談したい場合は、レビュー依頼の準備に沿って、対象の機能と未確認の操作を整理できます。技術顧問・セキュリティレビューでは、その範囲を合意してコードと設定を確認します。
公式資料の確認日:2026年11月5日。
よくある質問
page.tsxやlayout.tsxで認証していても、Server Actionsで確認が必要ですか?
必要です。ページの認証は、その中で定義したServer Actionにも自動では適用されません。Action自身、またはActionが必ず通るデータアクセス層で、呼び出した利用者と対象データへの権限を保存前に確認します。
認証画面へリダイレクトされたら、更新は拒否されたと判断できますか?
応答だけでは判断できません。更新後の再描画で認証画面へ転送される経路では、先に保存が完了している場合があります。操作前後のデータを比較してください。redirect自体は例外を投げる仕組みですが、すでに確定したDB更新を取り消す機能ではありません。
Server ActionのIDが推測しにくければ、認証は省略できますか?
保護が必要な操作では省略できません。Action IDは処理を参照して呼び出すためのもので、利用者の本人確認や、対象データを操作してよいという証明にはなりません。IDの保護や送信元の確認に加えて、アプリの認証・認可を実装します。
この記事を書いた人
株式会社Float Engineering 代表
西林 明信
自社プロダクトの開発・運営と、Webサイト・業務システムの受託開発を行っています。広告代理店でのマーケティング、楽天でのデータ分析を経て、2023年にFloat Engineeringを設立。
プロフィールを見る