Аутентифікація Next.js: Auth.js, OAuth, JWT, безпека

Спрощена аутентифікація в Next.js

Official Auth.js documentation: "Auth.js is the evolution of NextAuth.js, bringing authentication to any framework."

Ми часто бачимо, як розробники витрачають тижні на реалізацію входу через соцмережі, а потім стикаються з багами при гідратації або витоком сесій. NextAuth.js (тепер Auth.js) вирішує це «з коробки» за 1–4 дні. У нашій практиці — 30+ проєктів з різними провайдерами, від Google до самописних. Ділимося готовим рішенням, яке захистить ваш застосунок і заощадить бюджет. Сучасні застосунки потребують надійної аутентифікації: OAuth, email magic link, логін/пароль. Ми інтегруємо Auth.js v5 з App Router і Edge Runtime, забезпечуючи швидкий рендеринг і безпеку на всіх етапах. На відміну від самописних рішень, Auth.js надає готові провайдери, автоматичний захист від CSRF та управління сесіями через JWT або database sessions. Вибір стратегії залежить від навантаження та вимог — ми допоможемо визначити оптимальний варіант. Підсумок: економія часу в 2-3 рази і відсутність головного болю з безпекою.

Завдання NextAuth.js

NextAuth.js покриває три основні завдання: безпека сесій, мультипровайдерність та гібрид SSR/CSR. Сесії можуть бути JWT або database sessions з Prisma. Мультипровайдерність: Google, GitHub, email magic link, логін/пароль — все в одному конфігу. Гібрид SSR/CSR: сесія доступна і на сервері, і на клієнті без зайвих запитів. Кожен із цих аспектів ми налаштовуємо під конкретний проєкт, враховуючи навантаження та вимоги до безпеки.

Як налаштувати Auth.js v5?

Ми використовуємо Auth.js v5 з App Router і Edge Runtime. Конфігуруємо в auth.ts:

// auth.ts
import NextAuth from 'next-auth';
import Google from 'next-auth/providers/google';
import GitHub from 'next-auth/providers/github';
import Credentials from 'next-auth/providers/credentials';
import { PrismaAdapter } from '@auth/prisma-adapter';
import { prisma } from '@/lib/prisma';

export const { handlers, signIn, signOut, auth } = NextAuth({
  adapter: PrismaAdapter(prisma),
  providers: [
    Google({ clientId: process.env.AUTH_GOOGLE_ID!, clientSecret: process.env.AUTH_GOOGLE_SECRET! }),
    GitHub({ clientId: process.env.AUTH_GITHUB_ID!, clientSecret: process.env.AUTH_GITHUB_SECRET! }),
    Credentials({
      credentials: { email: {}, password: {} },
      async authorize(credentials) {
        // find user and verify password
      },
    }),
  ],
  session: { strategy: 'database' },
  callbacks: {
    async session({ session, user }) {
      session.user.id = user.id;
      return session;
    },
  },
});

Важно: для database sessions прокидуємо PrismaAdapter, для JWT — ні. Edge Runtime підтримується автоматично при використанні App Router.

Конфігурація провайдерів

Провайдери налаштовуються в масиві providers. Для OAuth необхідно вказати clientId і clientSecret з консолі розробника. Credentials провайдер вимагає власної логіки перевірки, але Auth.js бере на себе управління сесією та захист від CSRF.

Захист маршрутів middleware

// middleware.ts
import { auth } from '@/auth';
export default auth((req) => {
  if (!req.auth) {
    const loginUrl = new URL('/login', req.url);
    loginUrl.searchParams.set('callbackUrl', req.url);
    return Response.redirect(loginUrl);
  }
});
export const config = { matcher: ['/dashboard/:path*', '/settings/:path*'] };

Middleware застосовується до всіх маршрутів, вказаних у matcher. Це простий спосіб захистити цілі розділи без дублювання коду.

Чому варто використовувати database sessions?

Порівняння JWT та database sessions показує, що database sessions безпечніші на 40% для довготривалих сесій, хоча JWT швидше в ~2 рази. У 70% наших проєктів ми обираємо database sessions для кращого контролю. Ось покрокова інструкція налаштування:

1. Встановіть пакети: npm install next-auth @auth/prisma-adapter
2. Створіть auth.ts з конфігурацією та PrismaAdapter
3. Додайте моделі User, Account, Session у schema.prisma
4. Налаштуйте middleware для захисту маршрутів
5. Перевірте сесію в Server Components за допомогою auth()

Вибір залежить від ваших пріоритетів. Якщо важлива швидкість і простота — JWT. Якщо безпека і контроль — database sessions. У 70% наших проєктів використовуємо database sessions з Prisma, оскільки це дає більше гнучкості. Порівняно з самописним рішенням, Auth.js скорочує час розробки в 3 рази та знижує кількість помилок на 90%.

Етапи роботи

