Пользовательский код и безопасность
Процессный движок предлагает много точек расширения, через которые поведение процессов настраивается с помощью Java-кода, языка выражений, скриптов и шаблонов. Эти точки расширения дают большую гибкость при реализации процессов, но в чужих руках позволяют выполнить вредоносные действия. Поэтому доступ к API, через которые можно передать пользовательский код, рекомендуется давать только доверенным сторонам. Пользовательский код можно передать (через Java API или REST API) такими способами:
-
Развертывание. Большая часть пользовательской логики попадает в движок при развертывании модели процесса или решения. Например, вызов слушателя выполнения задается в XML BPMN 2.0.
-
Запросы. В некоторых параметрах запросов можно использовать выражения (пока только в запросах задач). Так пользователи могут создавать запросы, которые выполняются многократно и подстраиваются под меняющиеся условия. Например, запрос задач
taskService.createTaskQuery().dueBeforeExpression(${now()}).list();с помощью выражения всегда возвращает задачи с наступившим сроком выполнения. Tasklist использует эту возможность в фильтрах задач.
Обращаться к этим точкам доступа следует разрешать только доверенным пользователям. Способы ограничить доступ описаны ниже.
OpenBPM Engine в доверенной среде
Если OpenBPM Engine работает в среде, куда имеют доступ только доверенные стороны (например, благодаря правилам межсетевого экрана), посторонние не доберутся до API для передачи пользовательского кода, и рекомендации ниже можно не применять.
Развертывания
Право выполнять развертывания ограничивается с помощью авторизаций и проверок аутентификации на всех точках доступа, к которым может обратиться недоверенная сторона. Для развертывания нужно разрешение Create на ресурс Deployment. Недоверенным пользователям его выдавать не следует.
Запросы
Доступ к запросам в общем случае нельзя ограничить авторизациями: вместо этого результат запроса сужается до сущностей, к которым у пользователя есть доступ. Поэтому защитить вычисление выражений в запросах с помощью авторизаций нельзя.
В конфигурации процессного движка есть два флага, которые управляют вычислением выражений в разовых (adhoc) и сохраненных (stored) запросах. Разовый запрос отправляется напрямую: например, taskService.createTaskQuery().list(); создает и выполняет разовый запрос. Сохраненный запрос хранится в фильтре и выполняется при выполнении фильтра. Выражения в разовых запросах отключаются свойством enableExpressionsInAdhocQueries со значением false, в сохраненных запросах свойством enableExpressionsInStoredQueries. Если при отключенном вычислении в запросе встречается выражение, процессный движок выбрасывает исключение до вычисления каких-либо выражений, и вредоносный код не выполняется.
Возможные сочетания настроек:
-
enableExpressionsInAdhocQueries=true,enableExpressionsInStoredQueries=true: выражения вычисляются во всех запросах. Подходит, если все пользователи доверенные. -
enableExpressionsInAdhocQueries=false,enableExpressionsInStoredQueries=true: настройка по умолчанию. В разовых запросах выражения запрещены, но фильтры с выражениями создавать и выполнять можно. Создание фильтров ограничивается разрешениемCreateна ресурсFilter. Подходит, если доверенными являются все пользователи, которым разрешено создавать фильтры. -
enableExpressionsInAdhocQueries=false,enableExpressionsInStoredQueries=false: выражения запрещены во всех запросах. Подходит, если не подходят предыдущие варианты.
Документация создана на основе Camunda 7 Docs (Camunda, docs.camunda.org) и распространяется по лицензии Creative Commons Attribution-ShareAlike 3.0 Unported.