Подготовка и запуск компонентов службы идентификации пользователей на устройстве

Вам необходимо добавить файлы (сертификаты и конфигурацию) для каждого компонента в соответствующую отдельную директорию. После этого вы можете загрузить контейнеры компонентов в Docker и запустить их с помощью инструмента Docker Compose. Подробнее об инструменте см. в официальной документации Docker Compose.

Docker-контейнеры компонентов службы идентификации пользователей включены в комплект поставки Kaspersky NGFW.

Чтобы запустить компоненты службы идентификации пользователей:

1. Установите Docker и Docker Compose:

   apt install -y docker.io docker-compose-v2

2. Создайте директории для хранения файлов конфигурации и сертификатов для компонентов службы идентификации пользователей:

   mkdir -p /var/lib/uaws/collector/ssl

   mkdir -p /var/lib/uaws/mapapp/ssl

   mkdir -p /var/lib/uaws/groupapp/ssl

3. Подготовьте необходимые файлы конфигурации:
   • Для компонента Collector: переместите файл collector_config.yml в директорию /var/lib/uaws/collector.
   • Для компонента MapApp: переместите файл mapapp_config.yml в директорию /var/lib/uaws/mapapp.
   • Для компонента GroupApp: переместите файл groupapp_config.yml в директорию /var/lib/uaws/groupapp.
4. Поместите созданные ранее сертификаты в соответствующие директории компонентов:
   • Для компонента Collector: скопируйте корневой сертификат ca.p12 и пользовательский сертификат uaws.p12 в директорию /var/lib/uaws/collector/ssl.
   • Для компонента MapApp: скопируйте корневой сертификат ca.p12 и пользовательский сертификат uaws.p12 в директорию /var/lib/uaws/mapapp/ssl.
   • Для компонента GroupApp: скопируйте корневой сертификат ca.p12 и пользовательский сертификат uaws.p12 в директорию /var/lib/uaws/groupapp/ssl.
5. Загрузите контейнеры компонентов службы идентификации пользователей в Docker из архивов, которые входят в комплект поставки Kaspersky NGFW:
   • Для компонента Collector выполните следующую команду:

     sudo docker load -i <путь к архиву>/collector-<версия>.cis.amd64_en-US_ru-RU.tgz

   • Для компонента MapApp выполните следующую команду:

     sudo docker load -i <путь к архиву>/mapapp-<версия>.cis.amd64_en-US_ru-RU.tgz

   • Для компонента GroupApp выполните следующую команду:

     sudo docker load -i <путь к архиву>/groupsapp-<версия>.cis.amd64_en-US_ru-RU.tgz

6. В директории /var/lib/uaws/ создайте файл docker-compose.yml и скопируйте в него конфигурацию для запуска компонентов, подставив необходимые значения.

   Содержимое файла docker-compose.yml

   version: "3.8"

   services:

   mapapp:

   image: "uaws-mapapp-<версия>.cis.amd64_en-US_ru-RU"

   logging:

   driver: "local"

   options:

   max-size: "1g"

   max-file: "10"

   hostname: "<FQDN компонента MapApp>"

   ports:

   - "8443:8443"

   environment:

   TZ: "Europe/Moscow"

   USERMAP_CONFIG: "/uaws/mapapp-config.yml"

   USERMAP_KEY_STORE: "/uaws/ssl/mapapp.p12"

   USERMAP_KEY_STORE_PASS: "<пароль>"

   USERMAP_TRUST_STORE: "/uaws/ssl/ca.p12"

   USERMAP_TRUST_STORE_PASS: "<пароль>"

   sysctls:

   - net.ipv6.conf.all.disable_ipv6=1

   volumes:

   - "/var/lib/uaws/mapapp:/uaws/"

   collector:

   image: "uaws-collector-<версия>.cis.amd64_en-US_ru-RU"

   logging:

   driver: "local"

   options:

   max-size: "1g"

   max-file: "10"

   hostname: "<FQDN компонента Collector>"

   environment:

   TZ: "Europe/Moscow"

   AGENT_CONFIG: "/uaws/collector-config.yml"

   AGENT_KEY_STORE: "/uaws/ssl/collector.p12"

   AGENT_KEY_STORE_PASS: "<пароль>"

   AGENT_TRUST_STORE: "/uaws/ssl/ca.p12"

   AGENT_TRUST_STORE_PASS: "<пароль>"

   sysctls:

   - net.ipv6.conf.all.disable_ipv6=1

   volumes:

   - "/var/lib/uaws/collector:/uaws/"

   groupapp:

   image: "uaws-groupsapp-<версия>.cis.amd64_en-US_ru-RU"

   logging:

   driver: "local"

   options:

   max-size: "1g"

   max-file: "10"

   hostname: "<FQDN компонента GroupApp>"

   ports:

   - "8444:8443"

   environment:

   TZ: "Europe/Moscow"

   GROUPAPP_CONFIG: "/uaws/groupapp-config.yml"

   GROUPAPP_KEY_STORE: "/uaws/ssl/groupapp.p12"

   GROUPAPP_KEY_STORE_PASS: "<пароль>"

   GROUPAPP_TRUST_STORE: "/uaws/ssl/ca.p12"

   GROUPAPP_TRUST_STORE_PASS: "<пароль>"

   sysctls:

   - net.ipv6.conf.all.disable_ipv6=1

   volumes:

   - "/var/lib/uaws/groupapp:/uaws/"

7. Предоставьте пользователю uaws доступ к файлам и каталогам, указанным в файле docker-compose.yml и конфигурационных файлах, одним из следующих способов:
   • Предоставьте всем пользователям права на чтение каталога /var/lib/uaws:

     sudo chmod a+r -R /var/lib/uaws

   • Измените владельца каталога /var/lib/uaws:

     sudo chown -R 10001:10001 /var/lib/uaws

     sudo chmod u+r -R /var/lib/uaws

8. Запустите компоненты службы идентификации пользователей:

   docker compose -f /var/lib/uaws/docker-compose.yml up -d

Развертывание службы идентификации пользователей на одном устройстве успешно завершено. Вы можете использовать функциональность службы идентификации пользователей в Kaspersky NGFW.