Перейти к содержимому
Логотип Аурабаза
аурабаза

Аутентификация

OAuth с 15 провайдерами, TOTP MFA, магические ссылки, одноразовые коды по электронной почте и SMS, а также управление доступом на основе ролей из одного SDK.

Пояснение7 мин читатьУровень среднийПересмотрено 15 апр. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

Что делает аура-аутентификация#

Служба 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.

Три действующих лица, три ответственности#

Клиент подписывает запрос, служба запрашивает базу данных, шлюз проверяет каждый последующий запрос.

процесс входа в системуtext
# 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#

app/actions/auth.tstypescript
'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Завершить текущий сеанс

Чтобы пойти дальше#