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

Попроси ИИ «добавить роль админа» — и в девяти случаях из десяти получишь вот это:
{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 коротких урока на телефоне.





