Безопасность на уровне строк в производстве
Три шаблона RLS, охватывающие 95 % случаев использования: владение, многопользовательская организация, иерархическая организация. С помощью pg_prove и отладочных тестов.
Что такое RLS#
Безопасность на уровне строк — это встроенная функция PostgreSQL, которая фильтрует возвращаемые (или принятые) строки на лету, оценивая выражение SQL, которое может зависеть от текущей роли и утверждений JWT. Aurabase внедряет утверждения пользователя через request.jwt.claims и предоставляет помощники auth.uid(), auth.role(), auth.tenant(), auth.has_role().
- Имена ролей. Канонические роли базы данных:
aura_anon,aura_authenticatedиaura_service_role. В управляемых кластерах псевдонимы группanon,authenticatedиservice_roleтакже сопоставляются с ними (обратите внимание, чтоBYPASSRLSостается только наaura_service_role). - RLS включен по умолчанию для таблиц, созданных с помощью Aurabase. Любая таблица, созданная с помощью
/raw, миграции, Studio или API таблиц, автоматически получаетENABLEиFORCE ROW LEVEL SECURITY(если толькоDISABLE ROW LEVEL SECURITYне выполняется явно в одном и том же пакете DDL): общедоступные/анонные запросы возвращают[], пока вы не добавите политику. Таблицы, созданные через прямое соединение PostgreSQL (psql, Prisma, Drizzle ), никогда не проходят через этот крючок, поэтому они получают no RLS и вместо этого не имеют доступа к открытым ключам:aura_anonиaura_authenticatedне имеют к ним никаких привилегий пока вы не предоставите это. Чтобы предоставить такую таблицу SDK, сначала включите RLS, затем разрешите и добавьте политику:ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY .... Никогда не предоставляйте праваaura_anonилиaura_authenticatedдля таблицы, у которой RLS выключен: каждый владелец открытого ключа или каждый зарегистрированный пользователь будет читать (и, при наличии разрешений на запись, изменять) все ее строки. - У открытого ключа нет пользователя.
auth.uid()— этоNULLдля открытого ключа и для ключаservice_role; он возвращает идентификатор только для вошедшего в систему пользователя. Используйтеto aura_authenticated, чтобы ограничить политику только вошедшими в систему пользователями.
Право собственности — каждому пользователю свои линии#
Варианты использования: профили, заметки, сообщения, где каждая строка принадлежит уникальному пользователю через user_id или author_id.
alter table posts enable row level security;
create policy "posts_own_read" on posts
for select to aura_authenticated
using (auth.uid() = author_id);
create policy "posts_own_write" on posts
for all to aura_authenticated
using (auth.uid() = author_id)
with check (auth.uid() = author_id);
Объедините for all с using + with check, чтобы охватить SELECT/UPDATE/DELETE в одной политике. INSERT использует только with check.
Мультитенантность — объем по организациям#
Вариант использования: B2B SaaS, где каждый пользователь принадлежит организации и видит все данные своей организации. JWT содержит app_metadata.tenant, который возвращает помощник auth.tenant() (NULL если он отсутствует или не имеет UUID, поэтому политика запрещает).
create policy "orders_tenant_scope" on orders
for all to aura_authenticated
using (tenant_id = auth.tenant())
with check (tenant_id = auth.tenant());
-- Незаменимый показатель производительности
create index idx_orders_tenant on orders(tenant_id);
Иерархическая организация — разрешения по ролям#
Вариант использования: SaaS, где роли в организации (администратор, участник, зритель) имеют разные разрешения. Мы объединяем auth.tenant() с auth.has_role().
create policy "invoices_read" on invoices
for select to aura_authenticated
using (
tenant_id = auth.tenant()
and (auth.has_role('admin') or auth.has_role('billing'))
);
create policy "invoices_write" on invoices
for all to aura_authenticated
using (tenant_id = auth.tenant() and auth.has_role('admin'))
with check (tenant_id = auth.tenant());
pg_prove — одно утверждение на каждую политику#
Проверьте свои политики — как реальный пользователь в CI
Политики — это код, поэтому проверяйте их. aura db raw ... --as authenticated --user <uuid> запускает SQL внутри PostgreSQL с auth.uid() и auth.role(), установленными для этого пользователя (добавьте --dry-run для отката обратной записи), поэтому ответ будет именно тем, что увидит ваше приложение:
set -euo pipefail
ALICE=$(aura auth users create --email alice@example.com --password 'Passw0rd!long1' --json | jq -r .id)
BOB=$(aura auth users create --email bob@example.com --password 'Passw0rd!long1' --json | jq -r .id)
aura db raw "insert into posts(author_id, title) values ('$ALICE', 'hello')"
# Боб не должен видеть сообщение Алисы
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# Алиса должна это увидеть
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# Посетитель ничего не видит
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"
Запустите его в CI после aura db push. Симулятор RLS Studio (База данных › таблица › симулятор RLS) выполняет ту же проверку внутри отката транзакции PostgreSQL и сообщает об этом рядом с результатом; pgTAP и pg_prove требуют прямого соединения PostgreSQL, которое публикуется не в каждом развертывании.
Когда политика не делает то, что вы хотите#
- Пустой результат? Анонимное чтение или чтение таблицы с входом в систему с RLS и отсутствием соответствующей политики
SELECTвозвращает[]сmeta.hint, который называет роль и политику, которую нужно добавить.aura db raw "select * from posts" --as anonпоказывает то, что видит посетитель. - RLS отключен?
aura db table listпомечает таблицы с помощью[RLS], а советник предупреждает о таблицах с отключенным RLS и таблицах с RLS, но без политики. Отключение RLS (aura db table rls posts off) делает таблицу доступной для чтения всем, у кого есть открытый ключ. - Просмотров. Представление читает с привилегиями читателя (
security_invoker = trueприменяется к каждому созданному вами представлению), поэтому применяются политики его таблиц. - Политики, которые складываются в: несколько политик в одной таблице + операция + роль объединяются в ИЛИ. При необходимости ограничьте с помощью AND в одной политике.
- Отсутствуют разрешения GRANT: даже при наличии политики роль должна иметь
grant select on posts to aura_authenticated - Утверждения не внедряются: из Postgres,
select current_setting('request.jwt.claims', true)— значение null означает, что вы находитесь в прямой БД, а не через шлюз