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

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 переменную окружения и активный адаптер базы данных (для хранения токенов):

Крипто-кошелек

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 переменную окружения и активный адаптер базы данных (для хранения токенов):

Крипто-кошелек

Nonce-подпись верификация через Viem. Поддерживает Ethereum, Polygon, Arbitrum, Optimism и Base:

Выбор адаптера

Адаптер определяется DB_BACKEND_MODE:

Режим	Адаптер	Источник
`k8s-postgres-fcm`

Связанная документация

Режимы бэкенда

Переменные окружения

Выбор базы данных

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

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

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

Использование на сервере

Использование на клиенте

Переменные окружения