Безопасность и RBAC
Собственный уровень безопасности строк Postgres, предопределенные роли, многопользовательский RBAC, журналы аудита. Ваши правила хранятся в базе данных — их можно тестировать, они имеют версии, их невозможно обойти на стороне клиента.
Безопасность живет на базе#
Aurabase использует встроенную систему безопасности на уровне строк PostgreSQL(RLS). Это означает, что ваши правила доступа написаны на SQL, хранятся в базе данных и применяются к каждому запросу, включая запросы, сделанные SDK, PostgREST или прямым psql.
В проекте MongoDB нет RLS. Изоляция обеспечивается зарезервированным полем _owner_id: любое чтение непривилегированной роли фильтруется по sub JWT, и любая запись помечает это поле. Перед отладкой пустого списка следует учитывать три последствия: документ, созданный с помощью ключа service_role, не имеет и _owner_id и поэтому становится невидимым для всех аутентифицированных пользователей (ответ [] в HTTP 200 без ошибок); вызывающая сторона anon без JWT получает 403 в закрытой коллекции; и _owner_id зарезервирован и никогда не может быть изменен клиентом. Коллекция открывается для чтения всем при явном согласии public_read.
На стороне клиента обойти политику невозможно. Шлюз проверяет каждый JWT перед открытием соединения Postgres с соответствующей ролью. Утверждения (auth.uid(), auth.role(), auth.tenant()) вводятся через request.jwt.claims — их нельзя изменить с помощью SQL-запроса.
Таблицы, созданные с помощью Aurabase (Studio, table API, миграции или /raw), по умолчанию автоматически получают ENABLE и FORCE ROW LEVEL SECURITY (если они явно не отключены в DDL). Перед добавлением политик всегда проверяйте RLS в таблицах, созданных через прямое соединение psql с alter table ... enable row level security.
JWT → претензии → политика → строка#
Каждый запрос следует одному и тому же пути. Шлюз декодирует JWT, проверяет свою подпись (ES256 с секретом, полученным из проекта по умолчанию; RS256 с JWKS, только если настроен ключ RSA), извлекает утверждения, открывает соединение Postgres с SET LOCAL role + SET LOCAL request.jwt.claims. Все политики, ссылающиеся на auth.*(), используют эти утверждения.
Client → Gateway verify JWT (ES256 via JWKS, project key)
↓ extract { sub, role, tenant, exp }
Postgres SET LOCAL role = authenticated
SET LOCAL request.jwt.claims = {...}
↓
SELECT ... FROM posts WHERE ...
↓ (RLS injecte la policy USING)
SELECT ... FROM posts WHERE author_id = auth.uid()
Три роли Postgres, четкая иерархия#
| Роль | Претензии | Описание |
|---|---|---|
anon | Нет user_id | Запросы, сделанные с использованием ключа anon и без подписанного пользователя JWT |
authenticated | auth.uid() — пользователь | Вошедший в систему пользователь с действительным JWT из любого сеанса Aurabase. |
service_role | Обходит RLS | Серверный ключ, который передает каждую политику. Только сервер. |
Пять основных моделей#
Политики привязаны к таблице + операции (SELECT/INSERT/UPDATE/DELETE) + роли. Несколько политик в одной паре объединяются в OR. Используйте using для фильтрации существующих строк и with check для проверки новых значений.
alter table posts enable row level security;
-- Чтение: только автор
create policy "posts_own_read"
on posts for select
to aura_authenticated
using (auth.uid() = author_id);
Проверьте свои политики с помощью pg_prove. Один файл rls_posts.sql на таблицу, выполняемый в CI при каждой миграции. См. руководство RLS.
За пределами анонима/аутентифицированного#
Роли приложения (администратор, редактор, просмотрщик, биллинг и т. д.) находятся в массиве roles пользовательского app_metadata, который может писать только сервер (API администратора PUT /admin/users/{id} с ключом service_role или перехватчик токена доступа). Каждый пользователь может иметь N ролей. Они перемещаются в токене под app_metadata.roles, а auth.has_role('admin') считывает их в ваших политиках. user_metadata никогда не предоставляет роль: пользователи могут редактировать ее самостоятельно. Не путайте их с утверждением role токена (anon или authenticated: уровень Postgres, читаемый auth.role()) или с полем role пользователя (свободная метка, отображаемая в Studio, например user или editor): ни один из них не предоставляет роль приложения.
-- Админ все видит
create policy "posts_admin_read"
on posts for select
to aura_authenticated
using (auth.has_role('admin'));
-- Платежи видят конфиденциальные столбцы в специальном представлении.
create view posts_billing as
select id, author_id, revenue_cents from posts
where auth.has_role('billing');
Полная трассировка, экспорт в SIEM#
Каждое событие безопасности регистрируется в project_{uuid}_auth.auth_audit_log: вход, выход, смена пароля, mfa_enroll, role_granted, service_role_access, error_auth. 30 дней хранения в версии Pro, 2 года в версии Enterprise.
Автоматический экспорт в ваш SIEM (Splunk, Datadog, Elastic) через вебхук или поток Kafka. См. /docs/compliance для получения подробных схем событий.