better-auth-best-practices

Tổng Quan

better-auth-best-practices là gì?

better-auth-best-practices là hướng dẫn thực tiễn và kỹ năng cấu hình để tích hợp Better Auth vào backend TypeScript của bạn. Nó bao gồm các bước thiết yếu để thiết lập máy chủ và client xác thực, cấu hình adapter cơ sở dữ liệu, quản lý phiên làm việc, thêm plugin và xử lý biến môi trường. Kỹ năng này dành cho các nhà phát triển backend cần quy trình xác thực mạnh mẽ, bao gồm email/mật khẩu, OAuth và thiết lập dựa trên plugin.

Ai nên sử dụng kỹ năng này?

• Nhà phát triển backend làm việc với TypeScript
• Các nhóm triển khai xác thực trong dự án Node.js
• Dự án cần xác thực an toàn, linh hoạt với Better Auth
• Người cần quản lý cấu hình xác thực, biến môi trường và adapter cơ sở dữ liệu

Những vấn đề được giải quyết

• Đơn giản hóa việc thiết lập Better Auth trong dự án mới hoặc hiện có
• Hướng dẫn rõ ràng về biến môi trường và vị trí file
• Tinh gọn quản lý adapter cơ sở dữ liệu và phiên làm việc
• Cung cấp tham khảo nhanh các lệnh CLI và tích hợp plugin

Cách Sử Dụng

Các Bước Cài Đặt

1. Cài đặt Better Auth vào dự án của bạn:

   npm install better-auth
   

2. Thiết lập các biến môi trường cần thiết:
   • BETTER_AUTH_SECRET (tối thiểu 32 ký tự; tạo bằng openssl rand -base64 32)
   • BETTER_AUTH_URL (URL gốc của bạn, ví dụ https://example.com)
3. Tạo file auth.ts trong thư mục gốc dự án, lib, utils hoặc src. File này sẽ cấu hình adapter cơ sở dữ liệu và các tùy chọn xác thực.
4. Thêm trình xử lý route cho các điểm cuối xác thực trong framework backend bạn chọn.
5. Chạy lệnh migrate để thiết lập schema cơ sở dữ liệu:

   npx @better-auth/cli@latest migrate
   

6. Kiểm tra thiết lập bằng cách gọi endpoint kiểm tra sức khỏe:
   • GET /api/auth/ok sẽ trả về { status: "ok" }

Mẹo Cấu Hình

• Chỉ định baseURL và secret trong cấu hình nếu biến môi trường tương ứng chưa được thiết lập.
• CLI sẽ tìm file auth.ts ở các vị trí chuẩn; sử dụng cờ --config để chỉ định đường dẫn tùy chỉnh.
• Sau khi thêm hoặc thay đổi plugin, luôn chạy lại lệnh migrate.

Các Lệnh CLI Hữu Ích

• npx @better-auth/cli@latest migrate — Áp dụng schema tích hợp sẵn
• npx @better-auth/cli@latest generate — Tạo schema cho Prisma hoặc Drizzle
• npx @better-auth/cli mcp --cursor — Thêm tích hợp MCP cho công cụ AI

Câu Hỏi Thường Gặp

better-auth-best-practices có phù hợp với tất cả dự án backend không?

Kỹ năng này phù hợp nhất cho backend TypeScript và Node.js cần xác thực an toàn, linh hoạt. Nó không dành cho môi trường frontend hoặc không sử dụng TypeScript.

Những biến môi trường nào cần thiết?

Bạn phải thiết lập BETTER_AUTH_SECRET (chuỗi ngẫu nhiên bảo mật) và BETTER_AUTH_URL (URL gốc ứng dụng). Đây là các biến quan trọng để vận hành an toàn.

Tôi nên đặt file auth.ts ở đâu?

CLI sẽ tìm file auth.ts trong thư mục gốc dự án, lib, utils hoặc src. Dùng cờ --config nếu bạn muốn đặt ở vị trí tùy chỉnh.

Làm sao để cập nhật thiết lập sau khi thêm plugin?

Luôn chạy lại lệnh migrate (npx @better-auth/cli@latest migrate) sau khi thêm hoặc thay đổi plugin để đảm bảo schema cơ sở dữ liệu được cập nhật.

Tôi có thể tìm thêm ví dụ và tài liệu ở đâu?

Truy cập better-auth.com/docs để xem ví dụ mã mới nhất, tài liệu API và hướng dẫn cấu hình nâng cao.