re:re:actable
Урок 113 минуты чтения

Как устроены роли, права и Row Level Security

На этой странице
Кратко

В PostgreSQL и пользователи, и группы — это роли: роль с LOGIN может подключаться, роль без него служит группой прав, и одни роли входят в другие (GRANT readonly TO analyst). Права выдаются на объекты через GRANT/REVOKE: CONNECT на базу, USAGE на схему, SELECT/INSERT/UPDATE/DELETE на таблицы (можно и на отдельные столбцы). Принцип наименьших привилегий: приложение подключается не суперпользователем и не владельцем таблиц, миграции — отдельной ролью. Row Level Security (RLS) добавляет фильтр на уровне строк: политики (CREATE POLICY) определяют, какие строки роль может видеть и изменять, — основа мультиарендности в одной таблице и подхода Supabase, где клиент обращается к базе напрямую.

Вопрос

Как в PostgreSQL устроены роли и права и что такое Row Level Security?

Роли

CREATE ROLE readonly NOLOGIN;                        -- группа
CREATE ROLE app_user LOGIN PASSWORD '...';           -- пользователь приложения
CREATE ROLE migrator LOGIN PASSWORD '...';           -- владелец схемы, только для миграций
GRANT readonly TO analyst;                           -- членство в группе

Выдача прав

GRANT CONNECT ON DATABASE shop TO app_user;
GRANT USAGE ON SCHEMA public TO app_user;
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO app_user;
GRANT USAGE ON ALL SEQUENCES IN SCHEMA public TO app_user;
 
-- для будущих таблиц, созданных migrator
ALTER DEFAULT PRIVILEGES FOR ROLE migrator IN SCHEMA public
  GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO app_user;
 
-- права на отдельные столбцы
GRANT SELECT (id, name, avatar_url) ON users TO support;

Принцип наименьших привилегий

РольПрава
migratorВладелец схемы, CREATE, DDL
app_userТолько DML на нужные таблицы
readonly / analystSELECT, часто на реплике
postgres (superuser)Только администрирование, не в приложении

Если приложение взломают через SQL-инъекцию, ущерб ограничен правами его роли: DROP TABLE или чтение pg_shadow будут недоступны.

Row Level Security

ALTER TABLE documents ENABLE ROW LEVEL SECURITY;
 
-- пользователь видит и меняет только документы своей организации
CREATE POLICY tenant_isolation ON documents
  USING (tenant_id = current_setting('app.tenant_id')::bigint)
  WITH CHECK (tenant_id = current_setting('app.tenant_id')::bigint);
// в начале транзакции приложение задаёт контекст
await tx.query("SELECT set_config('app.tenant_id', $1, true)", [String(tenantId)]);  // true = только эта транзакция
const docs = await tx.query("SELECT * FROM documents");    // фильтр применится автоматически
Часть политикиЧто делает
USING (...)Какие существующие строки видны для SELECT/UPDATE/DELETE
WITH CHECK (...)Каким условиям должны удовлетворять новые/изменённые строки
`FOR SELECTINSERT
TO roleДля каких ролей

Нюансы RLS

  • Владелец таблицы и суперпользователь обходят RLS (для владельца — ALTER TABLE ... FORCE ROW LEVEL SECURITY).
  • Если RLS включён, но политик нет, — доступ запрещён ко всем строкам (default deny).
  • Условие политики добавляется к каждому запросу — нужен индекс по tenant_id.
  • С пулом соединений контекст задают на транзакцию (set_config(..., true) / SET LOCAL), иначе он «протечёт» к другому запросу.

Частые ошибки

  • Приложение работает под postgres или владельцем таблиц.
  • Забыть ALTER DEFAULT PRIVILEGES — новые таблицы недоступны приложению.
  • Задать tenant через SET на уровне сессии при пуле соединений.
  • Считать RLS заменой проверок авторизации в API — это дополнительный слой.

Что важно помнить

  • Роль = пользователь или группа.
  • GRANT на базу, схему и объекты; минимум прав для приложения.
  • RLS фильтрует строки политиками на уровне базы.

Мини-шпаргалка

  • CREATE ROLE name LOGIN | NOLOGIN.
  • GRANT ... ON ... TO ..., REVOKE.
  • ALTER DEFAULT PRIVILEGES.
  • ENABLE ROW LEVEL SECURITY, CREATE POLICY ... USING ... WITH CHECK ....
  • set_config('app.x', v, true).

Документация

PostgreSQL: Database Roles, PostgreSQL: Privileges, PostgreSQL: Row Security Policies.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам