Архітектура Аутентифікації

Ring Platform використовує Auth.js v5 (NextAuth) з JWT стратегією сесій. Адаптер (PostgreSQL або Firebase) обирається за DB_BACKEND_MODE. Використовуйте вкладки Засновник / Розробник у бічній панелі документації для фільтрації за аудиторією.

Провайдери

Провайдер	Потік	Auth.js провайдер
Google OAuth	Повний OAuth 2.0 redirect + Google Identity Services (GIS) One Tap	`GoogleProvider` + `CredentialsProvider("google-one-tap")`
Apple Sign-In	OAuth redirect, нативний iOS/macOS	`AppleProvider`
Magic Links	Email через Ring Mailer, 24-годинний термін дії токену	`Resend`
Крипто-гаманець	Nonce-підпис верифікація (MetaMask, WalletConnect)	`CredentialsProvider("crypto-wallet")`

Конфігурація знаходиться в auth.ts та auth.config.ts у корені проєкту. Auth.js v5 розділяє edge-безпечну конфігурацію (auth.config.ts — без провайдерів, мінімальні callbacks) від повної серверної конфігурації (auth.ts — всі провайдери, адаптери бази даних).

Як працює аутентифікація

Auth.js v5 керує всім потоком аутентифікації — платформа не використовує Firebase Auth безпосередньо. Firebase Admin SDK використовується лише для серверної верифікації токенів та пошуку документів користувачів у режимі firebase-full.

Потік сесії:

Користувач входить через Google, Apple, email посилання або крипто-гаманець
Auth.js v5 обробляє OAuth обмін токенами та верифікацію
JWT сесія створюється на сервері, зберігається в HTTP-only cookie
PostgreSQL адаптер зберігає записи користувача/акаунту/сесії коли DB_BACKEND_MODE базується на PostgreSQL
Firebase адаптер зберігає у Firestore коли DB_BACKEND_MODE=firebase-full

Ключові дизайн-рішення:

JWT стратегія (без зберігання сесій в БД) для edge-сумісного розгортання
30-денний максимальний вік сесії з 24-годинним вікном оновлення
Ідентичність завжди є платформним UUID (users.id), ніколи Google sub або Apple sub
Зв'язування акаунтів через email (однаковий email = той самий користувач)

Структура файлів Auth.js v5

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

Google OAuth (два режими)

Традиційний OAuth (redirect потік):

Google Identity Services (GIS) One Tap (клієнтське спливаюче вікно):

GIS JWT верифікується на сервері в signIn callback за допомогою google-auth-library:

Apple Sign-In

Magic Links (Resend)

Потребує SMTP_* або EMAIL_MODE=ethereal змінну середовища та активний адаптер бази даних (для зберігання токенів):

24-годинний термін дії токену (maxAge в Resend провайдері), одноразове використання, автоматична інвалідація.

Крипто-гаманець

Nonce-підпис верифікація через Viem. Підтримує Ethereum, Polygon, Arbitrum, Optimism та Base:

Вибір адаптера

Адаптер визначається DB_BACKEND_MODE:

Режим	Адаптер	Джерело
`k8s-postgres-fcm`

Пов'язана документація

Режими бекенду

Змінні середовища

Вибір бази даних

Архітектура Аутентифікації

Провайдери

Провайдер	Потік	Auth.js провайдер
Google OAuth	Повний OAuth 2.0 redirect + Google Identity Services (GIS) One Tap	`GoogleProvider` + `CredentialsProvider("google-one-tap")`
Apple Sign-In	OAuth redirect, нативний iOS/macOS	`AppleProvider`
Magic Links	Email через Ring Mailer, 24-годинний термін дії токену	`Resend`
Крипто-гаманець	Nonce-підпис верифікація (MetaMask, WalletConnect)	`CredentialsProvider("crypto-wallet")`

Як працює аутентифікація

Потік сесії:

Користувач входить через Google, Apple, email посилання або крипто-гаманець
Auth.js v5 обробляє OAuth обмін токенами та верифікацію
JWT сесія створюється на сервері, зберігається в HTTP-only cookie
PostgreSQL адаптер зберігає записи користувача/акаунту/сесії коли DB_BACKEND_MODE базується на PostgreSQL
Firebase адаптер зберігає у Firestore коли DB_BACKEND_MODE=firebase-full

Ключові дизайн-рішення:

JWT стратегія (без зберігання сесій в БД) для edge-сумісного розгортання
30-денний максимальний вік сесії з 24-годинним вікном оновлення
Ідентичність завжди є платформним UUID (users.id), ніколи Google sub або Apple sub
Зв'язування акаунтів через email (однаковий email = той самий користувач)

