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をご覧ください。