Бегунов ЕгорСистемный администратор, DevOps
  1. Главная
  2. Блог
  3. Windows

Как заставить NCALayer не конфликтовать по портам на терминальном сервере Windows Server

Содержание

NCALayer — это незаменимый инструмент для работы с электронной цифровой подписью (ЭЦП) в Казахстане, широко используемый в системах 1С, ЭСФ и на порталах государственных услуг. Однако при развертывании на терминальном сервере Windows Server (RDS) он превращается в источник постоянных сбоев. Главная причина — конфликт портов.

Сейчас разберем, почему возникает ошибка

Порт NCALayer уже занят

и предоставим готовое решение в виде скрипта, который назначает уникальный порт для каждого пользователя.

Почему NCALayer не работает в многопользовательской среде?

Проблема кроется в архитектуре приложения. По умолчанию NCALayer ведет себя следующим образом:

  • Слушает фиксированный порт: он всегда пытается занять порт 13579 для связи с браузером или 1С через WebSocket.
  • Не умеет работать в мультисессии: приложение не рассчитано на одновременный запуск несколькими пользователями на одном сервере.

В результате, когда первый пользователь RDP запускает NCALayer, он занимает порт 13579. Второй пользователь, пытаясь запустить свою копию, получает ошибку «Address already in use» или «Порт NCALayer уже занят, завершите работу лишних экземпляров NCALayer». Работа с ЭЦП блокируется для всех, кроме первого пользователя.

Назначение порта NCALayer через политику Logon

Этот способ назначает порт по SessionId через групповую политику Logon. Одна и та же сессия всегда получает один и тот же порт, а пользователь при переподключении к той же сессии сохраняет работоспособность NCALayer.

Логика скрипта

$sid  = (Get-Process -Id $PID).SessionId
$port = 13580 + ($sid % 100)
[Environment]::SetEnvironmentVariable('NCALAYERPORT', "$port", 'User')
$env:NCALAYERPORT = "$port"

Что здесь происходит:

СтрокаНазначение
(Get-Process -Id $PID).SessionIdПолучает SessionId текущей RDP-сессии (не путать с SID пользователя, несмотря на имя переменной).
13580 + ($sid % 100)Вычисляет порт в диапазоне 13580–13679 на основе остатка от деления. Одна сессия — один порт.
SetEnvironmentVariable(..., 'User')Записывает NCALAYERPORT в реестр HKCU\Environment, чтобы значение сохранилось между сессиями.
$env:NCALAYERPORT = "$port"Устанавливает переменную в текущем процессе скрипта — необходимо, если NCALayer запускается из этого же скрипта (см. ниже).

Ключевое преимущество: здесь порт детерминирован. При переподключении к той же сессии пользователь получит тот же порт, и сохраненные настройки в браузере или 1С продолжат работать.

Развертывание через GPO Logon Script

Шаг 1: Подготовьте PowerShell-скрипт

Сохраните следующий файл как Set-NCALayerPort.ps1 на контроллере домена в сетевой папке, доступной на чтение всем пользователям (например, \\DC01\NETLOGON\Scripts\Set-NCALayerPort.ps1):

powershell

$sessionId = (Get-Process -Id $PID).SessionId
$port = 13580 + ($sessionId % 100)
[Environment]::SetEnvironmentVariable('NCALAYERPORT', "$port", 'User')
$env:NCALAYERPORT = "$port"

Шаг 2: Настройте групповую политику

  1. Откройте Group Policy Management Console (gpmc.msc).
  2. Создайте или отредактируйте GPO, привязанный к OU с терминальными серверами (или к OU с пользователями).
  3. Перейдите в:User Configuration → Policies → Windows Settings → Scripts (Logon/Logoff) → Logon.
  4. Откройте свойства → вкладка PowerShell Scripts → Add.
  5. В поле Script Name укажите путь к Set-NCALayerPort.ps1 (например, \\DC01\NETLOGON\Scripts\Set-NCALayerPort.ps1).
  6. В поле Script Parameters оставьте пусто. Нажмите OK.

Важно. Вкладка «PowerShell Scripts» появится только если установлен компонент GPO Client-Side Extensions для PowerShell. На современных Windows Server он присутствует по умолчанию.

Шаг 3: Разрешите выполнение PowerShell-скриптов

По умолчанию ExecutionPolicy может блокировать скрипт. Настройте политику через:Computer Configuration → Policies → Administrative Templates → Windows Components → Windows PowerShell → Turn on Script Execution → Enabled → Allow only signed scripts.

Шаг 4: Проверка

После применения GPO и перезагрузки пользователем:

  1. В сессии пользователя откройте PowerShell и выполните: echo $env:NCALAYERPORT Должен отобразиться порт в диапазоне 13580–13679.
  2. Запустите NCALayer и убедитесь, что он слушает назначенный порт.

Заключение

Способ с SessionId и GPO Logon — это компактное, детерминированное решение, которое подходит для большинства RDS-инсталляций. Оно требует минимум инфраструктуры (один .ps1 в NETLOGON + одна политика) и обеспечивает стабильную привязку порт↔сессия.