汎用セキュリティ⭐ リポ 4品質スコア 66/100

better-auth

Name: better-auth
Author: nordeim

Better Authを使用して、フレームワークに依存しないTypeScript認証フレームワークで認証と認可を実装できます。メール/パスワード認証と検証、OAuth プロバイダー（Google、GitHub、Discord など）、二段階認証（TOTP、SMS）、パスキー/WebAuthn対応、セッション管理、ロールベースアクセス制御（RBAC）、レート制限、データベースアダプターなど豊富な機能を備えています。アプリケーションへの認証機能追加、OAuthフローの実装、2FA/MFAの構築、ユーザーセッション管理、認可ルール設定、Webアプリケーションのセキュアな認証システム構築などの場面で活用できます。

description の原文を見る

Implement authentication and authorization with Better Auth - a framework-agnostic TypeScript authentication framework. Features include email/password authentication with verification, OAuth providers (Google, GitHub, Discord, etc.), two-factor authentication (TOTP, SMS), passkeys/WebAuthn support, session management, role-based access control (RBAC), rate limiting, and database adapters. Use when adding authentication to applications, implementing OAuth flows, setting up 2FA/MFA, managing user sessions, configuring authorization rules, or building secure authentication systems for web applications.

SKILL.md 本文

Better Auth スキル

Better Auth は TypeScript 向けの包括的なフレームワークに依存しない認証/認可フレームワークで、組み込みのメール/パスワード認証、ソーシャル OAuth、および高度な機能向けの強力なプラグインエコシステムを備えています。

使用する場面

TypeScript/JavaScript アプリケーションで認証を実装する
メール/パスワードまたはソーシャル OAuth 認証を追加する
2FA、パスキー、マジックリンク、高度な認証機能をセットアップする
組織サポート機能を備えたマルチテナントアプリを構築する
セッションとユーザーライフサイクルを管理する
あらゆるフレームワーク(Next.js、Nuxt、SvelteKit、Remix、Astro、Hono、Express など)で利用する

クイックスタート

インストール

npm install better-auth
# または pnpm/yarn/bun add better-auth

環境セットアップ

.env を作成します:

BETTER_AUTH_SECRET=<generated-secret-32-chars-min>
BETTER_AUTH_URL=http://localhost:3000

基本的なサーバーセットアップ

auth.ts を作成します(ルート、lib/、utils/、または src/app/server/ 配下):

import { betterAuth } from "better-auth";

export const auth = betterAuth({
  database: {
    // See references/database-integration.md
  },
  emailAndPassword: {
    enabled: true,
    autoSignIn: true
  },
  socialProviders: {
    github: {
      clientId: process.env.GITHUB_CLIENT_ID!,
      clientSecret: process.env.GITHUB_CLIENT_SECRET!,
    }
  }
});

データベーススキーマ

npx @better-auth/cli generate  # スキーマ/マイグレーションを生成
npx @better-auth/cli migrate   # マイグレーションを適用(Kysely のみ)

API ハンドラーをマウント

Next.js App Router:

// app/api/auth/[...all]/route.ts
import { auth } from "@/lib/auth";
import { toNextJsHandler } from "better-auth/next-js";

export const { POST, GET } = toNextJsHandler(auth);

その他のフレームワーク: references/email-password-auth.md#framework-setup を参照

クライアントセットアップ

auth-client.ts を作成します:

import { createAuthClient } from "better-auth/client";

export const authClient = createAuthClient({
  baseURL: process.env.NEXT_PUBLIC_BETTER_AUTH_URL || "http://localhost:3000"
});

基本的な使用方法

// サインアップ
await authClient.signUp.email({
  email: "user@example.com",
  password: "secure123",
  name: "John Doe"
});

// サインイン
await authClient.signIn.email({
  email: "user@example.com",
  password: "secure123"
});

// OAuth
await authClient.signIn.social({ provider: "github" });

// セッション
const { data: session } = authClient.useSession(); // React/Vue/Svelte
const { data: session } = await authClient.getSession(); // Vanilla JS

機能選択マトリックス

機能	プラグイン必須	ユースケース	リファレンス
メール/パスワード	いいえ(組み込み)	基本認証	`email-password-auth.md`
OAuth(GitHub、Google など)	いいえ(組み込み)	ソーシャルログイン	`oauth-providers.md`
メール検証	いいえ(組み込み)	メールアドレスの検証	`email-password-auth.md`
パスワードリセット	いいえ(組み込み)	パスワード忘却フロー	`email-password-auth.md`
2 要素認証(2FA/TOTP)	はい(`twoFactor`)	セキュリティ強化	`advanced-features.md`
パスキー/WebAuthn	はい(`passkey`)	パスワードレス認証	`advanced-features.md`
マジックリンク	はい(`magicLink`)	メールベースのログイン	`advanced-features.md`
ユーザー名認証	はい(`username`)	ユーザー名ログイン	`email-password-auth.md`
組織/マルチテナント	はい(`organization`)	チーム/組織機能	`advanced-features.md`
レート制限	いいえ(組み込み)	不正使用を防止	`advanced-features.md`
セッション管理	いいえ(組み込み)	ユーザーセッション	`advanced-features.md`

認証方法選択ガイド

メール/パスワードを選択する場合:

従来の認証を備えた標準的なウェブアプリを構築する
ユーザー認証情報を完全に制御する必要がある
メールベースのアカウントを優先するユーザーをターゲットにする

OAuth を選択する場合:

摩擦の少ないクイックサインアップを望む
ユーザーがすでにソーシャルアカウントを持っている
ソーシャルプロフィールデータへのアクセスが必要

パスキーを選択する場合:

パスワードレス体験を望む
最新ブラウザ/デバイスをターゲットにする
セキュリティが最優先事項

マジックリンクを選択する場合:

WebAuthn の複雑さなしでパスワードレスを望む
メールファーストのユーザーをターゲットにする
一時的なアクセスリンクが必要

複数の方法を組み合わせる場合:

さまざまなユーザー設定に対応する柔軟性を望む
さまざまな認証要件を備えたエンタープライズアプリを構築する
プログレッシブなエンハンスメント(シンプルな状態から始めて、さらにオプションを追加)が必要

コアアーキテクチャ

Better Auth はクライアント-サーバーアーキテクチャを使用します:

サーバー (better-auth): 認証ロジック、データベース操作、API ルートを処理
クライアント (better-auth/client): フロントエンド向けのフック/メソッドを提供
プラグイン: サーバー/クライアント機能を拡張

実装チェックリスト

リファレンスドキュメント

コア認証

メール/パスワード認証 - メール/パスワード設定、検証、パスワードリセット、ユーザー名認証
OAuth プロバイダー - ソーシャルログインセットアップ、プロバイダー設定、トークン管理
データベース統合 - データベースアダプター、スキーマセットアップ、マイグレーション

高度な機能

高度な機能 - 2FA/MFA、パスキー、マジックリンク、組織、レート制限、セッション管理

スクリプト

scripts/better_auth_init.py - インタラクティブセットアップで Better Auth 設定を初期化

リソース

ドキュメント: https://www.better-auth.com/docs
GitHub: https://github.com/better-auth/better-auth
プラグイン: https://www.better-auth.com/docs/plugins
例: https://www.better-auth.com/docs/examples

ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ

詳細情報

作者: nordeim
リポジトリ: nordeim/Prompt-Engineering
ライセンス: MIT
最終更新: 2026/4/14

GitHubで原本を見る →フィードバックを送る

Source: https://github.com/nordeim/Prompt-Engineering / ライセンス: MIT