Структура файлів Auth.js v5

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

Google OAuth (два режими)

Традиційний OAuth (redirect потік):

Google Identity Services (GIS) One Tap (клієнтське спливаюче вікно):

GIS JWT верифікується на сервері в signIn callback за допомогою google-auth-library:

Apple Sign-In

Magic Links (Resend)

Потребує SMTP_* або EMAIL_MODE=ethereal змінну середовища та активний адаптер бази даних (для зберігання токенів):

24-годинний термін дії токену (maxAge в Resend провайдері), одноразове використання, автоматична інвалідація.

Крипто-гаманець

Nonce-підпис верифікація через Viem. Підтримує Ethereum, Polygon, Arbitrum, Optimism та Base:

Вибір адаптера

Адаптер визначається DB_BACKEND_MODE:

Режим	Адаптер	Джерело
`k8s-postgres-fcm`

Пов'язана документація

Режими бекенду

Змінні середовища

Вибір бази даних

Архітектура Аутентифікації

Провайдери

Провайдер	Потік	Auth.js провайдер
Google OAuth	Повний OAuth 2.0 redirect + Google Identity Services (GIS) One Tap	`GoogleProvider` + `CredentialsProvider("google-one-tap")`
Apple Sign-In	OAuth redirect, нативний iOS/macOS	`AppleProvider`
Magic Links	Email через Ring Mailer, 24-годинний термін дії токену	`Resend`
Крипто-гаманець	Nonce-підпис верифікація (MetaMask, WalletConnect)	`CredentialsProvider("crypto-wallet")`

Як працює аутентифікація

Потік сесії:

Користувач входить через Google, Apple, email посилання або крипто-гаманець
Auth.js v5 обробляє OAuth обмін токенами та верифікацію
JWT сесія створюється на сервері, зберігається в HTTP-only cookie
PostgreSQL адаптер зберігає записи користувача/акаунту/сесії коли DB_BACKEND_MODE базується на PostgreSQL
Firebase адаптер зберігає у Firestore коли DB_BACKEND_MODE=firebase-full

Ключові дизайн-рішення:

JWT стратегія (без зберігання сесій в БД) для edge-сумісного розгортання
30-денний максимальний вік сесії з 24-годинним вікном оновлення
Ідентичність завжди є платформним UUID (users.id), ніколи Google sub або Apple sub
Зв'язування акаунтів через email (однаковий email = той самий користувач)

Структура файлів Auth.js v5

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

Google OAuth (два режими)

Традиційний OAuth (redirect потік):

Google Identity Services (GIS) One Tap (клієнтське спливаюче вікно):

GIS JWT верифікується на сервері в signIn callback за допомогою google-auth-library:

Apple Sign-In

Magic Links (Resend)

Потребує SMTP_* або EMAIL_MODE=ethereal змінну середовища та активний адаптер бази даних (для зберігання токенів):

24-годинний термін дії токену (maxAge в Resend провайдері), одноразове використання, автоматична інвалідація.

Крипто-гаманець

Nonce-підпис верифікація через Viem. Підтримує Ethereum, Polygon, Arbitrum, Optimism та Base:

Вибір адаптера

Адаптер визначається DB_BACKEND_MODE:

Режим	Адаптер	Джерело
`k8s-postgres-fcm`

Пов'язана документація

Режими бекенду

Змінні середовища

Вибір бази даних

PostgreSQLAdapter

text


auth.config.ts          — Edge-сумісна конфігурація (порожні провайдери, authorized callback, redirects)
auth.ts                 — Повна серверна конфігурація (всі провайдери, адаптер БД, JWT/сесійні callbacks)
lib/auth-adapter-singleton.ts  — Кешований адаптер: PostgreSQLAdapter або FirestoreAdapter
lib/auth/postgres-adapter.ts   — Спеціалізований PostgreSQL адаптер для Auth.js v5
lib/firebase-admin.server.ts   — Firebase Admin SDK екземпляр (getAdminAuth, getAdminDb)
app/api/auth/[...nextauth]/route.ts  — Auth.js API route handler

bash


# Auth.js core
AUTH_SECRET=your_auth_secret
AUTH_TRUST_HOST=true

# Google OAuth
AUTH_GOOGLE_ID=your_google_client_id
AUTH_GOOGLE_SECRET=your_google_client_secret

# Apple Sign-In
AUTH_APPLE_ID=your_apple_client_id
AUTH_APPLE_SECRET=your_apple_private_key

