Гайды

Как сделать роли пользователей — админ и обычный, без дыры в доступе

Иллюстрация: две двери, у одной — пропуск, за обеими — общий пост охраны

Попроси ИИ «добавить роль админа» — и в девяти случаях из десяти получишь вот это:

{user.isAdmin && <button onClick={deleteAllUsers}>Удалить всех</button>}

Выглядит рабочим: обычный пользователь кнопку не видит. Но кнопка — это не защита. Открой консоль браузера, вызови тот же запрос руками — и он выполнится, потому что сервер вообще ни о чём не спрашивал. Роль, которая живёт только в интерфейсе, не роль, а вежливая просьба.

Ниже — пять шагов, которые делают роли настоящими. Порядок важен: интерфейс идёт последним, а не первым.

1. Реши, где живёт роль

Роль — это данные о пользователе, значит её место в базе, рядом с профилем. Не в localStorage, не в состоянии приложения, не в скрытом поле формы: всё это лежит на стороне пользователя, а значит правится пользователем.

Одна колонка, значение по умолчанию — самое безопасное:

alter table profiles
  add column role text not null default 'user';

Не начинай с таблицы ролей, таблицы прав и связей между ними. Для 99% первых проектов хватает двух значений: user и admin. Расширить потом — работа на десять минут, а вот разбираться в собственной системе прав на старте — работа на неделю. Если колонку добавляешь в живой проект, сделай это миграцией, а не руками в панели.

2. Выдай роль первому админу вручную

Курица и яйцо: интерфейса выдачи роли ещё нет, а админ уже нужен. Первого назначь прямо в базе:

update profiles set role = 'admin'
where email = 'ты@example.com';

Никогда не делай публичную ручку «стать админом» — даже временно, даже «на пять минут для теста». Про этот и другие грабли перед запуском есть чеклист безопасности.

3. Закрой данные на сервере — это главный шаг

Проверка должна стоять там, куда пользователь не дотянется: в базе или в серверном обработчике. Здесь как раз разница между аутентификацией и авторизацией: вход уже подтвердил, кто это, а сейчас мы решаем, что ему можно.

Если у тебя Postgres с RLS (например, Supabase) — правило пишется в самой базе, и обойти его нельзя даже с валидным токеном:

create policy "admins delete any profile"
on profiles for delete
using (
  (select role from profiles where id = auth.uid()) = 'admin'
);

Если бэкенд свой — та же мысль в коде обработчика, самой первой строкой:

const me = await db.profiles.findById(session.userId);
if (me.role !== 'admin') {
  return res.status(403).json({ error: 'forbidden' });
}

Два принципа, которые тут работают:

  • Роль берётся из базы, а не из запроса. Если клиент присылает {"role":"admin"} — это не данные, это пожелание. Игнорируй.
  • Код ответа — 403, а не 401. 401 значит «я не знаю, кто ты», 403 — «знаю, но нельзя». Почему это не одно и то же — отдельный разбор, и путаница тут ломает логику на клиенте.

4. Спрячь интерфейс — но только как удобство

Вот теперь можно вернуться к той самой кнопке. Скрывать её нужно, но по другой причине: чтобы человек не жал на то, что ему всё равно откажут. Это забота об удобстве, а не защита.

{me.role === 'admin' && <AdminPanel />}

Держи в голове формулу: сервер запрещает, интерфейс не искушает. Если убрать шаг 4, приложение станет неудобным. Если убрать шаг 3 — дырявым.

5. Проверь себя как злоумышленник

Пять минут работы, которые находят почти все дыры. Зайди обычным пользователем, скопируй свой токен из инструментов разработчика и постучись в админский эндпоинт напрямую:

curl -X DELETE https://твой-сайт/api/users/7 \
  -H "Authorization: Bearer ТОКЕН_ОБЫЧНОГО_ЮЗЕРА"

Ждём 403. Получил 200 — шаг 3 не сработал, и об этом лучше узнать сейчас, а не из логов после инцидента.

Что получится: админ видит и делает больше, обычный пользователь — нет, и это верно не только в интерфейсе, но и на уровне данных. Роль можно поменять одной строкой в базе, без релиза. А главное — на вопрос «а если он вызовет API напрямую?» у тебя есть проверенный ответ.

Сколько ролей делать на старте?

Две: user и admin. Третью добавляй, когда появится живой сценарий, который без неё не работает, — а не «на будущее». Гибкая система прав, которой никто не пользуется, — самый дорогой вид неиспользуемого кода.

Хранить роль в JWT-токене или каждый раз читать из базы?

Роль в токене экономит запрос к базе, но у неё есть срок жизни: разжаловал админа — а его токен ещё час действует как админский. Для первого проекта читай из базы. Кладёшь в токен — держи время жизни коротким и умей отзывать сессию.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →