КриптоПро ЭЦП Browser plug-in: установка, включение расширения и проверка

КриптоПро ЭЦП Browser plug-in (его же ищут как «крипто про плагин», «криптопро браузер плагин» и CryptoPro browser plug-in) — бесплатная программа, которая связывает криптопровайдер на компьютере с сайтом, где вы подписываете документ или входите по сертификату. Без неё портал просто не увидит подпись: браузер по соображениям безопасности не имеет прямого доступа к ключам. Работает плагин всегда в паре с криптопровайдером — обычно это КриптоПро CSP. Сам по себе он ничего не подписывает, а только передаёт запрос сайта криптопровайдеру и возвращает результат. В технической документации и в сообщениях об ошибках он же называется CAdES Browser Plug-in — по названию формата усовершенствованной подписи CAdES, с которым работает. Актуальная линейка — версия 2.0: если сайт требует «плагин версии 2.0», речь именно о ней, а не об отдельном продукте.

Что нужно установить: три разных продукта

Половина проблем возникает из-за того, что продукты КриптоПро путают между собой. Они не заменяют друг друга:

Продукт	Для чего
КриптоПро CSP	Криптопровайдер: хранит ключи и выполняет само подписание. Платный, нужен всегда
КриптоПро ЭЦП Browser plug-in	Подпись на сайтах: торговые площадки, порталы, личные кабинеты. Бесплатный
КриптоПро PDF и Office Signature	Подпись внутри Adobe Acrobat и Microsoft Office — к браузеру отношения не имеют

Поэтому запрос «плагин КриптоПро PDF скачать» — это про другой продукт: он нужен, когда документ подписывают в Acrobat Reader, а не на сайте. Порядок работы с файлами разобран в статьях про подписание PDF и подписание документов Word.

Как установить плагин

1. Скачайте дистрибутив с официального сайта КриптоПро — cryptopro.ru. Плагин распространяется бесплатно, регистрация нужна только для скачивания части продуктов.
2. Закройте браузер: установщик не сможет корректно завершить работу, пока браузер запущен.
3. Запустите установочный файл и подтвердите запросы контроля учётных записей. Свежие версии объединяют в одном установщике и криптопровайдер, и плагин.
4. Дождитесь сообщения об успешной установке и запустите браузер заново.

Права администратора нужны: плагин ставится в систему, а не в профиль пользователя.

Как включить расширение в браузере

Порядок зависит от браузера, но логика одна: после установки плагина браузер должен получить и активировать соответствующее расширение.

• Google Chrome, Microsoft Edge, Яндекс.Браузер. Расширение ставится из магазина расширений и называется CryptoPro Extension for CAdES Browser Plug-in. Иногда браузер предлагает включить его сам после перезапуска — тогда достаточно подтвердить. Проверить состояние можно в разделе расширений: «Дополнительные инструменты» → «Расширения».
• Mozilla Firefox. Нужно отдельное расширение с сайта КриптоПро: старый механизм плагинов NPAPI браузеры больше не поддерживают, поэтому файлы из архивных инструкций 2015–2020 годов не подойдут.
• Браузеры с российской криптографией. Chromium-Gost и Яндекс Браузер для организаций производитель называет рекомендуемыми: в них дополнительная настройка обычно не требуется.

После включения расширения браузер надо перезапустить полностью — закрыть все окна, а не только вкладку.

Как проверить, что всё работает

У КриптоПро есть демонстрационная страница проверки плагина: она показывает версию плагина, версию криптопровайдера и список доступных сертификатов. Если страница открылась и данные видны — связка «браузер → плагин → криптопровайдер» собрана правильно. Порядок проверки:

1. Откройте страницу проверки в том браузере, в котором собираетесь работать.
2. Разрешите сайту выполнять операции с сертификатами, когда появится запрос.
3. Убедитесь, что отображаются версия плагина и хотя бы один сертификат.
4. Подпишите на странице тестовое сообщение — это самая надёжная проверка.

Если сертификатов в списке нет, проблема не в плагине, а в установке самого сертификата — разбор в инструкции по установке сертификата, а поиск контейнера на диске — в статье как найти файл подписи.

Услуги удостоверяющего центра — помощь с установкой сертификата, криптопровайдером и браузером, если своими силами не вышло.

Частые проблемы и что с ними делать

Что видно	Причина и решение
«Плагин недоступен» или «не загружен»	Не включено расширение браузера либо браузер не перезапущен. Проверьте список расширений и перезапустите браузер полностью
Плагин определяется, сертификатов нет	Сертификат не установлен в хранилище или носитель не подключён. Проверьте наличие сертификата в личном хранилище
Сайт не запрашивает подпись	Адрес не добавлен в список доверенных узлов в настройках плагина
Подпись срывается с ошибкой	Чаще всего несовместимость версий криптопровайдера и плагина либо истёкшая лицензия CSP — разбор в статье про ошибки электронной подписи

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

Настройка рабочего места целиком

Плагин — только один из компонентов. Чтобы подпись заработала на сайте, обычно нужны все четыре:

• криптопровайдер КриптоПро CSP с действующей лицензией;
• драйверы носителя, если ключ на токене;
• личный сертификат, установленный с привязкой к закрытому ключу;
• корневой сертификат удостоверяющего центра — без него цепочка не строится, подробнее в статье про корневой сертификат.

Общая настройка браузера под работу с подписью разобрана отдельно — в материале настройка браузера для ЭЦП.

Частые вопросы