Расширение Extension for CAdES Browser Plugin: установка, настройка и решение проблем

Что такое Extension for CAdES Browser Plugin и зачем он нужен

Расширение Extension for CAdES Browser Plugin (также известно как CryptoPro Extension for CAdES Browser Plug-in) — это обязательный компонент для работы с усиленной электронной подписью (ЭП) на веб-страницах. Оно работает в паре с плагином КриптоПро ЭЦП Browser plug-in, который обеспечивает криптографические операции (создание и проверку подписи) на уровне браузера.

Без этого расширения невозможно:

• Подписать документ на портале Госуслуг.
• Войти в личный кабинет на электронных торговых площадках (ЭТП).
• Отправить отчётность через СБИС или Контур.
• Работать с системами СберБизнес и другими государственными информационными системами.

Расширение выступает связующим звеном между веб-интерфейсом и установленным плагином: оно передаёт команды от сайта к криптопровайдеру и обратно. Если расширение отсутствует или отключено, браузер не сможет обнаружить сертификаты и выполнить подписание.

Отличие расширения от плагина КриптоПро ЭЦП Browser plug-in

Многие пользователи путают эти два компонента, однако у них разные функции:

• Плагин (CAdESPlugin.exe) — это исполняемый модуль, который устанавливается в систему как обычная программа. Он отвечает за криптографические вычисления: создание электронной подписи, проверку сертификатов, шифрование. Плагин работает на уровне операционной системы и не зависит от браузера.

• Расширение (Extension for CAdES Browser Plug-in) — это надстройка для конкретного браузера (Chrome, Firefox, Edge и т.д.). Оно обеспечивает взаимодействие между веб-страницей и плагином. Расширение не выполняет криптографических операций самостоятельно, а только передаёт команды.

Важно: для корректной работы необходимы оба компонента. Установка только плагина без расширения (или наоборот) приведёт к тому, что сайты не увидят сертификаты.

Системные требования и поддерживаемые браузеры

Расширение Extension for CAdES Browser Plugin поддерживается в следующих браузерах:

• Google Chrome (до версии 138 включительно, начиная с 139 — установка невозможна из-за изменений в политике расширений).
• Microsoft Edge (на базе Chromium).
• Яндекс.Браузер.
• Mozilla Firefox.
• Opera.
• Chromium GOST (специализированная сборка для работы с ГОСТ-криптографией).

Ограничения:

• В Google Chrome 138 и новее расширение не устанавливается даже вручную. Рекомендуется использовать Яндекс.Браузер, Opera, Firefox или Chromium GOST.
• В Яндекс.Браузере для организаций и Chromium GOST расширение может работать без дополнительной настройки.
• Для Firefox расширение устанавливается через официальный магазин дополнений.

Системные требования:

• Операционная система: Windows 7/8/10/11, macOS, Linux.
• Установленный КриптоПро CSP (любая поддерживаемая версия).
• Установленный КриптоПро ЭЦП Browser plug-in (рекомендуется версия 2.0.15400 и выше).

Пошаговая установка расширения для Chrome, Edge и Яндекс.Браузера

Для браузеров на базе Chromium (Chrome, Edge, Яндекс.Браузер) расширение недоступно в официальном магазине — его нужно устанавливать вручную из архива.

Порядок действий:

1. Скачайте архив с расширением. Обычно он предоставляется на сайте разработчика (КриптоПро) или в личном кабинете сервиса (СберКорус, Контур). Файл имеет расширение .zip или .crx.

1. Распакуйте архив в отдельную папку. Важно: папка не должна быть удалена после установки, иначе расширение перестанет работать.

1. Откройте страницу управления расширениями в браузере:

• В адресной строке введите chrome://extensions (для Chrome, Edge, Яндекс.Браузера).
• Или через меню: «Настройки» → «Расширения» → «Управление расширениями».

1. Включите «Режим разработчика» (переключатель в правом верхнем углу).

1. Нажмите «Загрузить распакованное расширение» и выберите папку, в которую вы распаковали архив.

1. Включите расширение, если оно не включилось автоматически. Убедитесь, что переключатель активен.

1. Перезапустите браузер.

Проверка установки:

• Откройте страницу проверки плагина (обычно http://localhost/cades или специальный тестовый URL от разработчика).
• Убедитесь, что индикатор рядом с названием расширения зелёный.

Примечание: Если при установке через командную строку вы использовали параметр CHROME_EXTENSION=1, расширение может установиться автоматически. В этом случае достаточно включить его в настройках.

Установка расширения в Mozilla Firefox

В Firefox процесс проще, так как расширение доступно в официальном магазине дополнений.

Инструкция:

1. Откройте браузер Firefox.
2. Перейдите в меню (три полоски) → «Дополнения и темы».
3. В строке поиска введите CryptoPro Extension for CAdES Browser Plug-in.
4. Найдите официальное дополнение от разработчика «КриптоПро» и нажмите «Добавить в Firefox».
5. Подтвердите установку.
6. После установки перезапустите браузер.

Важно: Для работы в приватном режиме Firefox может потребоваться дополнительно разрешить расширение в настройках приватности.

Если расширение не найдено в магазине:

• Скачайте архив с расширением для Firefox (обычно .xpi).
• Перетащите файл в окно браузера или откройте его через меню «Файл» → «Открыть файл».
• Подтвердите установку.

Настройка расширения в Opera и других браузерах

Opera также основана на Chromium, поэтому установка аналогична Chrome:

1. Скачайте и распакуйте архив расширения.
2. В адресной строке введите opera://extensions.
3. Включите «Режим разработчика».
4. Нажмите «Загрузить распакованное расширение» и выберите папку.

Для браузера Chromium GOST:

• Расширение часто предустановлено. Если нет — установите вручную по той же схеме.
• В некоторых сборках расширение работает без дополнительных действий.

Для Яндекс.Браузера:

• Можно установить как из магазина Chrome (если он доступен), так и вручную через chrome://extensions.
• В версии для организаций расширение может быть уже встроено.

Общие рекомендации:

• После установки обязательно перезагрузите браузер.
• Проверьте, что расширение включено (зелёный индикатор).
• Если расширение не работает, попробуйте отключить другие расширения, которые могут конфликтовать (например, блокировщики рекламы).

Решение типичных проблем при установке и работе

Проблема 1: Расширение не отображается в списке после установки

• Причина: не включён режим разработчика или архив распакован неправильно.
• Решение: повторите установку, убедитесь, что папка не удалена.

Проблема 2: Браузер сообщает, что расширение повреждено

• Причина: устаревшая версия расширения или несовместимость с версией браузера.
• Решение: скачайте последнюю версию с сайта разработчика. Для Chrome 138+ используйте альтернативный браузер.

Проблема 3: При подписании документа ничего не происходит

• Причина: плагин не установлен или не запущен.
• Решение: проверьте, что КриптоПро ЭЦП Browser plug-in установлен и работает. Переустановите плагин с параметром CHROME_EXTENSION=1.

Проблема 4: Расширение установлено, но сертификаты не видны

• Причина: неправильные настройки браузера или конфликт с другими расширениями.
• Решение: отключите все сторонние расширения, очистите кеш браузера, перезапустите компьютер.

Проблема 5: В Chrome 138+ расширение не устанавливается

• Решение: используйте Яндекс.Браузер, Opera, Firefox или Chromium GOST. Либо установите более старую версию Chrome и отключите автообновление.

Проблема 6: Расширение требует обновления, но не обновляется

• Решение: удалите расширение и установите заново последнюю версию.

Проверка работоспособности и диагностика

После установки расширения и плагина необходимо убедиться, что всё работает корректно.

Способы проверки:

1. Тестовая страница КриптоПро:

• Откройте в браузере страницу проверки (обычно http://127.0.0.1/cades или специальный URL от разработчика).
• Если плагин и расширение работают, вы увидите зелёный индикатор и сообщение «Плагин установлен».

1. Попытка подписать тестовый документ:

• На той же странице нажмите кнопку «Создать подпись» или «Проверить подпись».
• Если всё настроено верно, появится окно выбора сертификата.

1. Работа на реальном портале:

• Зайдите на портал Госуслуг или любую ЭТП, где требуется ЭП.
• Если сертификаты отображаются и подписание проходит успешно — настройка завершена.

Диагностика с помощью утилит:

• Некоторые сервисы (например, Контур) предоставляют автоматическую диагностику рабочего места. Она проверяет наличие всех компонентов и даёт рекомендации.
• В Windows можно использовать Командную строку для проверки установки плагина: cadesplugin.exe -version.

Что делать, если проверка не проходит:

• Переустановите плагин с правами администратора.
• Убедитесь, что расширение включено в настройках браузера.
• Проверьте, что не используется VPN или прокси, блокирующие локальные соединения.

Особенности работы на macOS и Linux

Хотя большинство инструкций ориентированы на Windows, расширение и плагин поддерживаются и на других ОС.

macOS:

• Плагин устанавливается через .dmg-файл.
• Расширение для Safari не поддерживается — используйте Chrome, Firefox или Edge.
• Установка расширения вручную аналогична Windows: скачайте архив, распакуйте, загрузите через chrome://extensions.

Linux:

• Плагин устанавливается через пакетный менеджер (.deb, .rpm) или сборку из исходников.
• Расширение устанавливается вручную для Chrome/Chromium или через магазин для Firefox.
• Возможны проблемы с правами доступа к токенам — потребуется настройка udev-правил.

Общие ограничения:

• На macOS и Linux некоторые функции (например, работа с токенами через PC/SC) могут требовать дополнительной настройки.
• Рекомендуется использовать браузеры на базе Chromium для лучшей совместимости.

Безопасность и рекомендации

Использование расширения для работы с электронной подписью требует соблюдения мер безопасности:

• Скачивайте расширение только с официальных источников: сайт КриптоПро, личные кабинеты проверенных сервисов (СберКорус, Контур, СБИС). Не используйте сторонние сайты.
• Регулярно обновляйте плагин и расширение до последних версий.
• Не отключайте расширение без необходимости — это может привести к невозможности подписания.
• Используйте антивирус и файрвол для защиты от вредоносного ПО.
• Не устанавливайте расширение на общедоступных компьютерах без контроля.
• При возникновении ошибок обращайтесь в техническую поддержку сервиса, с которым работаете.

Важно: Расширение не собирает и не передаёт личные данные. Оно лишь обеспечивает криптографические операции на локальном компьютере.

Вопросы и ответы