Авторизация в APISIX с использованием Casbin
Введение
Apache APISIX может применять политики авторизации Casbin на шлюзе с помощью встроенного плагина authz-casbin. Плагин использует Lua Casbin и поддерживает модели контроля доступа, такие как ACL, RBAC и ABAC.
Это руководство размещает небольшую политику RBAC на пути запроса APISIX. Вы проверите разрешённые и отклонённые запросы, а затем обновите общую политику через метаданные плагина без изменения маршрута.
Сообщество Casbin изначально предложило интеграцию в APISIX Issue #4674, а APISIX PR #4710 добавил плагин.
Это руководство было обновлено в августе 2026 года. Примеры были проверены на Apache APISIX 3.17.0. Оригинальный автор 2021 года остаётся указан, а Илия Лин добавлена за обновление 2026 года.
Casbin выполняет авторизацию, а не аутентификацию. В примере используется заголовок запроса user в качестве субъекта только для того, чтобы тест оставался небольшим. В производственной среде не доверяйте заголовку идентификации, предоставляемому непосредственно клиентом. Слой аутентификации или доверенный прокси должны устанавливать личность и удалять или перезаписывать недоверенные значения перед тем, как Casbin оценит запрос.
Предварительные требования и начальное состояние
Это руководство начинается с одноразового экземпляра Apache APISIX 3.17.0, который уже запущен. Если вам нужен локальный экземпляр, следуйте руководству по развертыванию APISIX Docker и зафиксируйте образ APISIX на версии apache/apisix:3.17.0-debian.
Экземпляр должен иметь:
- плоскость данных, доступную по адресу
http://127.0.0.1:9080; - Admin API, доступный по адресу
http://127.0.0.1:9180; - встроенные плагины
authz-casbinиmockingвключены.
Вам также потребуются curl и jq. Установите значение переменной admin_key, равное ключу, настроенному для вашего
Admin API:
export admin_key='<your-admin-api-key>'
Замените заполнитель перед продолжением работы. Убедитесь, что Admin API доступен, и плагин включён:
curl --fail-with-body \
"http://127.0.0.1:9180/apisix/admin/plugins/list" \
-H "X-API-KEY: $admin_key" | \
jq -e '(["authz-casbin", "mocking"] - .) | length == 0'
Команда должна вывести true. Не публикуйте Admin API в ненадёжной сети
и не используйте демонстрационные учётные данные в другой сре де.
Определение модели и политики
Плагин оценивает три значения запроса:
sub: субъект из настроенного заголовка запроса;obj: путь URI запроса; иact: HTTP-метод.
Создайте файл model.conf:
[request_definition]
r = sub, obj, act
[policy_definition]
p = sub, obj, act
[role_definition]
g = _, _
[policy_effect]
e = some(where (p.eft == allow))
[matchers]
m = (g(r.sub, p.sub) || keyMatch(r.sub, p.sub)) && keyMatch(r.obj, p.obj) && keyMatch(r.act, p.act)
Создайте файл policy.csv:
p, *, /anything, GET
p, admin, *, *
g, alice, admin
Эта политика разрешает любому субъекту отправлять запрос GET /anything. Она также назначает
роль admin пользователю alice, который может получать доступ к любому пути любым методом.
Хранение общей политики в метаданных плагина
Загрузите файлы как JSON-строки и запишите их в метаданные плагина APISIX:
jq -n \
--rawfile model model.conf \
--rawfile policy policy.csv \
'{model: $model, policy: $policy}' | \
curl --fail-with-body \
"http://127.0.0.1:9180/apisix/admin/plugin_metadata/authz-casbin" \
-H "X-API-KEY: $admin_key" \
-H "Content-Type: application/json" \
-X PUT \
--data-binary @-
Метаданные плагина предоставляют одну модель и политику маршрутам, которые включают
плагин authz-casbin без определения собственной локальной модели и политики для маршрута.
