Установка Мониторинга — онлайн, собственные сертификаты

Цель

Установить Мониторинг на сервер с выходом в интернет, импортировав собственные SSL-сертификаты вместо автоматически генерируемых системой.

Предусловия

• Выполнены условия из страницы «Установка Мониторинга — онлайн, автоматические сертификаты».
• Подготовлены собственные сертификаты согласно странице «Требования к сертификатам безопасности».
• Файлы сертификатов размещены на сервере (полный путь известен либо запуск выполняется из директории с сертификатами).

Что потребуется

• <client.crt> — файл сертификата сервера.
• <client.key> — ключ к сертификату сервера.
• <ca.crt> — CA-сертификат (корневой).
• IP-адрес или хостнейм сервера.
• (Опционально) пароль суперпользователя — минимум 6 символов, 2 буквы.

Шаги установки

Шаг 1. Подключиться к серверу по SSH

ssh username@ip_address

Где username —логин пользователя на сервере, а ip_address — адрес удаленного сервера.

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

Шаг 2. (Опционально) Задать пароль суперпользователя

export MON_ADMIN_PASSWORD=<пароль>

Шаг 3. Запустить установку

С адресацией по IP-адресу:

sudo curl -L https://s3.printum.io/box/monitoring/install.sh | sudo -E IP_ADDRESS=<ip> SSL_CERT=<client.crt> SSL_KEY=<client.key> SSL_CERT_CA=<ca.crt> bash -s agent

С адресацией по доменному имени:

sudo curl -L https://s3.printum.io/box/monitoring/install.sh | sudo -E MON_HOSTNAME=<hostname> SSL_CERT=<client.crt> SSL_KEY=<client.key> SSL_CERT_CA=<ca.crt> bash -s agent

В переменных SSL_CERT, SSL_KEY, SSL_CERT_CA допускается указывать как полный путь к файлу, так и только имя файла (если установка запускается из директории с сертификатами).

Ожидаемый результат

• Установка завершается без ошибок.
• HTTPS-соединения с сервером используют переданные собственные сертификаты.
• В выводе указаны URL Панели администратора Мониторинга и URL Личного кабинета.

Как проверить установку

• Открыть в браузере URL Личного кабинета — браузер должен принять сертификат без предупреждений (если CA доверенный).
• Авторизоваться (логин printum, пароль printum или заданный MON_ADMIN_PASSWORD).
• В деталях сертификата в браузере убедиться, что издатель и subject соответствуют переданным файлам.

Типовые ошибки

• Файлы сертификатов не найдены — проверить пути и права доступа к файлам, повторить установку с полными путями.
• Браузер не принимает сертификат — проверить, что CA-сертификат добавлен в доверенные на клиентских машинах.
• Несовпадение FQDN/IP — сертификат должен содержать атрибут Subject Alternative Name с FQDN и IP-адресами, см. «Требования к сертификатам безопасности».

Что проверить перед эскалацией

• Содержимое и атрибуты сертификатов (X509v3 extensions, SAN).
• Версия и редакция ОС.
• IP-адрес или хостнейм, указанные в команде.
• Сетевой доступ к s3.printum.io.
• Полный вывод установочного скрипта.

Что важно помнить

• По окончании срока действия сертификата его потребуется заменить — см. раздел «Обновление сертификатов» в Руководстве администратора.

Следующие шаги

• Завершение установки Мониторинга — первый вход и проверка
• Установка ПринтМенеджера

Связанные страницы

• Требования к сертификатам безопасности
• Установка Мониторинга — онлайн, автоматические сертификаты
• Установка Мониторинга — офлайн, собственные сертификаты
• Завершение установки Мониторинга — первый вход и проверка