Polkit и интерактивная авторизация
Разделение аутентификации и разрешения операции
PAM отвечает за вход в веб-интерфейс. Polkit отвечает за разрешение конкретного backend-действия. Для прямого Unix-клиента вместо PAM-входа используется идентичность процесса.
root допускается к корректно сформированным запросам без проверки Polkit. Для остальных действует отказ при отсутствии разрешающей зарегистрированной политики. Если первоначальная инициализация D-Bus/Polkit не удалась, это состояние кэшируется: восстановление сервиса само по себе не повторяет инициализацию Altera; нужен перезапуск Altera.
Как формируется действие
org.altlinux.altera.<backend>.<module>.<action>
org.altlinux.altera.<backend>.<module>.<action>.<objects>
Второй вариант используется, когда _objects отличается от /.
Например:
{"action":"write","_objects":"password"}
для /backend3/root соответствует кандидатам:
org.altlinux.altera.backend3.root.write
org.altlinux.altera.backend3.root.write.password
Сервер рассматривает только зарегистрированные в Polkit action ID. Достаточно разрешения одного подходящего ID. Общее разрешение ...write поэтому нельзя использовать одновременно с ожиданием, что более узкая политика ...write.password обязательно его ограничит: в текущей реализации разрешённое общее действие уже достаточно.
Список action ID загружается при создании контекста модуля. После установки новых политик следует открыть новую сессию модуля; для очевидного и воспроизводимого результата — новое клиентское соединение.
Неинтерактивная проверка
Клиент отправляет обычный запрос. Возможные результаты:
| Результат | Поведение |
|---|---|
Allow | Запрос допускается к отправке backend |
Deny | {"type":"woo-error","code":"denied","message":"authorization denied"} |
Challenge | {"auth_needed":true,"query":<исходный запрос>} |
| Ошибка проверки | Объект с type, code, message; запрос не отправляется backend |
В таблице показаны тела ответов. В Unix-соединении и на веб-маршруте /ws они обёрнуты путём модуля, на фиксированном веб-маршруте передаются без обёртки.
Возврат query не означает, что сервер сохранил отложенное действие. При дальнейшем подтверждении клиент снова передаёт запрос, и политики определяются заново.
Интерактивный обмен
Для определённости далее показан фиксированный маршрут /backend3/services.
Для любого действия, для которого Polkit разрешает Challenge, чтобы запустить диалог интерактивной авторизации действия, клиент должен отправить:
{
"authenticate": true,
"query": {
"action": "write",
"name": "example.service",
"change_status": "restart",
"chkconfig_status": "#t"
}
}
Внешний объект содержит только authenticate и query. Пробный обычный запрос перед этим не обязателен.
Сервер сообщает доступные для подтверждения identities:
{
"type": "auth_identities",
"policy_id": "org.altlinux.altera.backend3.services.write",
"message": "Administrator authentication is required.",
"prompt_id": 1,
"identities": [{"uid": 0, "login": "root"}]
}
Ответ клиента:
{"auth":{"action":"select","prompt_id":1,"uid":0}}
Затем сервер может задать вопрос:
{"type":"auth_prompt","prompt_id":2,"message":"Password:","echo":false}
Клиент отвечает:
{"auth":{"action":"respond","prompt_id":2,"response":"введённое значение"}}
Это иллюстрация формы сообщений. Реальные UID, prompt_id, тексты и количество вопросов нужно брать из событий сервера, а не фиксировать в интерфейсе. auth_info и auth_error передают сообщения диалога, а не обязательно окончательный результат backend-операции.
До получения одобрения на действие, процесс авторизации можно отменить:
{"auth":{"action":"cancel"}}
При успешной авторизации сервер передаёт вложенный query модулю бекенда. Клиент не должен ещё раз автоматически отправлять этот запрос после успешного диалога. При отказе или отмене запрос модулю бекенда не передаётся.
Время жизни диалога
Ответы на вопросы идут в том же соединении и для того же модуля. Пока ожидается ответ пользователя, не нужно посылать этому модулю посторонние запросы: обработчик диалога принимает ответы/отмену и отвергает другие формы.
Неинтерактивная проверка ограничена 10 секундами, интерактивная — 120 секундами. Точный эффект ошибки нужно обрабатывать как отказ текущей попытки; WebSocket от этого не закрывается.
Выбор администратора в диалоге Polkit не меняет UID пользовательского CLI и не создаёт новую root-сессию. Разрешение относится к операции и политикам Polkit, а не к смене пользователя всего веб-подключения.