better-auth-best-practices

개요

better-auth-best-practices란?

better-auth-best-practices는 TypeScript 백엔드에 Better Auth를 통합하기 위한 실용적인 가이드이자 구성 스킬입니다. 인증 서버와 클라이언트 설정, 데이터베이스 어댑터 구성, 세션 관리, 플러그인 추가, 환경 변수 처리 등 필수 단계를 다룹니다. 이메일/비밀번호, OAuth, 플러그인 기반 인증 워크플로우가 필요한 백엔드 개발자를 위해 설계되었습니다.

이 스킬을 사용해야 하는 사람

• TypeScript로 작업하는 백엔드 개발자
• Node.js 프로젝트에서 인증을 구현하는 팀
• Better Auth를 통한 안전하고 유연한 인증이 필요한 프로젝트
• 인증 구성, 환경 변수, 데이터베이스 어댑터 관리를 필요로 하는 모든 사용자

해결하는 문제

• 신규 또는 기존 프로젝트에서 Better Auth 설정을 간소화
• 환경 변수 및 파일 위치에 대한 명확한 안내 제공
• 데이터베이스 어댑터와 세션 관리를 효율적으로 처리
• CLI 명령어와 플러그인 통합에 대한 빠른 참고 자료 제공

사용 방법

설치 단계

1. 프로젝트에 Better Auth를 설치합니다:

   npm install better-auth
   

2. 필수 환경 변수를 설정합니다:
   • BETTER_AUTH_SECRET (최소 32자; openssl rand -base64 32로 생성 가능)
   • BETTER_AUTH_URL (기본 URL, 예: https://example.com)
3. 프로젝트 루트, lib, utils 또는 src 디렉터리에 auth.ts 파일을 생성합니다. 이 파일에서 데이터베이스 어댑터와 인증 옵션을 구성합니다.
4. 선택한 백엔드 프레임워크에 인증 엔드포인트용 라우트 핸들러를 추가합니다.
5. 데이터베이스 스키마 설정을 위해 마이그레이션 명령을 실행합니다:

   npx @better-auth/cli@latest migrate
   

6. 헬스 체크 엔드포인트를 호출하여 설정을 확인합니다:
   • GET /api/auth/ok 요청 시 { status: "ok" } 응답이 와야 합니다

구성 팁

• 환경 변수가 설정되어 있지 않은 경우에만 baseURL과 secret을 구성에 정의하세요.
• CLI는 표준 위치에서 auth.ts를 찾으며, 커스텀 경로는 --config 플래그를 사용하세요.
• 플러그인을 추가하거나 변경한 후에는 항상 마이그레이션 명령을 다시 실행하세요.

유용한 CLI 명령어

• npx @better-auth/cli@latest migrate — 내장 스키마 적용
• npx @better-auth/cli@latest generate — Prisma 또는 Drizzle용 스키마 생성
• npx @better-auth/cli mcp --cursor — AI 도구용 MCP 통합 추가

자주 묻는 질문

better-auth-best-practices는 모든 백엔드 프로젝트에 적합한가요?

이 스킬은 안전하고 유연한 인증이 필요한 TypeScript 및 Node.js 백엔드에 최적화되어 있습니다. 프론트엔드 전용이나 비TypeScript 환경에는 적합하지 않습니다.

필수 환경 변수는 무엇인가요?

BETTER_AUTH_SECRET(안전하고 무작위로 생성된 문자열)과 BETTER_AUTH_URL(애플리케이션 기본 URL)을 반드시 설정해야 합니다. 이는 보안 운영에 필수적입니다.

auth.ts 파일은 어디에 두어야 하나요?

CLI는 프로젝트 루트, lib, utils, src 디렉터리에서 auth.ts를 찾습니다. 커스텀 위치를 원하면 --config 플래그를 사용하세요.

플러그인 추가 후 설정을 어떻게 업데이트하나요?

플러그인을 추가하거나 변경한 후에는 항상 마이그레이션 명령(npx @better-auth/cli@latest migrate)을 다시 실행하여 데이터베이스 스키마를 최신 상태로 유지하세요.

더 많은 예제와 문서는 어디서 찾을 수 있나요?

최신 코드 예제, API 참조, 고급 구성 가이드는 better-auth.com/docs에서 확인하세요.