Аутентификация
OAuth с 15 провайдерами, TOTP MFA, магические ссылки, одноразовые коды по электронной почте и SMS, а также управление доступом на основе ролей из одного SDK.
Что делает аура-аутентификация#
Служба aura-auth выдает и проверяет JWT для пользователей в проекте. Подпись — ES256 по умолчанию с секретом , полученным из проекта; RS256 (и предоставление JWKS) используется только в том случае, если настроен ключ RSA — это добровольное согласие, а не поведение по умолчанию. Он управляет полным жизненным циклом: регистрация, проверка электронной почты, MFA, ротация токенов обновления, отзыв на стороне сервера.
Каждый токен включает sub, project_id, role (anon или authenticated), email и объект app_metadata , содержащий ваши утверждения на стороне сервера (tenant, roles). Шлюз внедряет эти утверждения в соединения Postgres через request.jwt.claims, делая политики RLS напрямую доступными для auth.uid(), auth.role(), auth.tenant().
Пользовательские таблицы находятся в project_{uuid}_auth: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.
Три действующих лица, три ответственности#
Клиент подписывает запрос, служба запрашивает базу данных, шлюз проверяет каждый последующий запрос.
# 1. Клиент → aura-auth: учетные данные
POST /v1/auth/login { email, password }
# 2. aura-auth: проверка Argon2id + MFA, если требуется (статус остается 200)
if password OK && mfa_required → data = { mfa_required: true, mfa_token }
else → data = { access_token, refresh_token, user, ... }
# 3. Последующие запросы проходят через шлюз.
apikey: <anon_key> + Authorization: Bearer <jwt>
gateway vérifie le JWT → claims injectés → Postgres RLS
Восемь механизмов готовы#
- Электронная почта + пароль. Argon2id, дополнительная проверка электронной почты, безопасная ротация.
- OAuth 2.1 · PKCE. 15 провайдеров — Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat.
- MFA TOTP. Аутентификация, 1Password, Google Authenticator. Резервное СМС.
- Волшебные ссылки и OTP. Электронная почта без пароля, шаблоны i18n, ограничение скорости по адресу.
- Детальный RBAC. Роли, разрешения, организационные иерархии. Самогенерируемые политики RLS.
- Привязка сеанса. Отпечаток устройства, проверка IP, токены обновления ротации.
Четыре потока, один SDK#
'use server'
import { aura } from '@/lib/aurabase'
export async function signUp(email: string, password: string) {
const { data, error } = await aura.auth.signUp({
email,
password,
options: { emailRedirectTo: '/auth/callback' },
})
if (error) return { error }
return { user: data.user }
}
В маршрутизаторе приложений Next.js всегда используйте помощник createServerClient из @aurabase/aurabase-js/ssr в действиях сервера и обработчиках маршрутов. Токен обновления файлов cookie — httpOnly, и его никогда не следует читать клиентскому JS.
Если вы не используете SDK#
Все потоки также отображаются в необработанном REST с теми же проверками на стороне сервера. Полный список см. в /docs/api-rest.
| Метод | Конечная точка | Описание |
|---|---|---|
POST | /v1/auth/register | Создайте учетную запись с электронной почтой и паролем |
POST | /v1/auth/login | Войти с паролем |
GET | /v1/auth/oauth/{provider}/start | Запуск потока OAuth (PKCE) |
POST | /v1/auth/magic-link | Отправить волшебную ссылку |
POST | /v1/auth/email-otp/send | Отправьте одноразовый код по электронной почте |
POST | /v1/auth/mfa/setup | Зарегистрируйте фактор TOTP |
POST | /v1/auth/refresh | Обновить пару токенов |
GET | /v1/auth/me | Вернуть текущего пользователя |
GET | /v1/auth/sessions | Список активных сеансов |
DELETE | /v1/auth/sessions/{session_id} | Отменить сеанс |
POST | /v1/auth/logout | Завершить текущий сеанс |