Навигатор по разделу:
- 1. Общие сведения
- 2. Область применения и ограничения
- 3. Подготовка к установке
- 4. Установка пакета
- 1. Создайте каталог для пакета и перейдите в него:
- 5. Настройка файла окружения
- 6. Подготовка локальных PostgreSQL и NATS
- 7. Применение конфигурации
- 8. Генерация сертификатов
- 9. Настройка Nginx
- 10. Запуск Avanpost SmartPAM
- 11. Проверка работоспособности
- 12. Установка компонентов сервиса UBA
- 13. Установка в режиме split-node
- 14. Обновление
- 15. Возврат к предыдущей версии
- 16. Типовые проблемы и способы их решения
1. Общие сведения
В данной статье описана установка Avanpost SmartPAM из deb-пакета. Этот способ является альтернативой установке из архива, которая описана в статье "Установка Avanpost SmartPAM из архива".
Пакет содержит файлы дистрибутива, unit-файлы systemd, общий файл окружения и служебную утилиту smartpam-deb-helper. Перед запуском сервисов необходимо заполнить файл /etc/smartpam/smartpam.env. После этого утилита применяет конфигурацию, при необходимости подготавливает локальные PostgreSQL и NATS, генерирует сертификаты, настраивает Nginx и запускает сервисы.
После установки пакета сервисы автоматически не запускаются. Перед первым запуском необходимо задать адреса базы данных и NATS, DNS-имена интерфейсов и параметры сертификатов.
В примерах используются DNS-имена smartpam-admin.avanpost.local и smartpam.avanpost.local. При установке замените их на реальные DNS-имена или IP-адреса, которые будут использоваться администраторами и пользователями
2. Область применения и ограничения
Статья описывает установку одного узла Avanpost SmartPAM из полного deb-пакета. Поддерживаются два сценария установки:
- Сценарий single-node предполагает размещение Avanpost SmartPAM, PostgreSQL и NATS на одном узле.
- Сценарий split-node предполагает установку Avanpost SmartPAM на отдельный узел, при этом PostgreSQL и NATS уже развернуты на других узлах.
Кластерное развертывание в режиме active-active с помощью deb-пакета не описывается. Для кластерной установки используйте установку из архива (см. "Приведение конфигураций сервисов к кластерному режиму" в разделе "Установка Avanpost SmartPAM из архива").
3. Подготовка к установке
Для установки необходим узел под управлением Linux с доступом sudo. Перед началом установки убедитесь, что:
- для сценария single-node доступны локальные PostgreSQL, NATS и Nginx.
- для сценария split-node доступны внешние PostgreSQL и NATS, а параметры подключения к ним известны.
Установите необходимые компоненты:
sudo apt update sudo apt install -y postgresql nats-server nginx openssl ca-certificates
Если PostgreSQL или NATS находятся на отдельных узлах, устанавливать их локально на узел Avanpost SmartPAM не требуется.
4. Установка пакета
1. Создайте каталог для пакета и перейдите в него:
mkdir -p ~/smartpam-deb cd ~/smartpam-deb
2. Поместите в каталог deb-пакет avanpost-pam-full_<номер версии>_amd64.deb.
3. Установите пакет:
PACKAGE=./avanpost-pam-full_<номер версии>_amd64.deb sudo apt install -y "$PACKAGE"
После установки в системе появятся каталог/opt/smartpam, файл/etc/smartpam/smartpam.env, unit-файлы systemd и утилитаsmartpam-deb-helper. Сервисы на этом этапе не запущены.
5. Настройка файла окружения
1. Откройте файл окружения:
sudo nano /etc/smartpam/smartpam.env
2. Задайте параметры установки в соответствии с выбранной топологией и параметрами инфраструктуры:
| Параметр | Описание |
|---|---|
SMARTPAM_INSTALL_MODE | Режим установки. Укажите single-node или split-node |
SMARTPAM_DB_HOST | Адрес PostgreSQL. Для single-node может использоваться localhost. Для split-node укажите адрес внешнего PostgreSQL, доступный с узла Avanpost SmartPAM |
SMARTPAM_DB_PORT | Порт PostgreSQL |
SMARTPAM_DB_NAME | Имя базы данных |
SMARTPAM_DB_USER | Имя пользователя базы данных |
SMARTPAM_DB_PASSWORD | Пароль пользователя базы данных |
SMARTPAM_NATS_URL | Адрес NATS. Для single-node может использоваться nats://localhost:4222. Для split-node укажите адрес внешнего NATS, доступный с узла Avanpost SmartPAM |
SMARTPAM_ADMIN_HOST | DNS-имя административного интерфейса. Используется в параметре server_nameNginx |
SMARTPAM_USER_HOST | DNS-имя пользовательского интерфейса. Используется в параметре server_nameNginx |
SMARTPAM_CERT_HOST | Основное имя узла для генерации сертификатов |
SMARTPAM_GRPC_CERT_DNS / SMARTPAM_GRPC_CERT_IPS | DNS-имена и IP-адреса для сертификата gRPC-сервисов |
SMARTPAM_RDPGW_CERT_DNS / SMARTPAM_RDPGW_CERT_IPS | DNS-имена и IP-адреса для сертификата RDP Gateway |
SMARTPAM_RDP_CERT_DNS / SMARTPAM_RDP_CERT_IPS | DNS-имена и IP-адреса для сертификата RDP |
Пример заполнения файла:
SMARTPAM_INSTALL_MODE=single-node SMARTPAM_DB_HOST=localhost SMARTPAM_DB_PORT=5432 SMARTPAM_DB_NAME=pam SMARTPAM_DB_USER=pam SMARTPAM_DB_PASSWORD=<пароль> SMARTPAM_NATS_URL=nats://localhost:4222 SMARTPAM_ADMIN_HOST=smartpam-admin.avanpost.local SMARTPAM_USER_HOST=smartpam.avanpost.local SMARTPAM_CERT_HOST=smartpam.avanpost.local SMARTPAM_GRPC_CERT_DNS=smartpam-admin.avanpost.local,smartpam.avanpost.local,localhost SMARTPAM_GRPC_CERT_IPS=127.0.0.1 SMARTPAM_RDPGW_CERT_DNS=smartpam.avanpost.local,rdpgw,localhost SMARTPAM_RDPGW_CERT_IPS=127.0.0.1 SMARTPAM_RDP_CERT_DNS=smartpam.avanpost.local,rdp,localhost SMARTPAM_RDP_CERT_IPS=127.0.0.1
Обратите внимание:
- DNS-имена интерфейсов должны совпадать с адресами, по которым администраторы и пользователи будут открывать веб-интерфейсы. Лицензия привязывается к URL-адресу личного кабинета.
- В параметрах
*_CERT_DNSукажите DNS-имена, по которым компоненты Avanpost SmartPAM обращаются к соответствующему сервису. В параметрах*_CERT_IPSукажите IP-адреса, если обращение выполняется по IP. - Если стенд открывается по IP-адресу, добавьте этот IP-адрес в соответствующие параметры
SMARTPAM_*_CERT_IPS.
6. Подготовка локальных PostgreSQL и NATS
Для сценария single-node выполните команду:
sudo smartpam-deb-helper bootstrap-local
Команда создает рольpamи базу данныхpam, если они отсутствуют, включает JetStream в NATS и перезапускает необходимые службы. Существующая база данных не удаляется.
Для сценария split-node команду на узле Avanpost SmartPAM не выполняйте. Внешние PostgreSQL и NATS должны быть подготовлены заранее, а их адреса указаны в файле /etc/smartpam/smartpam.env. Утилита не подключается к удаленным узлам и не настраивает их.
7. Применение конфигурации
Примените значения из файла /etc/smartpam/smartpam.env к конфигурационным файлам сервисов:
sudo smartpam-deb-helper configure
8. Генерация сертификатов
Сгенерируйте сертификаты для работы сервисов:
sudo smartpam-deb-helper certs-generate
Сертификаты и приватные ключи создаются на узле, на котором выполняется установка, в пакет они не включены. Для промышленной эксплуатации рекомендуется использовать сертификаты корпоративного центра сертификации.Если файл окружения был изменен после генерации сертификатов, выполните генерацию повторно с параметром --force:
sudo smartpam-deb-helper certs-generate --force
9. Настройка Nginx
1. Настройте публикацию интерфейсов:
sudo smartpam-deb-helper configure-nginx
Утилита настраивает отдачу статических файлов пользовательского и административного интерфейсов и проксирование запросов/api/к сервисам. DNS-имена интерфейсов берутся из параметровSMARTPAM_ADMIN_HOSTиSMARTPAM_USER_HOST.
2. Если в инфраструктуре отсутствует DNS-служба, добавьте на клиентском АРМ, с которого будет открываться веб-интерфейс, записи в файл hosts:
<IP-адрес сервера> smartpam-admin.avanpost.local
<IP-адрес сервера> smartpam.avanpost.localПосле запуска сервисов интерфейсы будут доступны по адресам http://smartpam-admin.avanpost.local и http://smartpam.avanpost.local.
10. Запуск Avanpost SmartPAM
Запустите сервисы:
sudo smartpam-deb-helper start
Рекомендуется запускать Avanpost SmartPAM именно с помощью утилиты, так как она запускает сервисы в необходимом порядке. Запуск командой systemctl start smartpam.target допустим только после настройки файла окружения, применения конфигурации, генерации сертификатов и настройки Nginx.
11. Проверка работоспособности
Проверьте состояние сервисов:
smartpam-deb-helper status sudo smartpam-deb-helper doctor systemctl --failed systemctl status smartpam.target --no-pager
Командуdoctorнеобходимо выполнять с правами sudo, так как файл/etc/smartpam/smartpam.envзакрыт по правам доступа и может содержать параметры подключения.
Установка выполнена успешно, если smartpam.target активен, среди запущенных сервисов нет сервисов с ошибками, административный и пользовательский интерфейсы открываются через Nginx, а команда doctor не показывает блокирующих ошибок.
12. Установка компонентов сервиса UBA
Сервис UBA входит в состав полного пакета, но Python-окружение в пакет не включено. Перед запуском сервиса UBA подготовьте окружение:
sudo smartpam-deb-helper uba-install sudo systemctl restart uba.service
Подготовка окружения может занять 10-15 минут и требует доступа к репозиториям пакетов.
13. Установка в режиме split-node
В режиме split-node Avanpost SmartPAM устанавливается на отдельный узел, а PostgreSQL и NATS развернуты на других узлах.
1. Подготовьте внешние PostgreSQL и NATS. Утилита smartpam-deb-helper не устанавливает и не настраивает их на удаленных узлах.
2. В файле /etc/smartpam/smartpam.env укажите:
SMARTPAM_INSTALL_MODE=split-node SMARTPAM_DB_HOST=<адрес PostgreSQL> SMARTPAM_DB_PORT=5432 SMARTPAM_NATS_URL=nats://<адрес NATS>:4222
3. Последовательно выполните команды configure, certs-generate, configure-nginx и start (см. разделы 7-10). Команда bootstrap-local в этом сценарии не используется.
14. Обновление
Для обновления установленного пакета используйте команду smartpam-deb-helper upgrade. Не рекомендуется выполнять обновление вручную командой apt install, так как утилита предварительно проверяет окружение и создает резервную копию:
sudo smartpam-deb-helper upgrade ./avanpost-pam-full_<номер новой версии>_amd64.deb
В процессе обновления утилита выполняет следующие действия:
- Проверяет окружение.
- Сохраняет каталог
/etc/smartpam, конфигурацию Nginx, конфигурационные файлы сервисов и каталогassets. - Создает резервную копию базы данных Avanpost SmartPAM с помощью
pg_dump. - При использовании локального NATS сохраняет каталог
/var/lib/nats. - Останавливает
smartpam.target. - Устанавливает новую версию пакета.
- Повторно применяет файл окружения, сертификаты и конфигурацию Nginx.
- Запускает сервисы и выполняет проверку
doctor.
Резервные копии сохраняются в каталоге /var/backups/smartpam. Последняя резервная копия доступна по ссылке /var/backups/smartpam/latest.
Создание резервной копии базы данных обязательно. Если pg_dump или подключение к PostgreSQL недоступны, обновление завершится ошибкой. Без резервной копии базы данных невозможно вернуть систему к предыдущей версии после изменения структуры базы данных при обновлении.
15. Возврат к предыдущей версии
Пакет позволяет вернуть файлы предыдущей версии, но не обеспечивает безопасного возврата базы данных к прежнему состоянию после изменения ее структуры при обновлении. Поэтому возврат к предыдущей версии возможен только при наличии резервной копии, созданной перед обновлением.
Для возврата к предыдущей версии выполните команду:
sudo smartpam-deb-helper rollback \ --package ./avanpost-pam-full_<номер предыдущей версии>_amd64.deb \ --backup /var/backups/smartpam/<идентификатор резервной копии>
В процессе возврата утилита выполняет следующие действия:
- Останавливает
smartpam.target. - Устанавливает предыдущую версию пакета.
- Восстанавливает файл окружения, конфигурацию Nginx, конфигурационные файлы сервисов и каталог
assets. - Восстанавливает базу данных из файла
pam.dump. - При использовании локального NATS восстанавливает каталог
/var/lib/nats. - Повторно применяет конфигурацию и запускает сервисы.
Обратите внимание, что установка предыдущей версии пакета вручную поверх новой будет заблокирована. В сообщении об ошибке будет указано, что необходимо использовать команду smartpam-deb-helper rollback.
В аварийных случаях можно явно разрешить установку предыдущей версии без восстановления базы данных:
SMARTPAM_ALLOW_UNSAFE_DOWNGRADE=1 sudo -E apt install --allow-downgrades ./avanpost-pam-full_<номер предыдущей версии>_amd64.deb
Используйте этот способ только в аварийных ситуациях. Работоспособность Avanpost SmartPAM после такой установки не гарантируется, так как структура базы данных могла быть изменена.
16. Типовые проблемы и способы их решения
- Сервисы не запускаются сразу после установки пакета. Это штатное поведение. Перед первым запуском необходимо настроить файл окружения (см. раздел 4).
- При установке выводится предупреждение apt о пользователе
_aptи локальном файле. Предупреждение не влияет на установку Avanpost SmartPAM. - Nginx возвращает ошибку 404. Проверьте, что DNS-имена интерфейсов указаны в файле
/etc/smartpam/smartpam.env. Затем повторно примените конфигурацию Nginx и перезагрузите его:
sudo smartpam-deb-helper configure-nginx sudo nginx -t sudo systemctl reload nginx
После этого проверьте доступность API:
curl -H "Host: smartpam-admin.avanpost.local" http://localhost/api/v1/live curl -H "Host: smartpam.avanpost.local" http://localhost/api/v1/live
- Веб-интерфейс сообщает об ошибке лицензии
urlMismatch. Проверьте, что интерфейс открывается по адресу, который соответствует лицензии, и что Nginx передает заголовкиHostиX-Forwarded-Hostсервисам. После изменения адресов повторите командуconfigure-nginxи перезагрузите Nginx.