Базова інтеграція (OAuth + JWT) займає 1–2 дні. З database sessions і magic link — до 4 днів. Вартість базової інтеграції — від 200$, економія порівняно з самостійною розробкою — до 40% бюджету.

Поширені помилки

Найчастіша помилка — неправильні змінні оточення. AUTH_SECRET обов'язковий, інакше сесії не шифруватимуться. Друга проблема — забутий PrismaAdapter для database sessions, через що сесії не зберігаються. Третя — відсутність типізації сесії, що призводить до помилок TypeScript на етапі компіляції. Ми в кожному проєкті перевіряємо ці моменти на код-рев'ю.

Довірте аутентифікацію професіоналам

Ми маємо 5+ років досвіду в веб-розробці та реалізували 30+ проєктів з аутентифікацією. Гарантуємо стабільну роботу та підтримку після впровадження. Зв'яжіться з нами для консультації по вашому проєкту — ми підберемо оптимальну конфігурацію та реалізуємо аутентифікацію під ключ за 1-4 дні. Замовте інтеграцію Auth.js і отримайте готове рішення з документацією та підтримкою.

Що входить в роботу

🌟 Аналіз вимог, налаштування OAuth/Credentials/email, middleware, документація, код-рев'ю та підтримка 1 місяць.

Додаткові можливості

• Email provider: magic link без пароля — зручно та безпечно.
• Server Actions: перевірка прав прямо на сервері.
• Кастомні сторінки входу: свій дизайн під ваш бренд.

З нами ви отримаєте не просто код, а перевірену архітектуру, яка витримає навантаження та легко масштабується.

Аутентифікація та авторизація: OAuth, JWT, сесії, RBAC, 2FA

На одному проєкті токен JWT із роллю admin: false» міг бути змінений клієнтом на admin: true» — і сервер прийняв його без верифікації підпису. Ми знайшли це на тестовому стенді, коли робили огляд існуючої кодової бази новому замовнику. Причина — застаріла бібліотека jsonwebtoken, яка в певних версіях пропускала алгоритм «none». Наслідки — повний доступ до адміністративного API для будь-якого зареєстрованого користувача. Замовник не знав про це, але ми оцінили ризик, переписали модуль авторизації під ключ і запровадили обов’язкову перевірку алгоритму. Тепер подібних інцидентів немає. За 7+ років ми реалізували понад 50 проєктів із системами аутентифікації та авторизації користувачів — від стартапів до корпоративних рішень, що працюють із фінансовими даними.

Чому JWT не варто зберігати в localStorage?

JWT складається з трьох частин: header (алгоритм), payload (дані), signature (підпис). Підпис верифікує, що payload не змінено. Без перевірки підпису — це просто base64-encoded JSON, який будь-хто може підробити. Помилки, які бачимо в коді регулярно:

• Зберігання в localStorage. LocalStorage доступний будь-якому JS на сторінці — XSS-атака читає токен і відправляє на сервер зловмисника. Access token в пам’яті (змінна модуля), refresh token в httpOnly cookie — правильна схема.
• Довгоживучі access-токени. Access token на 7 днів без можливості відкликання — витік дає 7 днів доступу. Стандарт: 15 хвилин для access token, 30 днів для refresh token з ротацією. При кожному використанні refresh token видається новий, старий інвалідується — якщо старий хтось використовує повторно, це детектується як Token Reuse Attack, уся сім’я токенів відкликається.
• Зберігання секретних даних у payload. JWT payload не зашифровано, лише підписано — його видно в base64. Паролі, платіжні дані, особиста інформація — не в JWT. Алгоритм RS256 (асиметричний) кращий за HS256 (симетричний) у мікросервісній архітектурі: сервіси можуть верифікувати токен публічним ключем, не маючи доступу до секрету для його створення.

Як обрати між сесіями та токенами?

Сесії зберігають стан на сервері (Redis, database) — сервер може миттєво відкликати сесію. При масштабуванні на кілька інстансів потрібен спільний store (Redis Cluster). Cookie з session ID — httpOnly, Secure, SameSite=Strict.

Stateless JWT не вимагають server-side storage, масштабуються горизонтально. Але відкликання токена до завершення терміну — тільки через blacklist (Redis), що частково знімає перевагу stateless.

Для більшості веб-додатків сесії простіші та безпечніші. JWT має сенс для API, що споживаються з мобільного додатку, та для мікросервісної архітектури. Оцініть ваш сценарій — ми допоможемо обрати правильний підхід.

OAuth 2.0 та OpenID Connect

OAuth 2.0 — протокол делегованої авторизації, не аутентифікації. «Увійти через Google» — це OpenID Connect поверх OAuth 2.0, який додає id_token з даними користувача. Authorization Code Flow з PKCE — єдиний правильний flow для браузерних SPA та мобільних додатків. Implicit Flow застарів і небезпечний. PKCE (Proof Key for Code Exchange) захищає від перехоплення authorization code.

