К основному содержанию
скилл CX Codex

auth-patterns — скилл для Claude Code: что делает и как установить

Скилл auth-patterns для Claude Code собирает шаблоны аутентификации Next.js: настройку NextAuth.js v5, защиту маршрутов через middleware, RBAC и работу с сессиями в серверных компонентах.

MIT 183 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill auth-patterns -a claude-code
Открыть на GitHub

Что делает auth-patterns

Скилл даёт ассистенту готовые сценарии авторизации для проектов на Next.js. Внутри собраны примеры настройки NextAuth.js v5 с провайдерами GitHub и Credentials, создание обработчиков API-маршрутов app/api/auth/[...nextauth]/route.ts и провайдера сессий SessionProvider для клиентских компонентов.

Для кастомной логики есть шаблоны проверки токенов через middleware с библиотекой jose и переменной JWT_SECRET. Также описано разделение прав (RBAC): расширение типов сессии в TypeScript, проброс ролей через колбэки и серверный компонент AdminOnly.

Если вы используете базу данных, учтите: для сохранения сессий в БД потребуется отдельный адаптер вроде @auth/prisma-adapter, тогда как базовые примеры скилла опираются на стратегию stateless JWT.

Какие задачи решает

  • настроить NextAuth.js v5 с GitHub и входом по паролю
  • защитить маршруты дашборда и API через middleware в Next.js
  • получить данные сессии пользователя в серверных компонентах
  • настроить разграничение доступа по ролям (RBAC) в сессии

Примеры запросов агенту

  • Покажи, как защитить маршруты /dashboard с помощью middleware в Next.js
  • Настрой NextAuth.js v5 с провайдером GitHub и проверкой сессии на сервере
  • Как добавить роль пользователя в сессию Auth.js и сделать компонент AdminOnly?

Как установить auth-patterns

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill auth-patterns -a claude-code

2Вручную: положить файлы

~/.claude/skills/auth-patterns/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/auth-patterns/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об auth-patterns

Как установить auth-patterns в Claude Code?

Выполните команду npx skills add davepoon/buildwithclaude --skill auth-patterns -a claude-code.

Что делает скилл auth-patterns?

Он снабжает ассистента инструкциями и шаблонами кода для реализации входа, защиты страниц, работы с сессиями и JWT в приложениях на Next.js.

Какие библиотеки аутентификации рассматриваются в скилле?

В руководстве упоминаются NextAuth.js, Clerk, Lucia, Supabase Auth и кастомные JWT, а подробные примеры кода даны для NextAuth.js v5 и библиотеки jose.

Исходный текст

SKILL.md · MIT
---
name: auth-patterns
description: This skill should be used when the user asks about "authentication in Next.js", "NextAuth", "Auth.js", "middleware auth", "protected routes", "session management", "JWT", "login flow", or needs guidance on implementing authentication and authorization in Next.js applications.
version: 1.0.0
---

# Authentication Patterns in Next.js

## Overview

Next.js supports multiple authentication strategies. This skill covers common patterns including NextAuth.js (Auth.js), middleware-based protection, and session management.

## Authentication Libraries

| Library | Best For |
|---------|----------|
| NextAuth.js (Auth.js) | Full-featured auth with providers |
| Clerk | Managed auth service |
| Lucia | Lightweight, flexible auth |
| Supabase Auth | Supabase ecosystem |
| Custom JWT | Full control |

## NextAuth.js v5 Setup

### Installation

```bash
npm install next-auth@beta
```

### Configuration

```tsx
// auth.ts
import NextAuth from 'next-auth'
import GitHub from 'next-auth/providers/github'
import Credentials from 'next-auth/providers/credentials'

export const { handlers, auth, signIn, signOut } = NextAuth({
  providers: [
    GitHub({
      clientId: process.env.GITHUB_ID,
      clientSecret: process.env.GITHUB_SECRET,
    }),
    Credentials({
      credentials: {
        email: { label: 'Email', type: 'email' },
        password: { label: 'Password', type: 'password' },
      },
      authorize: async (credentials) => {
        const user = await getUserByEmail(credentials.email)
        if (!user || !verifyPassword(credentials.password, user.password)) {
          return null
        }
        return user
      },
    }),
  ],
  callbacks: {
    authorized: async ({ auth }) => {
      return !!auth
    },
  },
})
```

### API Route Handler

```tsx
// app/api/auth/[...nextauth]/route.ts
import { handlers } from '@/auth'

export const { GET, POST } = handlers
```

### Middleware Protection

```tsx
// middleware.ts
export { auth as middleware } from '@/auth'

export const config = {
  matcher: ['/dashboard/:path*', '/api/protected/:path*'],
}
```

