Skip to content
Migrating from NextAuth.js v4? Read our migration guide.
시작하기데이터베이스

데이터베이스 어댑터

Auth.js 통합은 기본적으로 세션을 쿠키에 저장합니다. 따라서 데이터베이스 설정은 선택 사항입니다. 하지만 사용자 정보를 여러분의 데이터베이스에 저장하거나 특정 플로우를 구현하려면 데이터베이스 어댑터를 사용해야 합니다.

데이터베이스 어댑터는 Auth.js를 여러분의 데이터베이스에 연결하기 위해 사용하는 다리 역할을 합니다. 예를 들어, 매직 링크를 구현할 때, 이메일 프로바이더는 링크에 있는 검증 토큰을 저장할 수 있도록 데이터베이스 어댑터 설정을 요구합니다.

공식 어댑터

아래는 @auth/ 네임스페이스 아래에 별도의 패키지로 배포되는 공식 어댑터 목록입니다. 소스 코드는 nextauthjs/next-auth 모노레포에서 확인할 수 있습니다. 데이터베이스 어댑터를 만들 계획이라면, Auth.js가 필요로 하는 데이터베이스 모델을 숙지하고 “데이터베이스 어댑터 만들기” 가이드를 참고하세요.

💡

원하는 데이터베이스나 서비스에 대한 어댑터를 찾지 못했다면, 직접 만들 수도 있습니다. 데이터베이스 어댑터 만들기 가이드를 참고하세요. 새로운 어댑터를 만든다면, PR을 열어 모두와 공유해 주세요!

Models

이것은 전체 데이터베이스 스키마가 어떻게 구성되어야 하는지 보여주는 일반적인 ER 다이어그램입니다. 여러분이 선택한 데이터베이스 어댑터는 이 스키마를 실제 데이터베이스에 적용하기 위한 더 자세한 템플릿 스키마를 포함하고 있습니다. 더 자세한 내용은 데이터베이스 모델 문서를 참고하세요. 모든 스키마가 모든 사용 사례에 필요한 것은 아니라는 점에 유의하세요. 더 자세한 내용은 데이터베이스 어댑터 가이드를 확인하세요.

Auth.js © Balázs Orbán and Team - 2025