- 1 Общая информация
- 2 Установка и настройка СУБД
- 2.1 Microsoft SQL Server
- 2.2 PostgreSQL
- 3 Установка и настройка RabbitMQ
- 4 Установка Microsoft .Net6
- 5 Установка КрипоПро CSP
- 6 Установка Microsoft Visual C++ Redistributable
- 7 Установка Wkhtmltopdf
- 8 Установка основных серверных компонент Avanpost PKI
Общая информация
В данном разделе приводится инструкция по установке серверной части Avanpost PKI. Предполагается, что перед началом установки системы подготовлено:
- Физический или виртуальный сервер, отвечающий системным требованиям Avanpost PKI необходимой конфигурации;
- Операционная система Windows Server, версия которой соответствует системным требованиям Avanpost PKI;
- Учетная запись, обладающая правами локального администратора на подготовленном сервере;
- Доменная технологическая учетная запись для работы Avanpost PKI с доменом MS Active Directory (в случае использования домена MS Active Directory в качестве домена аутентификации). С правами Domain Users;
Установка и настройка СУБД
Microsoft SQL Server
- Скачать и установить MS SQL Server
- При установке выбрать кодировку сервера - "Cyrillic_General_CI_AS" (для поддержки русскоязычных символов и для case-insensitive сравнения строк в запросах)
- Настроить SQL Server после развертывания:
- включить "SQL Server and Windows authentication mode" для инстанса сервера
- включить учетную запись "sa" и задать ей стандартный пароль "Avanp0st"
- Зайти в "SQL Server Configuration Manager", далее в "Сетевая конфигурация SQL Server", далее "Протоколы для MSSQLSERVER". Найти в списке "TCP/IP" и включить
- Поставить Management tool, например, ms sql management studio.
PostgreSQL
- Скачать дистрибутив PostgreSQL для Windows версию не ниже 15
- Далее нужно следовать шагам wizard установщика
- Поставить management tool на, например, pgAdmin
Установка и настройка RabbitMQ
- Скачать и установить Erlang и RabbitMQ последней версии.
- Перейти в папку установки RabbitMQ (например, C:\Rabbitmq\rabbitmq_server-3.10.5\sbin) и запустить для нее консоль (cmd)
- Проверить корректность установки RabbitMQ командой ниже (ошибки должны отсутствовать)
rabbitmqctl status
- Для возможности конфигурирования RabbitMQ, нужно включить management plugin командой
rabbitmq-plugins enable rabbitmq_management
- Настроить RabbitMQ
- Перейти на страницу администрирования RabbitMQ http://localhost:15672/
- Зайти под пользователем "guest" и паролем "guest"
- Создать пользователя "admin" и задать пароль
- Создать virtual host с новым именем, например, "pki7"
- Перейти в созданный ранее virtual host и нажать set permition для пользователя "admin"
Установка Microsoft .Net6
Скачать и установить с официального сайта Microsoft и установить sdk .net6
Установка КрипоПро CSP
- Скачать с официального сайта и установить КриптоПро CSP 5.0 R3 (CryptoPro-5.0.13003)
- Ввести лицензию
- Если будет использоваться генерация на сервере ключевой пары надо строить ДСЧ "КриптоПро исходный материал" (External Gamma - набор случайных данных, необходимых для генерирования закрытых ключей).
Установка Microsoft Visual C++ Redistributable
Для работы серверных компонент Avanpost PKI необходимо установить Microsoft Visual C++ Redistributable 2015-2022 x86 и x64. Скачать можно с официльного сайта microsoft.
Установка Wkhtmltopdf
Для формирования печатных форм в Avanpost PKI необходимо установить Wkhtmltopdf именно 0.12.5 версию. Скачать её можно с официального сайта ПО или репозитория из github.
Установка основных серверных компонент Avanpost PKI
Подготовка к установке
- Создать папку для компонентов PKI, например, C:\AP
- Подготовить PFX файлы для:
- Шифрования ПИН-кодов. Для того, что Avanpost PKI мог защитить ПИН-коды и иную критичную информацию перед ее размещением в базе данных. Avanpost PKI поддерживает как RSA, так и ГОСТ-сертификаты.
- Проверки подписи JWT-токена. Проверки подписи JWT-токена необходимы для того, что Avanpost PKI мог обеспечить внутренние технологические нужды в части аутентификации методов WEB API. Avanpost PKI поддерживает только RSA-сертификаты проверки подписи JWT-токена.
Установка Avanpost PKI Server
- Распакуйте содержимое zip-архива Avanpost.PKI.Server.v7.x.y.zip в папку C:\AP\AvanpostPKIServer.
- Скопируйте файл лицензии Avanpost.Pki.plic в папку C:\AP\Avanpost PKI Server.
- Отредактируйте основной конфигурационный файл службы Avanpost PKI Server - appsettings.json
- Секция <ConnectionStrings> отвечает за настройку подключения к базе данных. Отредактируйте параметры - "ConnectionString, DatabaseProvider, Password" в соответсвии с СУБД и параметрами подключения.
- А так же отредактируете остальные параметры:
- Выполните первоначальную инициализацию и развертывание базы данных Avanpost PKI. Для этого запустите командную строку от имени администратора, перейдите в директорию Avanpost PKI Server и выполните команду:
dotnet Avanpost.Pki.Server.dll migrations dbinit
- Для наполнения БД первичными данными выполните команду:
dotnet Avanpost.Pki.Server.dll migrations fill
- Для создания технологического (системного) пользователя выполните команду:Вместо "administrator" нужно указать логин системного пользователя PKI
dotnet Avanpost.Pki.Server.dll migrations addsystemuser -login administrator
- Выполните установку службы Avanpost PKI Server в оснастку служб ОС Windows.
dotnet Avanpost.Pki.Server.dll service install
- Отредактируйте конфигурационный файл подсистемы логирования службы Avanpost PKI Server - NLog.config - раскомментируйте строку:
<variable name="basedir" value="C:\AP\AvanpostLogs"/>
Установка Avanpost PKI Web
- Распакуйте содержимое zip-архива Avanpost.PKI.Web.v7.x.y.zip в папку C:\AP\AvanpostPKIWeb.
- Отредактируйте основной конфигурационный файл службы Avanpost PKI Web- appsettings.json
- Секция <ConnectionStrings> отвечает за настройку подключения к базе данных. Отредактируйте параметры - "ConnectionString, DatabaseProvider, Password" в соответсвии с СУБД и параметрами подключения.
- А так же отредактируете остальные параметры:
- Откройте cmd от имени администратора и перейдите в папку веб приложения командой cd.
- Выполните cli-комманду для создания службы веб приложения:
dotnet Avanpost.Pki.Web.dll service install
- Запустите службу Avanpost.Pki.Web. Если все настроено корректно то по адресу http://localhost:5000 откроется страница логина в PKI.
- Для изменения ip адреса и порта нужно остановить службу и изменить службу коммандой sc, пример:
sc config Avanpost.Pki.Web_7 binPath="C:\Program Files\dotnet\dotnet.exe C:\AP\Avanpost.Pki.Web\Avanpost.Pki.Web.dll --urls http://localhost:5555"
Установка Avanpost PKI ExternalApi
- Распакуйте содержимое zip-архива Avanpost.PKI.Web.ExternalRestApi.v7.x.y.zip в папку C:\AP\AvanpostPKIWebExternalRestApi
- Отредактируйте основной конфигурационный файл службы Avanpost PKI Web External Rest Api - appsettings.json
- Секция <ConnectionStrings> отвечает за настройку подключения к базе данных. Отредактируйте параметры - "ConnectionString, DatabaseProvider, Password" в соответсвии с СУБД и параметрами подключения.
- А так же отредактируете остальные параметры:
- Откройте cmd от имени администратора и перейдите в папку внешнего api командой cd.
- Выполните cli-комманду для создания службы внешнего api:
dotnet Avanpost.Pki.Web.ExternalRestApi.dll service install
- Запустите службу Avanpost.Pki.Web.ExternalRestApi 7. Если все настроено корректно то по адресу http://localhost:5000/swagger откроется страница внешнего api.
- Для изменения ip адреса и порта нужно остановить службу и изменить службу коммандой sc, пример:
sc config Avanpost.Pki.Web.ExternalRestApi_7 binPath="C:\Program Files\dotnet\dotnet.exe C:\AP\AvanpostPKIWebExternalRestApi\Avanpost.Pki.Web.ExternalRestApi.dll --urls http://localhost::5004"
Установка Avanpost PKI Siem Log Service
- Распакуйте содержимое zip-архива Avanpost.PKI.Siem.LogService.v7.x.y.zip в папку C:\AP\AvanpostPKISiemLogService
- Отредактируйте основной конфигурационный файл службы Avanpost PKI Siem Log Service - appsettings.json
- Секция <ConnectionStrings> отвечает за настройку подключения к базе данных. Отредактируйте параметры - "ConnectionString, DatabaseProvider, Password" в соответсвии с СУБД и параметрами подключения.
- А так же отредактируете остальные параметры:
- Откройте cmd от имени администратора и перейдите в папку службы логирования командой cd.
- Выполните комманду в cmd, запустив от имени администратора, для создания службы логирования (необходимо проверить путь к библиотеке, он может отличаться от вашего):
sc create Avanpost_PKI_LogService_7_2 DisplayName="Avanpost PKI LogService 7 2" binPath="C:\Program Files\dotnet\dotnet.exe C:\AP\AvanpostPKISiemLogService\Avanpost.Pki.Siem.LogService.dll" start=auto