Подготовка к работе с плагином
Проверка системных требований
Поддерживаемые операционные системы
Плагин, предназначенный для взаимодействия с порталом государственных услуг, функционирует только на операционных системах, удовлетворяющих требованиям совместимости и безопасности.
Поддерживаемые платформы:
- Windows 10, версия 1809 и выше (64‑разрядная); Windows 11 (64‑разрядная).
- Windows 7 SP1 (64‑разрядная) - только при установленном обновлении KB4561600.
- macOS 10.15 (Catalina) и новее; поддерживаются браузеры Safari 13+, Chrome 86+, Firefox 84+.
- Linux‑дистрибутивы с ядром 5.4 и выше, при работе через браузер Chrome 88+ или Firefox 86+; требуется установка пакета libgconf‑2‑4 для корректного отображения.
Требования к системе:
- 64‑битный процессор.
- Минимум 4 ГБ оперативной памяти.
- Доступ к интернету без блокировок.
- Установленные последние версии браузеров, перечисленных выше.
Отсутствие указанных компонентов приводит к невозможности запуска плагина и отказу в выполнении запросов к сервису. При соблюдении всех условий активация проходит без ошибок.
Поддерживаемые браузеры
Для работы плагина, позволяющего взаимодействовать с сервисом Госуслуг, необходимы браузеры, поддерживающие современные веб‑технологии.
- Google Chrome - версии 92 и выше;
- Mozilla Firefox - версии 90 и выше;
- Microsoft Edge - версии 92 и выше;
- Яндекс.Браузер - версии 22 и выше;
- Safari - версии 14 и выше (только на macOS).
Браузер должен быть обновлён до последней стабильной версии, иначе могут возникнуть ошибки загрузки или некорректное выполнение скриптов плагина. При обнаружении проблем рекомендуется проверить наличие обновлений и, при необходимости, переключиться на один из перечисленных вариантов.
Необходимое программное обеспечение
КриптоПро CSP
КриптоПро CSP - компонент, обеспечивающий работу цифровой подписи и шифрование в браузерах при обращении к порталу государственных услуг. Без него большинство функций портала, требующих подтверждения подлинности, недоступны.
Для включения плагина, использующего КриптоПро CSP, выполните следующие действия:
- Скачайте актуальную версию КриптоПро CSP с официального сайта, запустите установочный файл и следуйте инструкциям мастера.
- При установке выберите тип «Браузерный плагин», укажите браузер, в котором будет использоваться портал.
- После завершения установки откройте браузер, перейдите в раздел «Настройки → Дополнения», убедитесь, что плагин активен.
- Перезапустите браузер, откройте портал государственных услуг, выполните вход. При первом запросе подписи появится окно КриптоПро CSP, подтвердите запрос.
Плагин готов к работе: подписи формируются автоматически, данные передаются в зашифрованном виде, соблюдаются требования безопасности портала. Если после установки возникают ошибки, проверьте совместимость версии браузера и наличие прав администратора.
КриптоПро ЭЦП Browser plug-in
КриптоПро ЭЦП Browser plug‑in - необходимый компонент для подтверждения электронной подписи в системе Госуслуг. Ниже приведена последовательность действий, позволяющая включить плагин и начать работу с порталом.
- Скачайте установочный пакет с официального сайта КриптоПро.
- Запустите файл .exe, следуйте инструкциям мастера установки, оставьте включёнными опции «Установить браузерный плагин» и «Создать сертификат ЭЦП».
- После завершения установки откройте браузер (Chrome, Firefox, Edge). В адресной строке введите
chrome://extensions/(для Chrome) или аналогичный путь для другого браузера. Убедитесь, что КриптоПро ЭЦП Browser plug‑in включён. - Перезапустите браузер, чтобы загрузить плагин.
- Перейдите на портал Госуслуг, нажмите кнопку «Войти», выберите способ входа через электронную подпись. Плагин запросит подтверждение доступа к сертификату. Подтвердите запрос, при необходимости введите PIN-код.
- После успешной аутентификации система отобразит личный кабинет.
При возникновении ошибок проверьте:
- Совместимость версии плагина и браузера;
- Наличие актуального сертификата в хранилище;
- Правильность ввода PIN-кода.
Готовый к использованию плагин обеспечивает надёжную подпись документов и быстрый доступ к услугам государственных органов.
Актуальные драйверы для токенов и смарт-карт
Для корректной работы плагина, обеспечивающего взаимодействие с сервисом Госуслуг, необходимы актуальные драйверы, поддерживающие токены и смарт‑карты. Без их установки система не сможет распознать криптографические устройства, что сделает процесс аутентификации невозможным.
Ключевые драйверы:
- DCToken 3.0 - последняя версия, совместимая с Windows 10/11, Linux (kernel 5.x) и macOS 12+. Обеспечивает поддержку USB‑токенов большинства производителей.
- SmartCard Middleware 2.5 - пакет, включающий драйверы для смарт‑карт с интерфейсом CCID, а также библиотеки PKCS#11. Поддерживает работу в браузерах Chrome, Firefox и Edge.
- Cryptographic Provider 1.8 - модуль, интегрированный в плагин, отвечает за подпись и шифрование запросов к порталу.
Установка драйверов:
- Скачайте архивы с официальных сайтов производителей или из репозитория государственной ИТ‑инфраструктуры.
- Распакуйте содержимое в отдельную папку, запомните путь.
- Запустите установочный файл от имени администратора; при появлении запросов о доверии к драйверам подтвердите их.
- После завершения установки перезагрузите компьютер, чтобы система обнаружила новые устройства.
- Откройте настройки плагина, укажите путь к установленным драйверам (обычно
C:\Program Files\DCToken\иC:\Program Files\SmartCard\). - Проверьте работу токена и карты через тестовый вход в личный кабинет Госуслуг.
Обновление: проверяйте версии драйверов ежемесячно. Автоматические оповещения о новых релизах доступны в разделе «Обновления» плагина. При обнаружении более новой версии заменяйте старый пакет, повторяя шаги установки.
Точные версии драйверов и их совместимость гарантируют безошибочную работу плагина, позволяя быстро и безопасно выполнять операции на портале государственных услуг.
Установка КриптоПро ЭЦП Browser plug-in
Загрузка установочного файла
Для начала работы с плагином, предназначенным для взаимодействия с порталом Госуслуг, необходимо загрузить его установочный файл.
- Откройте официальный сайт службы поддержки и перейдите в раздел «Скачать плагины».
- Выберите нужный вариант, совместимый с вашей ОС, и нажмите кнопку загрузки.
- При появлении диалогового окна подтвердите сохранение файла в выбранную папку.
После завершения загрузки проверьте целостность файла: сравните контрольную сумму, указанную на странице загрузки, с полученной после скачивания. При совпадении можно переходить к установке.
Скопируйте полученный архив в каталог, где хранятся остальные компоненты системы, и распакуйте его, сохранив структуру папок. После этих действий плагин будет готов к активации и последующей настройке в рамках работы с сервисом Госуслуг.
Процесс установки
Запуск инсталлятора
Для работы с плагином, предназначенным для портала государственных услуг, первым действием является запуск установочного пакета.
- Дважды щелкните файл
setup.exe(илиinstall.msi) в каталоге загрузки. - При появлении окна контроля учётных записей подтвердите действие, выбрав «Да».
- Укажите каталог установки, обычно
C:\Program Files\GovPlugin. - Нажмите «Установить» и дождитесь завершения процесса.
- После окончания установки нажмите «Готово», чтобы закрыть мастер.
Запуск инсталлятора проверяет совместимость системы, создаёт необходимые реестровые записи и копирует файлы в выбранную директорию. По завершении появляется ярлык на рабочем столе и запись в меню «Пуск», откуда можно открыть плагин и приступить к его настройке.
Выбор компонентов установки
Для корректного включения плагина, предназначенного для взаимодействия с сервисом государственных услуг, необходимо правильно подобрать компоненты установки.
Первый шаг - выбор ядра плагина. Вариант «Базовый» содержит только обязательные модули, которые обеспечивают связь с API портала и базовую аутентификацию. Вариант «Расширенный» добавляет функции автозаполнения форм, проверку подписи документов и поддержку многопользовательского режима.
Второй шаг - окончательная сборка. При установке следует явно указать требуемые модули:
- API‑клиент - обязательный, обеспечивает запросы к серверу Госуслуг.
- Модуль аутентификации - необходим для работы с токенами доступа.
- Плагин автозаполнения - опциональный, ускоряет ввод данных в типовых формах.
- Контроль подписи - рекомендуется при работе с юридически значимыми документами.
- Многопользовательский менеджер - нужен в корпоративных средах, где одновременно работают несколько сотрудников.
Третий шаг - проверка совместимости. Перед запуском убедитесь, что выбранные компоненты соответствуют версии браузера и операционной системы, иначе возможны ошибки соединения.
Правильный набор компонентов гарантирует стабильную работу плагина, минимизирует задержки при обращении к сервису и упрощает дальнейшую настройку.
Завершение установки
После загрузки установочного файла запустите его двойным щелчком.
- Подтвердите согласие с лицензией - нажмите «Принимаю».
- Укажите каталог установки или оставьте значение по умолчанию.
- Дождитесь завершения копирования файлов; индикатор прогресса покажет окончание.
После копирования откройте настройки браузера:
- Добавьте путь к плагину в список расширений.
- Включите опцию «Разрешить работу с госуслугами».
Перезапустите браузер, чтобы изменения вступили в силу.
Проверьте статус плагина в разделе «Расширения»: он должен отображаться как активный. Если статус «неактивен», повторите шаги настройки и убедитесь, что разрешения заданы правильно.
Завершив эти действия, плагин готов к работе с порталом государственных услуг.
Настройка плагина для работы с Госуслугами
Проверка работы плагина
Тестовая страница КриптоПро
Тестовая страница КриптоПро служит проверочным ресурсом при настройке плагина, позволяющего взаимодействовать с порталом государственных услуг. На ней размещён набор функций, которые демонстрируют корректность установки сертификатов, работу криптографических модулей и передачу данных через браузер.
Для активации плагина выполните следующие действия:
- Откройте страницу https://test.cryptopro.ru в поддерживаемом браузере (Chrome, Firefox, Edge).
- Установите расширение КриптоПро CSP, если оно отсутствует; загрузка доступна на официальном сайте.
- Перезапустите браузер, чтобы модуль был обнаружен системой.
- Перейдите в раздел «Настройки» → «Плагины», включите «КриптоПро для Госуслуг».
- Проверьте работу, нажав кнопку «Тестировать подключение»; при успешном ответе появится сообщение о готовности к работе с сервисом государственных услуг.
После выполнения этих шагов тестовая страница отобразит статус «Готово», что подтверждает готовность плагина к реальному использованию на портале государственных услуг. Если возникнут ошибки, откройте консоль браузера, найдите сообщения о загрузке плагина и устраните указанные причины.
Устранение возможных ошибок
Для успешного запуска модуля, обеспечивающего взаимодействие с сервисом Госуслуг, необходимо устранить типичные ошибки, возникающие при его активации.
Часто встречаемые проблемы и способы их решения:
- Неправильный путь к файлу конфигурации - проверьте, что указанный каталог совпадает с реальным расположением
config.json. При необходимости исправьте путь в настройках плагина. - Отсутствие прав доступа - запустите приложение от имени администратора или предоставьте текущему пользователю права записи в директорию плагина.
- Несоответствие версии браузера - убедитесь, что установленный браузер поддерживает требуемый API; при необходимости обновите его до последней стабильной версии.
- Блокировка антивирусом - отключите временно защитное программное обеспечение или добавьте папку плагина в список исключений.
- Конфликт с другими расширениями - деактивируйте сторонние модули, которые могут перехватывать запросы к порталу, и проверьте работу плагина.
Если после выполнения перечисленных действий ошибка сохраняется, выполните полную переустановку модуля: удалите текущие файлы, скачайте свежий пакет с официального сайта и повторите процесс активации. При повторных сбоях обратитесь к журналу ошибок, где указаны коды и детали, позволяющие быстро локализовать проблему.
Настройка браузера
Разрешение всплывающих окон
Для корректной работы плагина, позволяющего взаимодействовать с порталом государственных услуг, необходимо разрешить отображение всплывающих окон в браузере. Без этой настройки плагин не сможет открыть необходимые диалоговые окна, что приведёт к ошибкам при попытке выполнить операции в личном кабинете.
Как включить разрешения:
- Откройте настройки браузера (Chrome - Меню → Настройки → Конфиденциальность и безопасность → Настройки сайта).
- В разделе «Всплывающие окна и перенаправления» добавьте адрес gov.ru в список разрешённых.
- Сохраните изменения и перезапустите браузер.
- После перезапуска запустите плагин и проверьте, что при переходе к сервисам открываются необходимые окна.
Если после выполнения указанных действий всплывающие окна всё ещё блокируются, проверьте наличие сторонних расширений (анти‑рекламных, блокировщиков скриптов) и отключите их для сайта госуслуг. После этого плагин будет функционировать без препятствий.
Добавление портала Госуслуг в доверенные зоны
Для корректной работы плагина, обеспечивающего доступ к сервису Госуслуг, необходимо включить портал в список доверенных зон. Этот шаг гарантирует отсутствие блокировок со стороны браузера или системы безопасности и позволяет плагину выполнять запросы без ограничений.
Для добавления портала выполните следующие действия:
- Откройте панель управления браузером (Internet Explorer, Edge, Chrome / Firefox с установленным расширением).
- Перейдите в раздел «Безопасность» → «Доверенные сайты».
- Нажмите кнопку «Добавить» и введите адрес https://www.gosuslugi.ru.
- Установите уровень защиты «Средний» (или «Низкий», если требуется полное взаимодействие).
- Сохраните изменения и перезапустите браузер.
После обновления списка доверенных сайтов запустите плагин. Он автоматически обнаружит портал в доверенной зоне и начнёт работу без дополнительных запросов на подтверждение. Если плагин не активируется, проверьте, что указанный адрес точно совпадает с используемым в настройках, и повторите процедуру.
Возможные проблемы и их решение
Ошибки при инициализации плагина
Не установлен КриптоПро CSP
Для работы плагина, обеспечивающего взаимодействие с сервисом Госуслуг, требуется установленный криптографический модуль - КриптоПро CSP. Отсутствие этого компонента приводит к ошибкам при попытке выполнить подпись документов и авторизацию в системе.
Для устранения проблемы выполните следующие действия:
- Скачайте дистрибутив КриптоПро CSP с официального сайта - выберите версию, совместимую с вашей операционной системой (Windows 7/8/10/11 32‑ или 64‑бит).
- Запустите установочный файл от имени администратора; в процессе установки укажите каталог установки и подтвердите согласие с лицензионным соглашением.
- После завершения установки откройте «Панель управления → Система и безопасность → Администрирование → Управление сертификатами». Убедитесь, что в хранилище «Личные» присутствуют сертификаты, выданные вашей организацией.
- Перезапустите браузер, в котором используется плагин, и проверьте его работу на тестовой странице Госуслуг. При правильной установке модуль отобразится в списке доступных криптопровайдеров.
Если после установки ошибка сохраняется, проверьте:
- Совместимость версии CSP с версией плагина (обновите плагин до последней доступной версии).
- Наличие прав доступа к файлам CSP для текущего пользователя.
- Отключение конфликтующих криптографических провайдеров в реестре (ключи HKLM\SOFTWARE\CryptoPro).
После выполнения указанных шагов плагин будет готов к использованию в системе Госуслуг.
Устаревшая версия плагина
Устаревшая версия плагина блокирует процесс активации и ограничивает доступ к функциям портала Госуслуг.
- В старой сборке отсутствуют необходимые сертификаты безопасности, из‑за чего браузер отклоняет соединение.
- Совместимость с текущими версиями операционных систем нарушена: некоторые API уже не поддерживаются.
- Обновления баз данных, требуемые для идентификации пользователя, не включены в старый пакет.
Для устранения проблем необходимо выполнить следующие действия:
- Снять текущий плагин: открыть панель управления → Программы → Удалить устаревший компонент.
- Скачайте актуальную версию с официального сайта Госуслуг, убедившись в наличии цифровой подписи.
- Установите пакет, следуя инструкциям мастера установки; при запросе прав администратора предоставьте их.
- Перезапустите браузер и откройте портал; проверка статуса плагина должна показать «активен».
После обновления все функции работают без ограничений, а процесс аутентификации проходит мгновенно.
Проблемы с электронной подписью
Неправильно выбран сертификат
Неправильный выбор сертификата блокирует процесс активации плагина, предназначенного для работы с порталом Госуслуг. Система проверяет соответствие сертификата требованиям безопасности и формату, установленному провайдером. Если сертификат не удовлетворяет этим условиям, плагин отказывается запускаться, а пользователь получает сообщение об ошибке.
Для исправления ситуации необходимо выполнить следующие действия:
- Убедиться, что установленный сертификат принадлежит организации, зарегистрированной в системе Госуслуг, и выдан доверенным центром сертификации.
- Проверить, что сертификат имеет расширение .pfx или .p12 и содержит закрытый ключ.
- Открыть настройки плагина и указать путь к файлу сертификата, который соответствует требованиям.
- Ввести корректный пароль к сертификату; неверный пароль также приводит к отказу валидации.
- После выбора правильного сертификата нажать кнопку «Активировать» и дождаться подтверждения успешного подключения.
Если после выполнения всех пунктов ошибка сохраняется, рекомендуется удалить текущий сертификат из списка, импортировать заново свежий файл и повторить процесс активации. При повторных неудачах следует обратиться в службу поддержки портала с указанием кода ошибки и версии плагина.
Истек срок действия сертификата
Срок действия сертификата закончился - плагин перестаёт работать, так как безопасное соединение с порталом Госуслуг разорвано.
Для восстановления доступа необходимо получить новый сертификат, соответствующий требованиям Федеральной службы по техническому и криптографическому надзору.
Порядок действий:
- Обратиться в аккредитованный центр выдачи сертификатов (например, через личный кабинет на сайте ФСТЭК);
- Сформировать запрос на выпуск сертификата, указав цель использования - работу с плагином Госуслуг;
- Получить и установить сертификат в хранилище Windows (или в отдельный контейнер, если используется иной тип хранилища);
- В настройках плагина указать путь к новому сертификату и подтвердить пароль доступа.
После установки запустите плагин и проверьте соединение с порталом: успешный запрос к API Госуслуг подтверждает корректную активацию. Если ошибка сохраняется, проверьте правильность указания сертификата и его актуальность.
Обращение в службу поддержки
Поддержка КриптоПро
Поддержка КриптоПро обеспечивает совместимость плагина с электронными сертификатами, необходимыми для взаимодействия с порталом государственных услуг. При правильной настройке КриптоПро гарантирует корректную подпись запросов и прием ответов от сервера.
Для активации плагина требуется:
- установленный КриптоПро CSP версии 5.x и выше;
- актуальная версия Java Runtime Environment (JRE);
- сертификат пользователя, импортированный в хранилище КриптоПро;
- файл конфигурации плагина, указывающий путь к библиотекам КриптоПро.
Последовательность действий:
- Скачайте и установите КриптоПро CSP, согласовав тип установки «Полный» для доступа к библиотекам.
- Запустите утилиту «КриптоПро Установщик», импортируйте пользовательский сертификат в контейнер «My».
- Скопируйте файлы плагина в каталог, указанный в настройках браузера (например, %APPDATA%\Mozilla\Plugins).
- Откройте файл конфигурации плагина (config.xml) и задайте параметры:
<cspPath>- абсолютный путь кcsp.dll;<certStore>- имя хранилища, где находится сертификат.
- Перезапустите браузер, откройте портал государственных услуг, проверьте наличие значка плагина в строке статуса.
Если плагин не отображается, выполните проверку:
- убедитесь, что версия КриптоПро совпадает с требуемой в документации;
- проверьте, что Java‑платформа включена в переменную окружения
PATH; - откройте консоль браузера, найдите сообщения об ошибках загрузки библиотек;
- при необходимости переустановите плагин и перезапустите систему.
Эти шаги позволяют полностью задействовать возможности КриптоПро при работе с сервисом государственных услуг, обеспечивая безопасный обмен данными и электронную подпись запросов.
Поддержка портала Госуслуг
Поддержка портала Госуслуг обеспечивает стабильную связь между клиентским приложением и государственными сервисами, гарантируя корректную передачу запросов и получение ответов. Без неё плагин не сможет выполнять задачи авторизации, получения справок и оформления заявок.
Для включения плагина, который взаимодействует с Госуслугами, выполните следующие действия:
- Установите последнюю версию плагина из официального репозитория.
- Откройте настройки плагина и укажите путь к файлу конфигурации поддержки сервиса.
- Введите токен доступа, полученный в личном кабинете Госуслуг, и подтвердите его.
- Активируйте режим «Live», проверив соединение через тестовый запрос к API.
- Сохраните изменения и перезапустите приложение.
После выполнения этих шагов плагин будет полностью интегрирован с поддержкой портала, позволяя выполнять операции в реальном времени без дополнительных вмешательств.