# Magic Links
# Ring Mailer: EMAIL_MODE=ethereal or SMTP_HOST / SMTP_USER / SMTP_PASSWORD
# OTP_HMAC_SECRET=

# Firebase (тільки для firebase-full режиму)
AUTH_FIREBASE_PROJECT_ID=your_firebase_project_id
AUTH_FIREBASE_CLIENT_EMAIL=your_firebase_client_email
AUTH_FIREBASE_PRIVATE_KEY=your_firebase_private_key

# WalletConnect
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id

PostgreSQLAdapter

text


auth.config.ts          — Edge-сумісна конфігурація (порожні провайдери, authorized callback, redirects)
auth.ts                 — Повна серверна конфігурація (всі провайдери, адаптер БД, JWT/сесійні callbacks)
lib/auth-adapter-singleton.ts  — Кешований адаптер: PostgreSQLAdapter або FirestoreAdapter
lib/auth/postgres-adapter.ts   — Спеціалізований PostgreSQL адаптер для Auth.js v5
lib/firebase-admin.server.ts   — Firebase Admin SDK екземпляр (getAdminAuth, getAdminDb)
app/api/auth/[...nextauth]/route.ts  — Auth.js API route handler

bash


# Auth.js core
AUTH_SECRET=your_auth_secret
AUTH_TRUST_HOST=true

# Google OAuth
AUTH_GOOGLE_ID=your_google_client_id
AUTH_GOOGLE_SECRET=your_google_client_secret

# Apple Sign-In
AUTH_APPLE_ID=your_apple_client_id
AUTH_APPLE_SECRET=your_apple_private_key

# Magic Links
# Ring Mailer: EMAIL_MODE=ethereal or SMTP_HOST / SMTP_USER / SMTP_PASSWORD
# OTP_HMAC_SECRET=

# Firebase (тільки для firebase-full режиму)
AUTH_FIREBASE_PROJECT_ID=your_firebase_project_id
AUTH_FIREBASE_CLIENT_EMAIL=your_firebase_client_email
AUTH_FIREBASE_PRIVATE_KEY=your_firebase_private_key

# WalletConnect
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id

PostgreSQLAdapter

text


auth.config.ts          — Edge-сумісна конфігурація (порожні провайдери, authorized callback, redirects)
auth.ts                 — Повна серверна конфігурація (всі провайдери, адаптер БД, JWT/сесійні callbacks)
lib/auth-adapter-singleton.ts  — Кешований адаптер: PostgreSQLAdapter або FirestoreAdapter
lib/auth/postgres-adapter.ts   — Спеціалізований PostgreSQL адаптер для Auth.js v5
lib/firebase-admin.server.ts   — Firebase Admin SDK екземпляр (getAdminAuth, getAdminDb)
app/api/auth/[...nextauth]/route.ts  — Auth.js API route handler

bash


# Auth.js core
AUTH_SECRET=your_auth_secret
AUTH_TRUST_HOST=true

# Google OAuth
AUTH_GOOGLE_ID=your_google_client_id
AUTH_GOOGLE_SECRET=your_google_client_secret

# Apple Sign-In
AUTH_APPLE_ID=your_apple_client_id
AUTH_APPLE_SECRET=your_apple_private_key

# Magic Links
# Ring Mailer: EMAIL_MODE=ethereal or SMTP_HOST / SMTP_USER / SMTP_PASSWORD
# OTP_HMAC_SECRET=

# Firebase (тільки для firebase-full режиму)
AUTH_FIREBASE_PROJECT_ID=your_firebase_project_id
AUTH_FIREBASE_CLIENT_EMAIL=your_firebase_client_email
AUTH_FIREBASE_PRIVATE_KEY=your_firebase_private_key

# WalletConnect
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Loading documentation...

Loading documentation...

Архітектура Аутентифікації

Провайдери

Як працює аутентифікація

Пов'язана документація

Режими бекенду

Змінні середовища

Вибір бази даних

Архітектура Аутентифікації

Провайдери

Як працює аутентифікація

Пов'язана документація

Режими бекенду

Змінні середовища

Вибір бази даних

Архітектура Аутентифікації

Провайдери

Як працює аутентифікація

Пов'язана документація

Режими бекенду

Змінні середовища

Вибір бази даних

Інтеграція Firebase Admin SDK

Використання на сервері

Використання на клієнті

Змінні середовища

Інтеграція Firebase Admin SDK

Використання на сервері

Використання на клієнті

Змінні середовища

Інтеграція Firebase Admin SDK

Використання на сервері

Використання на клієнті

Змінні середовища