authInterrupts#

• 상위 메뉴: next.config.js
• 전체 목차: Next.js 학습 문서

Canary: 이 기능은 현재 canary 채널에서 제공되며 변경될 수 있다. Next.js를 canary 버전으로 업그레이드하여 사용해 보고 GitHub에 피드백을 남길 수 있다.

학습 목표#

• authInterrupts가 forbidden과 unauthorized API를 활성화하는 설정임을 이해한다.
• experimental.authInterrupts의 설정 위치와 canary 기능의 변경 가능성을 파악한다.
• forbidden, unauthorized, forbidden.js, unauthorized.js 문서가 각각 어떤 API와 file convention을 다루는지 구분한다.

핵심 개념 및 설명#

authInterrupts 설정은 애플리케이션에서 `forbidden`과 `unauthorized` API를 사용할 수 있게 한다. 두 함수는 experimental 기능이므로 사용하려면 next.config.js에 authInterrupts 옵션을 활성화해야 한다.

import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    authInterrupts: true,
  },
}

export default nextConfig

forbidden#

`forbidden` 함수의 API Reference다.

unauthorized#

`unauthorized` 함수의 API Reference다.

forbidden.js#

`forbidden.js` special file의 API Reference다.

unauthorized.js#

`unauthorized.js` special file의 API Reference다.

예제 및 데모 설계#

• 데모 가능 여부: 가능
• canary 버전에서 인증 상태에 따라 forbidden()과 unauthorized()를 호출하는 경로를 구성한다.
• 권한이 없는 사용자에게는 forbidden.js의 UI를, 인증되지 않은 사용자에게는 unauthorized.js의 UI를 렌더링한 결과를 브라우저에서 비교한다.
• canary 기능이며 변경될 수 있다는 경고와 현재 활성화한 설정을 검증 패널에 함께 표시한다.

연습 문제#

1. authInterrupts를 활성화하는 올바른 설정은 무엇인가?

• A. authInterrupts: true
• B. experimental: { authInterrupts: true }
• C. forbidden: { authInterrupts: true }
• D. experimental: { unauthorized: true }

1. authInterrupts에 대한 설명으로 올바른 것은 무엇인가?

• A. stable 기능이므로 모든 버전에서 변경되지 않는다.
• B. forbidden과 unauthorized API를 사용하기 위한 experimental 설정이다.
• C. allowedDevOrigins에 등록한 hostname만 허용한다.
• D. cacheComponents를 자동으로 활성화한다.

챕터 요약#

• authInterrupts는 forbidden과 unauthorized API를 사용할 수 있게 한다.
• 두 함수가 experimental 기능이므로 experimental.authInterrupts: true를 설정해야 한다.
• forbidden과 unauthorized는 함수 API이고 forbidden.js와 unauthorized.js는 special file이다.
• 이 기능은 현재 canary channel에서 제공되며 변경될 수 있다.