Пользовательский код и безопасность

Процессный движок предлагает много точек расширения, через которые поведение процессов настраивается с помощью 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.