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

Безопасность на уровне строк в производстве

Три шаблона RLS, охватывающие 95 % случаев использования: владение, многопользовательская организация, иерархическая организация. С помощью pg_prove и отладочных тестов.

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

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

Что такое 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.

migrations/posts_rls.sqlsql
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, поэтому политика запрещает).

migrations/tenant_rls.sqlsql
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().

migrations/org_rls.sqlsql
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 для отката обратной записи), поэтому ответ будет именно тем, что увидит ваше приложение:

tests/rls.shbash
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 означает, что вы находитесь в прямой БД, а не через шлюз

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