ABAC в Node.js с Express
Управление доступом на основе ролей отвечает на вопрос "что может делать редактор?". Многие реальные правила требуют больше, чем просто роль: авторы могут редактировать свои черновики, редакторы могут редактировать статьи своего отдела, любой может читать опубликованную статью. Это зависит от атрибутов пользователя и ресурса, что и является целью управления доступом на основе атрибутов (ABAC).
Этот учебник создает небольшое API статей с помощью Express и помещает все эти правила в файл политики Casbin. Та же модель и политика работают без изменений в версиях этого учебника для Go и Python. Если вы еще выбираете между RBAC и ABAC, сначала прочитайте Выбор модели управления доступом.
1. Установка
npm install casbin express
2. Напишите модель
Сохраните это как model.conf:
[request_definition]
r = sub, obj, act
[policy_definition]
p = sub_rule, obj_type, act
[policy_effect]
e = some(where (p.eft == allow))
[matchers]
m = r.obj.Type == p.obj_type && r.act == p.act && eval(p.sub_rule)
r.subиr.obj— это обычные объекты JavaScript. Matcher читает их свойства, такие какr.obj.Type.- Каждое правило политики содержит условие в
sub_rule.eval(p.sub_rule)вычисляет это условие относительно запроса, поэтому правила находятся в политике, а не в модели.
3. Напишите политику
Сохраните это как policy.csv:
p, r.obj.Status == 'published', article, read
p, r.sub.Name == r.obj.Owner, article, read
p, r.sub.Name == r.obj.Owner && r.obj.Status == 'draft', article, update
p, r.sub.Role == 'editor' && r.sub.Department == r.obj.Department, article, update
p, r.sub.Role == 'editor' && r.sub.Department == r.obj.Department, article, publish
Читайте каждую строку как "разрешить это действие со статьями, когда условие истинно":
- Любой может читать опубликованную статью.
- Авторы могут читать свои статьи, включая черновики.
- Авторы могут редактировать свои статьи, пока они являются черновиками.
- Редакторы могут редактировать любую статью своего отдела.
- Редакторы могут публиковать статьи своего отдела.
Пишите строковые литералы в ус ловиях одинарными кавычками, как в 'published'. Двойная кавычка внутри поля нарушает разбор CSV. Если условие требует запятой, заключите всё поле в двойные кавычки.
4. Добавьте middleware
ABAC требует сам ресурс, а не только его URL. Middleware authorize загружает статью, спрашивает Casbin и помещает статью в req, чтобы обработчик маршрута не загружал её повторно.
const express = require('express');
const { newEnforcer } = require('casbin');
// In a real application these come from your database.
const users = {
alice: { Name: 'alice', Role: 'author', Department: 'engineering' },
bob: { Name: 'bob', Role: 'editor', Department: 'engineering' },
carol: { Name: 'carol', Role: 'editor', Department: 'sales' },
dave: { Name: 'dave', Role: 'author', Department: 'engineering' },
};
const articles = {
1: { Type: 'article', Id: '1', Title: 'Draft by alice', Owner: 'alice', Department: 'engineering', Status: 'draft' },
2: { Type: 'article', Id: '2', Title: 'Published by alice', Owner: 'alice', Department: 'engineering', Status: 'published' },
};
// Loads the article, then asks Casbin whether the current user may perform `action` on it.
function authorize(enforcer, action) {
return async (req, res, next) => {
// Replace this with the user from your session or JWT.
const user = users[req.get('X-User')];
if (!user) {
return res.status(401).json({ error: 'unauthenticated' });
}
const article = articles[req.params.id];
if (!article) {
return res.status(404).json({ error: 'not found' });
}
if (!(await enforcer.enforce(user, article, action))) {
return res.status(403).json({ error: 'forbidden' });
}
req.article = article;
next();
};
}
async function main() {
const enforcer = await newEnforcer('model.conf', 'policy.csv');
const app = express();
app.use(express.json());
app.get('/articles/:id', authorize(enforcer, 'read'), (req, res) => {
res.json(req.article);
});
app.put('/articles/:id', authorize(enforcer, 'update'), (req, res) => {
req.article.Title = req.body?.title ?? req.article.Title;
res.json(req.article);
});
app.post('/articles/:id/publish', authorize(enforcer, 'publish'), (req, res) => {
req.article.Status = 'published';
res.json(req.article);
});
app.listen(3000, () => console.log('listening on http://localhost:3000'));
}
main();
Заголовок X-User используется для краткости примера. Casbin отвечает только за авторизацию; в реальном приложении пользователь берется из вашего слоя аутентификации, например, из проверенного JWT или сессии.
5. Попробуйте это
node app.js
Статья 1 — это черновик alice, а статья 2 — её опубликованная статья, обе в инженерном отделе.
curl -i -H "X-User: dave" http://localhost:3000/articles/1 # 403, someone else's draft
curl -i -H "X-User: dave" http://localhost:3000/articles/2 # 200, published
curl -i -X PUT -H "X-User: alice" -H "Content-Type: application/json" \
-d '{"title":"New title"}' http://localhost:3000/articles/1 # 200, her own draft
curl -i -X PUT -H "X-User: alice" http://localhost:3000/articles/2 # 403, no longer a draft
curl -i -X PUT -H "X-User: bob" http://localhost:3000/articles/2 # 200, editor in engineering
curl -i -X PUT -H "X-User: carol" http://localhost:3000/articles/2 # 403, editor in sales
curl -i -X POST -H "X-User: alice" http://localhost:3000/articles/1/publish # 403, authors cannot publish
curl -i -X POST -H "X-User: bob" http://localhost:3000/articles/1/publish # 200
curl -i -H "X-User: dave" http://localhost:3000/articles/1 # 200, now published
6. Изменение правил во время выполнения
Условия — это строки политики, поэтому их можно добавлять и удалять во время работы сервера, а также сохранять в базе данных через адаптер:
// Admins may edit any article.
await enforcer.addPolicy("r.sub.Role == 'admin'", 'article', 'update');
// Which rule allowed this request? Useful for audit logs.
const [ok, rule] = await enforcer.enforceEx(users.bob, articles[2], 'update');
// true [ "r.sub.Role == 'editor' && r.sub.Department == r.obj.Department", 'article', 'update' ]
ABAC или RBAC?
- Используйте RBAC, когда разрешения зависят от должностных обязанностей и не зависят от того, к какой записи выполняется доступ. Это проще для аудита: запрос «список всех действий, доступных редактору» выполняется легко. См. учебник по RBAC в Node.js.
- Используйте ABAC, когда результат зависит от самой записи: её владельца, отдела, статуса или уровня конфиденциальности.
- В большинстве приложений используются оба подхода: роли определяют, какие функции доступны пользователю, а атрибуты сужают этот круг до записей, к которым у него есть доступ. В сравнении моделей контроля доступа показана комбинированная модель.
Следующие шаги
- Полное справочное руководство по ABAC. ABAC подробно описывает параметры JSON-запросов, правила цитирования и
eval(). - NestJS. В учебнике NestJS показано использование guard и decorator, которые можно расширить той же моделью ABAC.
- Проверка разрешений в браузере. Casbin.js использует те же правила для отображения или скрытия кнопок во фронтенде.
- Эксперименты в браузере. Онлайн-редактор может выполнять оценку запросов ABAC с атрибутами в формате JSON.
Comments are powered by giscus and GitHub Discussions. They load from giscus.app and GitHub only after you click the button below.