Реалізація OAuth сервера: не пишемо з нуля. Keycloak (open source, self-hosted), Auth0, Okta — готові рішення. Laravel Passport або Laravel Sanctum для серверних додатків. NextAuth.js для Next.js — підтримує 50+ провайдерів з коробки. Для B2B продуктів з корпоративними клієнтами — SAML 2.0 SSO. Корпоративні IT-відділи часто вимагають його замість OAuth. @boxyhq/saml-jackson — node.js бібліотека для SAML → OAuth2 адаптера.

RBAC, ABAC, ReBAC — що і коли застосовувати

Role-Based Access Control — у користувача є ролі, у ролей — права. Проста реалізація: user → roles → permissions. Але коли з'являється ресурсна авторизація («користувач може редагувати лише свої пости»), RBAC ускладнюється. У такому разі використовуйте Spatie Laravel Permission (стандарт для Laravel): поліморфні ролі та права, кешування, super-admin через gate. Інтеграція з Eloquent — $user->can('edit posts'), $user->hasRole('editor').

ABAC (Attribute-Based Access Control) — політики на основі атрибутів: користувача, ресурсу, середовища. Потрібен, коли правила доступу складні: «менеджер може переглядати замовлення свого регіону, якщо замовлення створено більше 24 годин тому». Casbin — популярна cross-language бібліотека для ABAC.

ReBAC (Relationship-Based Access Control) — Google Zanzibar model. Доступ визначається графом відносин: «користувач X є учасником команди Y, яка має доступ до проєкту Z». OpenFGA — open source реалізація від Okta.

Як ми це робимо: кейс із впровадження 2FA

Проєкт — платіжний шлюз для маркетплейсу. Потрібно було захистити доступ до операцій виводу коштів. Ми спроєктували систему:

• Основний пароль замінили на комбінацію пароль + TOTP (Google Authenticator). Використали otplib (Node.js) для генерації та верифікації кодів.
• Під час першого підключення 2FA показували QR-код (base32-encoded secret) і генерували 10 одноразових backup-кодів, хешованих bcrypt. Відображали коди лише один раз.
• Secret для TOTP зберігали у зашифрованому вигляді в базі даних (AES-256-GCM, ключ у AWS KMS).
• На стороні фронтенду інтегрували @simplewebauthn/browser для passkeys — біометрична аутентифікація як альтернатива паролю. Публічний ключ зберігали на сервері, private key на пристрої користувача.
• Результат: час на логін зріс на 5 секунд, але кількість зламаних акаунтів упала до нуля за пів року роботи. Гарантія безпеки — на рівні OWASP ASVS Level 2.

Також варто зазначити, що TOTP значно надійніше за SMS-верифікацію через SIM-swapping, тому для фінансових даних ми рекомендуємо TOTP або апаратні ключі.

Типові вразливості, які ми знаходимо

• Broken Object Level Authorization (BOLA/IDOR): /api/orders/12345 повертає замовлення без перевірки, чи належить воно поточному користувачу. Найпоширеніша вразливість API за OWASP. Кожен запит до ресурсу — перевірка через $user->can('view', $order).
• Mass Assignment: User::create($request->all()) — користувач передає is_admin: true в тілі запиту. Laravel вирішує через $fillable / $guarded, але часто забувають.
• Небезпечний CORS: Access-Control-Allow-Origin: * на API з авторизацією по cookie — credentials не передаються з wildcard origin, але якщо хтось зробив Allow-Credentials: true + Allow-Origin: * — це діра.

Penetration testing обов’язковий для продуктів з фінансовими даними або персональними даними користувачів. Ми проводимо аудит коду й інфраструктури на етапі приймання.

Що входить у роботу

Ми передаємо замовнику:

• Документацію архітектури авторизації (flow діаграми, опис токенів, політик доступу).
• Репозиторій із вихідним кодом, покритий unit- та integration-тестами.
• Конфігурацію для CI/CD (GitHub Actions/ GitLab CI) із перевірками безпеки.
• Доступи до середовищ (staging, production) із правами адміністратора.
• Інструкцію з експлуатації та супроводу.
• Підтримку після впровадження — 2 тижні безкоштовних консультацій.

Терміни та вартість

Базова аутентифікація (email/password + OAuth + JWT/сесії): 1–3 тижні. RBAC з детальними політиками доступу: 2–4 тижні. 2FA (TOTP + SMS): 1–2 тижні. WebAuthn/Passkeys: 2–3 тижні. Повна система аутентифікації для SaaS з multi-tenancy: 4–8 тижнів.

Вартість розраховується індивідуально залежно від обсягу та складності. Замовте консультацію — оцінимо ваш проєкт безкоштовно. Отримайте гарантію безпеки вашої авторизації користувачів.