コンテンツにスキップ

unauthorized.js

この機能は現在実験的であり、変更される可能性があります。本番環境での使用は推奨されません。GitHubで試してみて、フィードバックを共有してください。

unauthorized ファイルは、認証中にunauthorized 関数が呼び出されたときに UI をレンダリングするために使用されます。UI をカスタマイズすることに加えて、Next.js は 401 ステータスコードを返します。

app/unauthorized.tsx
import Login from '@/app/components/Login'
 
export default function Unauthorized() {
  return (
    <main>
      <h1>401 - Unauthorized</h1>
      <p>Please log in to access this page.</p>
      <Login />
    </main>
  )
}

リファレンス

プロップス

unauthorized.js コンポーネントはプロップスを受け入れません。

未認証ユーザーにログインUIを表示する

unauthorized 関数を使用して、ログインUI とともに unauthorized.js ファイルをレンダリングできます。

app/dashboard/page.tsx
import { verifySession } from '@/app/lib/dal'
import { unauthorized } from 'next/navigation'
 
export default async function DashboardPage() {
  const session = await verifySession()
 
  if (!session) {
    unauthorized()
  }
 
  return <div>Dashboard</div>
}
app/unauthorized.tsx
import Login from '@/app/components/Login'
 
export default function UnauthorizedPage() {
  return (
    <main>
      <h1>401 - Unauthorized</h1>
      <p>Please log in to access this page.</p>
      <Login />
    </main>
  )
}

バージョン履歴

バージョン変更点
v15.1.0unauthorized.js が導入されました。