## Getting Session Data

### In Server Components

```tsx
// app/dashboard/page.tsx
import { auth } from '@/auth'
import { redirect } from 'next/navigation'

export default async function DashboardPage() {
  const session = await auth()

  if (!session) {
    redirect('/login')
  }

  return (
    <div>
      <h1>Welcome, {session.user?.name}</h1>
    </div>
  )
}
```

### In Client Components

```tsx
// components/user-menu.tsx
'use client'

import { useSession } from 'next-auth/react'

export function UserMenu() {
  const { data: session, status } = useSession()

  if (status === 'loading') {
    return <div>Loading...</div>
  }

  if (!session) {
    return <SignInButton />
  }

  return (
    <div>
      <span>{session.user?.name}</span>
      <SignOutButton />
    </div>
  )
}
```

### Session Provider Setup

```tsx
// app/providers.tsx
'use client'

import { SessionProvider } from 'next-auth/react'

export function Providers({ children }: { children: React.ReactNode }) {
  return <SessionProvider>{children}</SessionProvider>
}

// app/layout.tsx
import { Providers } from './providers'

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        <Providers>{children}</Providers>
      </body>
    </html>
  )
}
```

## Sign In/Out Components

```tsx
// components/auth-buttons.tsx
import { signIn, signOut } from '@/auth'

export function SignInButton() {
  return (
    <form
      action={async () => {
        'use server'
        await signIn('github')
      }}
    >
      <button type="submit">Sign in with GitHub</button>
    </form>
  )
}

export function SignOutButton() {
  return (
    <form
      action={async () => {
        'use server'
        await signOut()
      }}
    >
      <button type="submit">Sign out</button>
    </form>
  )
}
```

## Middleware-Based Auth

### Basic Pattern

```tsx
// middleware.ts
import { NextResponse } from 'next/server'
import type { NextRequest } from 'next/server'

const protectedRoutes = ['/dashboard', '/settings', '/api/protected']
const authRoutes = ['/login', '/signup']

export function middleware(request: NextRequest) {
  const token = request.cookies.get('session')?.value
  const { pathname } = request.nextUrl

  // Redirect authenticated users away from auth pages
  if (authRoutes.some(route => pathname.startsWith(route))) {
    if (token) {
      return NextResponse.redirect(new URL('/dashboard', request.url))
    }
    return NextResponse.next()
  }

  // Protect routes
  if (protectedRoutes.some(route => pathname.startsWith(route))) {
    if (!token) {
      const loginUrl = new URL('/login', request.url)
      loginUrl.searchParams.set('callbackUrl', pathname)
      return NextResponse.redirect(loginUrl)
    }
  }

  return NextResponse.next()
}

export const config = {
  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
}
```

### With JWT Verification

```tsx
// middleware.ts
import { NextResponse } from 'next/server'
import { jwtVerify } from 'jose'

const secret = new TextEncoder().encode(process.env.JWT_SECRET)

export async function middleware(request: NextRequest) {
  const token = request.cookies.get('token')?.value

  if (!token) {
    return NextResponse.redirect(new URL('/login', request.url))
  }

  try {
    const { payload } = await jwtVerify(token, secret)
    // Token is valid, continue
    return NextResponse.next()
  } catch {
    // Token is invalid
    return NextResponse.redirect(new URL('/login', request.url))
  }
}
```

## Role-Based Access Control

### Extending Session Types

```tsx
// types/next-auth.d.ts
import { DefaultSession } from 'next-auth'

declare module 'next-auth' {
  interface Session {
    user: {
      role: 'user' | 'admin'
    } & DefaultSession['user']
  }
}

// auth.ts
export const { handlers, auth } = NextAuth({
  callbacks: {
    session: ({ session, token }) => ({
      ...session,
      user: {
        ...session.user,
        role: token.role,
      },
    }),
    jwt: ({ token, user }) => {
      if (user) {
        token.role = user.role
      }
      return token
    },
  },
})
```

### Role-Based Component

```tsx
// components/admin-only.tsx
import { auth } from '@/auth'
import { redirect } from 'next/navigation'

export async function AdminOnly({ children }: { children: React.ReactNode }) {
  const session = await auth()

  if (session?.user?.role !== 'admin') {
    redirect('/unauthorized')
  }

  return <>{children}</>
}

// Usage
export default async function AdminPage() {
  return (
    <AdminOnly>
      <AdminDashboard />
    </AdminOnly>
  )
}
```

## Session Storage Options

### JWT (Stateless)

```tsx
// auth.ts
export const { auth } = NextAuth({
  session: { strategy: 'jwt' },
  // JWT stored in cookies, no database needed
})
```

### Database Sessions

