Перейти к основному контенту

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 предлагает управлять не только сменой пароля, но и процессом его применения.

Обычная ротация и ротация с подтверждением приложения

изображение.png

2. Архитектура интеграции приложений с JumpServer

JumpServer поддерживает три способа подключения приложений к PAM. Они отличаются тем, где выполняется логика получения и применения учётных данных.

Общая архитектура

изображение.png

Socket API работает через локальный PAM Agent, а SDK подключается к JumpServer Core напрямую.

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).

Вместо смены пароля аккаунта, который прямо сейчас используется приложением, система сначала подготавливает альтернативную учётную запись и переключает приложение на неё.

изображение.png

Последовательность ротации

  1. Подготовка резервной УЗ. JumpServer проверяет возможность подключения с помощью резервной учётной записи. Проверка может быть пропущена, если это предусмотрено политикой.

  2. Публикация переключения. JumpServer отправляет событие credential.switch.published, указывающее целевую учётную запись и ревизию политики.

  3. Применение новых реквизитов. PAM Agent или SDK получает актуальные учётные данные. Приложение проверяет соединение и переключается на резервную УЗ.

  4. Подтверждение результата. JumpServer ожидает результатов от необходимых экземпляров приложения. Простое получение пароля не считается успешным переключением.

  5. Смена пароля исходной УЗ. После выполнения условий ожидания, проверки участников и разрешения ошибок система может менять пароль исходного аккаунта.

  6. Завершение цикла. После проверки смены пароля ротация получает статус rotation.completed. При следующем цикле роли аккаунтов могут поменяться обратно.

Таким образом, приложение сначала переходит на другую рабочую учётную запись, а уже затем система меняет пароль исходной.

Это снижает риск нарушения работы приложения при ротации паролей. Однако отсутствие простоя зависит от того, как приложение переключает соединения и требуется ли ему перезапуск.

Что происходит при ошибке

JumpServer предусматривает отдельные состояния ожидания, ошибок и восстановления.

Если проверка резервной УЗ не пройдена, переключение не публикуется. Если приложение не смогло применить новые реквизиты, результат фиксируется как ошибка.

В документации также предусмотрено, что ошибка применения может блокировать следующий этап даже после успешной повторной попытки. Для продолжения требуется решение администратора с указанием причины.

Это защищает от ситуации, когда PAM автоматически продолжает ротацию, не убедившись в готовности приложений.

4. Как PAM Agent обновляет учётные данные приложения

Для существующих сервисов PAM Agent может выполнять весь процесс обновления через конфигурацию, команды управления службой и проверочный скрипт.

Последовательность обработки новых учётных данных

изображение.png

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

изображение.png

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 для событий.

изображение.png

При подключении приложение получает актуальный снимок состояния (snapshot), затем может запросить реквизиты, применить их и отправить результат.

При этом Agent сохраняет результаты локально и повторяет их отправку в JumpServer при проблемах со связью.

Для независимо работающих экземпляров приложения предусмотрены отдельные идентификаторы сервисов. Это позволяет учитывать результаты переключения разных потребителей учётных данных.

7. Контроль состояния, аудит и восстановление

JumpServer разделяет несколько важных операций:

Событие

Что означает

credential.secret.updated

Изменилась версия секрета

credential.switch.published

Опубликовано переключение на другую УЗ

rotation.waiting_for_app

Ожидание подтверждений приложений

rotation.source.ready

Условия для смены пароля исходной УЗ выполнены

rotation.completed

Смена пароля исходной УЗ проверена, цикл завершён

rotation.failed

Ошибка ротации или требуется восстановление

Кроме того, предусмотрены административные команды для повторного применения опубликованной учётной записи и перезапуска приложения с проверкой его состояния.

Важно различать подтверждение получения события и подтверждение его выполнения. Сообщение 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-ротация — организовать переключение между учётными записями до смены пароля исходной.

Основные преимущества:

  • Снижение риска простоя приложений при смене паролей.

  • Автоматизация обновления конфигураций и подключений.

  • Контроль применения новых реквизитов.

  • Централизованное управление доступом сервисных приложений.

  • Аудит результатов и возможность управляемого восстановления при ошибках.

Это особенно полезно для организаций с большим количеством сервисных учётных записей, микросервисов и критичных интеграций, где ручная смена паролей становится сложной и рискованной операцией.