JumpServer PAM 5.2: управление сервисными учётными записями через PAM Agent и SDK
Как автоматизировать смену паролей приложений без нарушения работы сервисов
В JumpServer PAM 5.2 появились новые механизмы интеграции приложений с системой управления привилегированным доступом: PAM Agent, SDK, Socket API и ротация сервисных учётных записей по схеме A/B.
Они позволяют автоматизировать получение и обновление учётных данных, переключение приложений на новые аккаунты и проверку результата. Главное отличие от обычной смены паролей — JumpServer может учитывать, действительно ли приложение начало использовать новые реквизиты.
Это особенно актуально для приложений, подключающихся к базам данных, фоновых служб, интеграций и других систем, которым необходим непрерывный доступ к ресурсам.
1. Какую проблему решает новая функциональность
Представим приложение, которое подключается к PostgreSQL под сервисной учётной записью svc_orders.
При обычной ротации пароля возникает несколько проблем:
-
Пароль в базе данных изменился, но приложение продолжает использовать старый.
-
Для обновления учётных данных требуется изменить конфигурацию и перезапустить сервис.
-
Если несколько экземпляров приложения используют одну УЗ, они могут перейти на новый пароль в разное время.
-
PAM фиксирует успешную смену пароля, но это ещё не означает, что приложение успешно восстановило подключение.
В результате стандартная операция по повышению безопасности может вызвать недоступность приложения.
JumpServer 5.2 предлагает управлять не только сменой пароля, но и процессом его применения.
Обычная ротация и ротация с подтверждением приложения
2. Архитектура интеграции приложений с JumpServer
JumpServer поддерживает три способа подключения приложений к PAM. Они отличаются тем, где выполняется логика получения и применения учётных данных.
Общая архитектура
PAM Agent — интеграция без изменения исходного кода
PAM Agent устанавливается рядом с приложением и получает разрешённые учётные данные из JumpServer.
В зависимости от конфигурации он может:
-
Сохранять учётные данные в защищённых локальных файлах.
-
Обновлять конфигурационные файлы приложений.
-
Выполнять перезагрузку или перезапуск службы.
-
Запускать проверки работоспособности и подтверждать применение новых учётных данных.
-
Предоставлять локальный API для приложений.
Например, Agent может обновить DB_USER и DB_PASSWORD в конфигурации сервиса, перезапустить его и выполнить проверку подключения к БД.
PAM Agent поддерживает Linux, macOS и Windows. Для Linux предусмотрена интеграция с systemd.
SDK — интеграция непосредственно в приложение
SDK позволяет приложению самостоятельно получать учётные данные и реагировать на события JumpServer.
Приложение может получить новые реквизиты, проверить подключение, переключить пул соединений и освободить старые подключения.
В документации описаны SDK для Python, Node.js, Go и Java.
Такой вариант особенно удобен для собственных приложений, в которых разработчики могут реализовать переключение соединений без полного перезапуска сервиса.
Socket API — интеграция через локальный интерфейс
Socket API позволяет приложению взаимодействовать с PAM Agent без встраивания SDK.
Используются HTTP и WebSocket поверх Unix Domain Socket. Приложению не требуется хранить AK/SK JumpServer — взаимодействие с Core обеспечивает Agent.
Через локальный API можно получать учётные данные, отслеживать события, подтверждать переключения и передавать состояние приложения.
Это подходит для интеграции приложений на разных языках программирования и позволяет обновлять PAM Agent независимо от бизнес-приложения.
3. Как работает ротация сервисных УЗ по схеме A/B
Одна из ключевых возможностей JumpServer 5.2 — чередование двух сервисных учётных записей, основной (A) и резервной (B).
Вместо смены пароля аккаунта, который прямо сейчас используется приложением, система сначала подготавливает альтернативную учётную запись и переключает приложение на неё.
Последовательность ротации
-
Подготовка резервной УЗ. JumpServer проверяет возможность подключения с помощью резервной учётной записи. Проверка может быть пропущена, если это предусмотрено политикой.
-
Публикация переключения. JumpServer отправляет событие
credential.switch.published, указывающее целевую учётную запись и ревизию политики. -
Применение новых реквизитов. PAM Agent или SDK получает актуальные учётные данные. Приложение проверяет соединение и переключается на резервную УЗ.
-
Подтверждение результата. JumpServer ожидает результатов от необходимых экземпляров приложения. Простое получение пароля не считается успешным переключением.
-
Смена пароля исходной УЗ. После выполнения условий ожидания, проверки участников и разрешения ошибок система может менять пароль исходного аккаунта.
-
Завершение цикла. После проверки смены пароля ротация получает статус
rotation.completed. При следующем цикле роли аккаунтов могут поменяться обратно.
Таким образом, приложение сначала переходит на другую рабочую учётную запись, а уже затем система меняет пароль исходной.
Это снижает риск нарушения работы приложения при ротации паролей. Однако отсутствие простоя зависит от того, как приложение переключает соединения и требуется ли ему перезапуск.
Что происходит при ошибке
JumpServer предусматривает отдельные состояния ожидания, ошибок и восстановления.
Если проверка резервной УЗ не пройдена, переключение не публикуется. Если приложение не смогло применить новые реквизиты, результат фиксируется как ошибка.
В документации также предусмотрено, что ошибка применения может блокировать следующий этап даже после успешной повторной попытки. Для продолжения требуется решение администратора с указанием причины.
Это защищает от ситуации, когда PAM автоматически продолжает ротацию, не убедившись в готовности приложений.
4. Как PAM Agent обновляет учётные данные приложения
Для существующих сервисов PAM Agent может выполнять весь процесс обновления через конфигурацию, команды управления службой и проверочный скрипт.
Последовательность обработки новых учётных данных
PAM Agent поддерживает несколько способов изменения конфигурации: обновление отдельных полей ENV/YAML, генерацию файлов по шаблонам и выполнение собственных скриптов.
Например, для Linux-сервиса можно настроить следующую последовательность:
{
"name": "sample-app",
"allow_account_switch": true,
"update_on_notification": true,
"accounts": [
{
"id": "<primary-account-id>"
}
],
"update_config": {
"file": "/etc/sample-app/config.yml",
"format": "yaml",
"fields_map": {
"DB_USER": "username",
"DB_PASSWORD": "secret"
}
},
"reload_service": {
"unit": "sample-app.service",
"operation": "restart"
},
"app_check": {
"path": "/usr/local/libexec/jms-pam/check-running-db",
"confirm_on_success": true
}
}
Это фрагмент конфигурации службы из документации. Он предполагает наличие приложения, соответствующего конфигурационного файла и проверочного скрипта.
При обновлении учётных данных Agent изменит параметры, перезапустит службу и запустит проверку. Успешное выполнение app_check с confirm_on_success: true позволяет подтвердить применение реквизитов.
Важный нюанс: без настроенной проверки приложения Agent может завершить локальные действия с результатом skip. Это не равнозначно подтверждению успешного переключения.
5. Как работает интеграция через SDK
В отличие от PAM Agent, SDK позволяет приложению самостоятельно управлять своими подключениями.
Например, Python-приложение может получить сервисную УЗ следующим образом:
from jms_pam import Client
from jms_pam_config import client_options, instance_id
with Client(instance_id=instance_id, **client_options) as client:
account = client.get_account(account_id="<account-id>")
username = account.username
password = account.secret
Для автоматического переключения приложение реализует обработчик on_account_changed.
Обработка смены учётной записи через SDK
SDK берёт на себя взаимодействие с PAM, получение актуальных реквизитов, обработку событий, проверку версий и повторные попытки.
Приложение отвечает за бизнес-логику: проверку реального соединения, переключение и закрытие старых подключений.
Это позволяет реализовать ротацию без полного перезапуска приложения, если его архитектура поддерживает динамическую замену соединений.
Для Python в документации указан SDK 1.0.3 либо установка из совместимых исходников. Отдельно отмечено, что опубликованные пакеты 1.0.2 не содержат всех новых API. Поэтому версии SDK и JumpServer Core должны быть совместимы.
6. Socket API: интеграция без SDK
Третий вариант — использование локального API PAM Agent.
Приложение обращается к Agent через Unix Domain Socket, используя HTTP-запросы и WebSocket для событий.
При подключении приложение получает актуальный снимок состояния (snapshot), затем может запросить реквизиты, применить их и отправить результат.
При этом Agent сохраняет результаты локально и повторяет их отправку в JumpServer при проблемах со связью.
Для независимо работающих экземпляров приложения предусмотрены отдельные идентификаторы сервисов. Это позволяет учитывать результаты переключения разных потребителей учётных данных.
7. Контроль состояния, аудит и восстановление
JumpServer разделяет несколько важных операций:
|
Событие |
Что означает |
|---|---|
|
|
Изменилась версия секрета |
|
|
Опубликовано переключение на другую УЗ |
|
|
Ожидание подтверждений приложений |
|
|
Условия для смены пароля исходной УЗ выполнены |
|
|
Смена пароля исходной УЗ проверена, цикл завершён |
|
|
Ошибка ротации или требуется восстановление |
Кроме того, предусмотрены административные команды для повторного применения опубликованной учётной записи и перезапуска приложения с проверкой его состояния.
Важно различать подтверждение получения события и подтверждение его выполнения. Сообщение received означает только получение события, но не успешное переключение приложения.
Документация также описывает сверку состояния после повторного подключения, работу с локальными сохранёнными реквизитами при отдельных сетевых сбоях и обработку отзыва доступа.
Таким образом, JumpServer получает возможность контролировать процесс ротации на уровне подключённых приложений, а не только на уровне целевых учётных записей.
8. Практические сценарии использования
Сервис, подключающийся к базе данных. Вместо ручного изменения пароля в конфигурации можно использовать PAM Agent для обновления реквизитов, перезапуска службы и проверки соединения.
Микросервисы и приложения с несколькими репликами. SDK или Socket API позволяют каждому экземпляру получить новые реквизиты, переключить подключения и сообщить собственный результат. Ротация учитывает подтверждения необходимых участников.
Критичные приложения, работающие круглосуточно. A/B-ротация позволяет подготовить резервную учётную запись и перевести на неё приложение до смены пароля исходной. При поддержке динамического переключения это помогает избежать перезапуска приложения.
Существующие корпоративные приложения. PAM Agent позволяет интегрировать приложения через конфигурационные файлы, шаблоны и скрипты, не встраивая SDK в исходный код.
9. Какой способ интеграции выбрать
|
Способ |
Когда использовать |
|---|---|
|
PAM Agent |
Существующие приложения, конфигурационные файлы, службы systemd, скрипты |
|
SDK |
Собственная разработка, прямое управление соединениями и пулами |
|
Socket API |
Интеграция без SDK, локальный доступ к Agent, независимое обновление Agent |
Все три варианта решают общую задачу — доставить актуальные учётные данные и обеспечить их применение.
При этом автоматическое переключение A/B не включается только за счёт установки Agent или SDK. Для него требуется отдельная политика ротации, разрешение обеих учётных записей приложению и настройка обработки переключений.
10. Что необходимо учитывать при внедрении
Перед использованием механизма в продуктивной среде рекомендуется проверить:
-
Поддерживает ли приложение изменение учётных данных без остановки обслуживания.
-
Корректно ли закрываются старые соединения после переключения.
-
Как ведут себя все реплики приложения при обновлении реквизитов.
-
Что происходит при ошибке проверки резервной УЗ или недоступности JumpServer.
-
Настроено ли подтверждение именно успешного применения учётных данных, а не только их получения.
-
Как выполняются восстановление и ручное вмешательство при неуспешной ротации.
Отдельное внимание следует уделить правам доступа к локальным файлам секретов, Unix Socket и конфигурациям приложений.
Заключение
Новые возможности JumpServer PAM 5.2 расширяют классическую автоматизацию смены паролей до управления жизненным циклом сервисных учётных данных.
PAM Agent, SDK и Socket API позволяют интегрировать приложения с PAM, а A/B-ротация — организовать переключение между учётными записями до смены пароля исходной.
Основные преимущества:
-
Снижение риска простоя приложений при смене паролей.
-
Автоматизация обновления конфигураций и подключений.
-
Контроль применения новых реквизитов.
-
Централизованное управление доступом сервисных приложений.
-
Аудит результатов и возможность управляемого восстановления при ошибках.
Это особенно полезно для организаций с большим количеством сервисных учётных записей, микросервисов и критичных интеграций, где ручная смена паролей становится сложной и рискованной операцией.





