Как устранить ошибку инициализации локального модуля Честного ЗНАКа
Ошибка «Локальный модуль Честный знак не инициализирован» возникает при отсутствии запущенного сервиса ChestnyZnak.LocalModule.Service или недоступности порта по умолчанию. Это проблема программного компонента на стороне пользователя, а не сбой серверов ЦРПТ. Для восстановления работы необходимо проверить статус службы, настройки сети и наличие действующего сертификата УКЭП.
Оглавление
Основные причины сбоя и диагностика
Локальный модуль (ЛМ ЧЗ) выступает связующим звеном между учетной системой (например, 1С) и инфраструктурой маркировки. Если компонент не инициализируется, обмен данными блокируется.
Главная причина ошибки — остановленная служба Windows или отключенное состояние сервиса. Также сбой может быть вызван конфликтом порта 9090 (HTTP), который используется модулем по умолчанию, или отсутствием необходимых прав доступа у учетной записи, от имени которой происходит запуск.
Для быстрой проверки доступности модуля выполните HTTP-запрос GET по адресу http://localhost:9090/api/v1/status. Если ответ не получен, значит, сервис не отвечает на запросы.
Пошаговое руководство по устранению ошибки
Для восстановления работоспособности локального модуля выполните следующие действия в указанном порядке:
- Проверьте статус службы. Откройте оснастку управления службами (
services.msc). Найдите службуChestnyZnak.LocalModule.Service. Если ее статус «Остановлена» или «Отключено», запустите её вручную. - Перезапустите сервис. Даже если служба отображается как работающая, рекомендуется выполнить её перезапуск через
services.mscдля сброса возможных зависаний процесса инициализации. - Проверьте права доступа. Убедитесь, что запуск службы осуществляется от имени учетной записи с правами администратора или специального пользователя, имеющего прямой доступ к криптопровайдеру. Без этих прав модуль не сможет взаимодействовать с электронной подписью.
- Контроль порта. Убедитесь, что порт 9090 не занят другими приложениями и доступен для локальных подключений.
После перезапуска службы всегда проверяйте статус через API-запрос к http://localhost:9090/api/v1/status, чтобы убедиться, что инициализация прошла успешно.
Проверка конфигурации и сертификатов
Корректная работа локального модуля невозможна без правильной настройки файлов и наличия юридических средств подписи.
| Компонент | Требование | Примечание |
|---|---|---|
| Сертификат ЭЦП | Действующий сертификат УКЭП | Должен быть установлен на токене или в реестре Windows |
| Файл конфигурации | appsettings.json | Проверьте целостность файла в папке установки модуля |
| Платформа .NET | Минимальная версия 4.7.2 | Требуется для корректной работы сервиса в среде Windows |
Отсутствие действующего сертификата усиленной квалифицированной электронной подписи (УКЭП) является частой причиной неудачной инициализации, так как модуль не может пройти аутентификацию в системе Честный ЗНАК.
Частые ошибки
При настройке локального модуля пользователи часто сталкиваются со следующими проблемами:
- Игнорирование прав администратора. Запуск службы под обычным пользователем приводит к ошибке доступа к криптографическому контейнеру.
- Блокировка порта 9090. Антивирусное ПО или брандмауэр могут блокировать HTTP-трафик на порту по умолчанию, из-за чего учетная система не видит модуль.
- Устаревшая среда выполнения. Установка модуля на компьютер без .NET Framework версии 4.7.2 или выше вызывает критические ошибки запуска сервиса.
FAQ
Вопрос: Означает ли ошибка «не инициализирован», что серверы Честного ЗНАКа недоступны? Ответ: Нет. Эта ошибка указывает на проблему с программным компонентом (локальным модулем) на компьютере пользователя, а не на сбои в работе серверов ЦРПТ.
Вопрос: Какой порт использует локальный модуль по умолчанию? Ответ: Для HTTP-подключений используется порт 9090.
Вопрос: Где найти файл настроек локального модуля?
Ответ: Основной файл конфигурации называется appsettings.json и располагается в директории установленного модуля.
Вопрос: Что делать, если служба запускается, но ошибка сохраняется? Ответ: Проверьте наличие действующего сертификата УКЭП и убедитесь, что служба запущена от имени пользователя с правами доступа к криптопровайдеру.