Перейти к основному содержимому

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

Читайте каждую строку как "разрешить это действие со статьями, когда условие истинно":

  1. Любой может читать опубликованную статью.
  2. Авторы могут читать свои статьи, включая черновики.
  3. Авторы могут редактировать свои статьи, пока они являются черновиками.
  4. Редакторы могут редактировать любую статью своего отдела.
  5. Редакторы могут публиковать статьи своего отдела.
подсказка

Пишите строковые литералы в условиях одинарными кавычками, как в 'published'. Двойная кавычка внутри поля нарушает разбор CSV. Если условие требует запятой, заключите всё поле в двойные кавычки.

4. Добавьте middleware​

ABAC требует сам ресурс, а не только его URL. Middleware authorize загружает статью, спрашивает Casbin и помещает статью в req, чтобы обработчик маршрута не загружал её повторно.

app.js
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.