Руководство администратора по установке веб-портала 1С:ITILIUM (NextJS)

Компоненты для установки

Развернутая система 1С:ITILIUM

Требования к системе 1С:ITILIUM:

•  версия не ниже 1.0.1.8;
•  действующий ключ активации внешних интеграций; 
•  информационная база в серверном варианте (для проверки и тестирования допускается и файловый вариант);
•  кластер серверов может быть как на Windows, так и на Linux.

Установка Docker Compose 

Скачайте актуальную версию Docker Compose с официального GitHub-репозитория.

Важно! В данной инструкции используются команды для Docker Compose V2 и выше. Если на вашем сервере установлена Docker Compose версии V1, необходимо использовать команды с дефисом:

Например: docker-compose up –d.

Установка портала на Next.js

1. Скачивание дистрибутива:

Загрузите архив с файлами поставки.
В архиве содержатся следующие файлы:

• .env – файл конфигурации переменных окружения
• docker-compose.yml – конфигурация Docker-контейнеров
• itil-webportal-image-1.0.tar – образ docker контейнера
• UpdateVRD.exe – утилита для редактирования параметров публикации 1С

2. Опубликуйте HTTP сервис системы 1С:ITILIUM (API портала).

• Публикация должна быть доступна для Docker-контейнера (проверьте сетевые настройки).
• Запомните адрес публикации – он понадобится для настройки .env.

2.1. Поместить файл .env и утилиту UpdateVRD.exe.  для изменения файла публикации 1С в каталог публикации C:\inetpub\wwwroot\Имя публикации.

2.2  Необходимо настроить переменные окружения в файле .env.  

Генерация секретного ключа

• Перейдите на страницу: https://generate-secret.vercel.app/32
• Скопируйте сгенерированный ключ
• В файле .env укажите его в переменной: NEXTAUTH_SECRET=ваш_сгенерированный_ключ_из_ссылки

Важно! Этот ключ используется для защиты сессий и токенов.

Укажите адрес публикации HTTP-сервиса 1C:ITILIUM в переменной SERVER_1C. 

Например: SERVER_1C=http://<АдресСервера>/<ИмяПубликации>/hs/web-portal-api.

Важно! Адрес сервера должен быть указан по IP. Не указывайте доменное имя сервера. 

2.3  Запустить утилиту UpdateVRD.exe, которая автоматически настроит работу через токены доступа.

Важно! Если был изменен секретный ключ, в переменной NEXTAUTH_SECRET, необходимо повторить п.2.3 с запуском  утилиты UpdateVRD.exe. 

3. Настройка пользователей в 1С:ITILIUM. 

Для каждого пользователя веб-портала:

• Откройте карточку пользователя  информационной базы в 1С:ITILIUM
• Включите флаг: «Аутентификация токеном доступа»
• Укажите действующий email пользователя

Сделать это массово для всех пользователей можно при загрузке данных из AD, установив в дополнительных параметрах загрузки флаг «Авторизация токеном доступа» и указав соответствие для поля «Адрес электронной почты» в карточке пользователя информационной базы.

Настройка и запуск Docker-контейнеров

4.1 Подготовка файлов:

1. Распакуйте архив с файлами веб-портала на сервере с установленным Docker Compose

2. Убедитесь, что в распакованной папке присутствуют:

•  .env - файл конфигурации
• docker-compose.yml - файл настройки контейнеров
•  itil-webportal-image-1.0.tar – образ docker контейнера с порталом

4.2 Настройка переменных окружения

Отредактируйте файл .env, указав следующие параметры:

1. NEXTAUTH_SECRET
Укажите секретный ключ, сгенерированный ранее (п. 2.2 инструкции)
Пример: NEXTAUTH_SECRET=ваш_секретный_ключ_из_пункта_2.2

2. NEXTAUTH_URL
Введите URL сервера, где будет работать портал
Пример: NEXTAUTH_URL=http://192.168.0.100:3000

*Примечание: По умолчанию используется порт 3000. Для изменения порта отредактируйте файл docker-compose.yml*

3. SERVER_1C
Укажите адрес опубликованного HTTP-сервиса 1С
SERVER_1C=http://<IP_адрес>/<Имя_публикации>/hs/web-portal-api
Пример: SERVER_1C=http://192.168.1.50/ITILIUM_API/hs/web-portal-api

4. ADMIN_EMAILS
Перечислите через запятую email-адреса администраторов портала
Пример: ADMIN_EMAILS=admin1@company.com,admin2@company.com

Важно! Указанные email должны совпадать с email в карточках пользователей 1С:ITILIUM.

4.3 Запуск контейнеров

1. Загрузите скаченный docker образ портала командой:
docker load -i itil-webportal-image-1.0.tar

2. Откройте терминал в папке с файлами (.env и docker-compose.yml)

3. Выполните команду:
docker compose up -d

После выполнения:

• Будут запущены 2 контейнера: основной и Redis
• Контейнеры автоматически запускаются при перезагрузке сервера

4.4 Проверка работы

1. Откройте в браузере адрес, указанный в NEXTAUTH_URL

2. Убедитесь, что:

• Портал доступен
• Возможен вход под учетными данными администратора

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

• Перейдите в раздел «Настройки» портала.
• Введите адрес электронной почты технического пользователя.
• Нажмите кнопку «Проверить пользователя».
• Сохраните установленные настройки.