```tsx
// auth.ts
import { PrismaAdapter } from '@auth/prisma-adapter'
import { prisma } from '@/lib/prisma'

export const { auth } = NextAuth({
  adapter: PrismaAdapter(prisma),
  session: { strategy: 'database' },
  // Sessions stored in database
})
```

## Custom Login Page

```tsx
// app/login/page.tsx
'use client'

import { signIn } from 'next-auth/react'
import { useSearchParams } from 'next/navigation'

export default function LoginPage() {
  const searchParams = useSearchParams()
  const callbackUrl = searchParams.get('callbackUrl') || '/dashboard'

  return (
    <div className="flex flex-col gap-4">
      <button
        onClick={() => signIn('github', { callbackUrl })}
        className="btn"
      >
        Sign in with GitHub
      </button>
      <button
        onClick={() => signIn('google', { callbackUrl })}
        className="btn"
      >
        Sign in with Google
      </button>
    </div>
  )
}
```

## Security Best Practices

1. **Use HTTPS** in production
2. **Set secure cookie flags** (HttpOnly, Secure, SameSite)
3. **Implement CSRF protection** (built into NextAuth)
4. **Validate redirect URLs** to prevent open redirects
5. **Use environment variables** for secrets
6. **Implement rate limiting** on auth endpoints
7. **Hash passwords** with bcrypt or argon2

## Resources

For detailed patterns, see:
- `references/middleware-auth.md` - Advanced middleware patterns
- `references/session-management.md` - Session strategies
- `examples/nextauth-setup.md` - Complete NextAuth.js setup

© davepoon · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
auth-implementation-patterns Seth Hobson Скилл auth-implementation-patterns для Claude Code о проектировании аутентификации и авторизации: JWT, OAuth2, сессии, роли. Разводит аутентификацию (проверка личности, выдача токенов) и авторизацию (проверка прав и доступа). CX Codex +1 19 388установок clerk-nextjs-patterns clerk Скилл clerk-nextjs-patterns для Claude Code и Codex помогает внедрять авторизацию Clerk в Next.js. Направляет агента при настройке Server Actions, middleware и кеширования. CX Codex +1 56 200установок better-auth-plugins bobmatnyc Скилл better-auth-plugins направляет ассистента при настройке двухфакторной аутентификации, passkey, JWT или организаций в Better Auth на TypeScript. Помогает связать клиентские и серверные плагины. CX Codex +1 370установок nextjs-supabase-auth sickn33 Скилл nextjs-supabase-auth для Claude Code настраивает Supabase Auth в Next.js App Router: клиенты, middleware, OAuth callback и Server Actions. Защищает маршруты и работает с сессиями. CX Codex +1 6 600установок api-auth-and-jwt-abuse yaklang Скилл api-auth-and-jwt-abuse для Claude Code проверяет bearer-токены, API-ключи и доверие к claim'ам на пентесте API с JWT или заголовками запросов. CX Codex +1 4 200установок auth-stinger Legion Code Inc. Скилл auth-stinger помогает выбрать архитектуру аутентификации, настроить сессии, OAuth, RBAC и MFA в проекте по строгим правилам безопасности. CX Codex +1 ★ 96звёзд репо

Из того же набора235

Весь набор →
file-organizer Скилл file-organizer анализирует папки, находит дубликаты, предлагает структуру и переносит файлы по твоему одобрению. Работает через bash-команды. CX Codex +1 355установок server-actions Помогает агенту писать Server Actions в Next.js App Router: от валидации форм через Zod до хука useFormStatus и сброса кэша. CX Codex +1 204установок macos-design Скилл macos-design для Claude Code помогает проектировать интерфейсы macOS по системным паттернам, со светлой и тёмной темами. Задача — проектирование интерфейсов десктопных приложений и утилит. CX Codex +1 192установок server-components Скилл объясняет архитектуру React Server Components в Next.js: границы Server и Client Components, композицию и загрузку данных. CX Codex +1 158установок app-router Скилл для создания маршрутов, лейаутов, состояний загрузки и границ ошибок в Next.js App Router. Помогает агенту правильно организовать файловую структуру проекта. CX Codex +1 153установок route-handlers Скилл route-handlers помогает ИИ-агенту писать API-роуты для Next.js App Router: от стандартных эндпоинтов до потоковой передачи данных и настройки CORS. CX Codex +1 152установок canva-automation Скилл canva-automation управляет дизайнами, ассетами, папками и автозаполнением шаблонов в Canva через Rube MCP. CX Codex +1 149установок google-calendar-automation Скилл google-calendar-automation управляет событиями Google Calendar, ищет свободные интервалы и работает с участниками через Rube MCP. CX Codex +1 142установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой