Подготовка компьютера и сертификата к электронной подписи в браузере
Эта инструкция помогает подготовить компьютер к подписанию документов в TesLab через браузер. Сначала настройте криптографическое ПО и доступ к своему сертификату, затем проверьте работу компонентов и профиль TesLab. Для подписи необходим соответствующий закрытый ключ: одного файла сертификата недостаточно.
В этой статье
- Что подготовить
- Установить ПО и проверить лицензию
- Установить личный сертификат
- Включить расширение браузера
- Особенности macOS и Linux
- Проверить компоненты и доступ к ключу
- Разрешить обращение с сайта TesLab
- Привязать свой сертификат
- Проверить существующую привязку
- Заменить сертификат после перевыпуска
- Разобраться с отказом
- Проверить готовность

Что подготовить
- Собственный действующий сертификат электронной подписи и доступ к его закрытому ключу на разрешённом носителе.
- Компьютер, браузер и учётную запись пользователя ОС, под которой будете подписывать. В этой же учётной записи настраивайте личное хранилище сертификатов.
- PIN или пароль носителя, известный владельцу. Вводите его в окне криптографического компонента, а не передавайте сотруднику поддержки.
- Учётную запись TesLab с корректными персональными сведениями. Для проверки подписи протокола в сертификате и TesLab должен совпадать СНИЛС.
- Доступ к сети для работы TesLab и проверки сертификата. Для установки программ на служебном компьютере может понадобиться администратор.
Проверьте совместимость версии ОС, архитектуры компьютера, браузера, криптопровайдера и носителя. Перечень платформ плагина приведён у КриптоПро; он не означает, что любое старое сочетание подходит современному TesLab. Для этой инструкции используйте актуальный браузер на компьютере.
Установить ПО и проверить лицензию
В основном варианте настройки используются следующие компоненты:
- КриптоПро CSP: криптопровайдер, который выполняет операции с ключом.
- КриптоПро ЭЦП Browser plug-in: системный компонент, предоставляющий браузерному приложению доступ к криптографическим функциям.
- Расширение браузера: связующее звено с установленным компонентом. Одного расширения без системного ПО недостаточно.
- Поддержка носителя: драйвер, библиотека или клиент изготовителя, если они нужны вашей модели и конфигурации.
- Откройте официальную страницу установки КриптоПро и выберите комплект для своей ОС.
- Проверьте уже установленное ПО. Свежий объединённый установщик включает CSP, плагин и расширение; отдельно устанавливайте только недостающие компоненты по инструкции изготовителя.
- Для носителя используйте подходящую инструкцию: Рутокен или JaCarta. Состав пакетов и порядок установки зависят от модели и версий. Не устанавливайте драйверы всех носителей подряд.
- Выполните установку. Перезагрузите компьютер, если этого требует установщик.
- Откройте «Инструменты КриптоПро», вкладку «Общее», и проверьте лицензию CSP. При необходимости введите серийный номер имеющейся лицензии по инструкции активации.
Browser plug-in распространяется бесплатно, но это не заменяет лицензию CSP. КриптоПро предлагает ознакомительный период CSP на 90 дней; дальнейшее использование зависит от вашей лицензии и конфигурации. Условия уточняйте у изготовителя.
Если рабочее место уже настроено на другой криптопровайдер, согласуйте изменения с ответственным специалистом. Провайдеры и форматы контейнеров нельзя считать взаимозаменяемыми; эта последовательность описывает основной вариант с КриптоПро CSP.
Установить личный сертификат
Сертификат содержит сведения о владельце, открытом ключе и сроке действия. Закрытый ключ создаёт подпись и должен оставаться доступным через свой контейнер. Установка сертификата создаёт нужную связь с ключом, но не копирует ключ в TesLab.
В Windows: через «КриптоПро CSP»
Подключите свой носитель. Следующие иллюстрации показывают классический интерфейс CSP в Windows; подписи и расположение элементов могут отличаться в вашей версии.
- Откройте меню «Пуск», введите в поиске КриптоПро CSP и запустите найденную программу. Её также можно открыть через «Панель управления».

В поиске Windows откройте именно «КриптоПро CSP». Управление лицензиями PKI является другой программой. - Перейдите на вкладку «Сервис» и нажмите «Просмотреть сертификаты в контейнере…». Откроется мастер «Сертификаты в контейнере закрытого ключа».

«Сервис» открывает мастер просмотра сертификатов. «Обзор» выбирает контейнер; «По сертификату» подходит, когда личный сертификат уже установлен. - Для первой установки нажмите «Обзор», выберите свой контейнер на подключённом носителе и подтвердите выбор. В обычной пользовательской настройке используйте контейнер пользователя. Если контейнер не найден, сначала проверьте подключение, поддержку носителя и соответствие выбранного CSP вашему ключу.
- Если сертификат уже есть в хранилище «Личное»: вместо поиска через «Обзор» можно нажать «По сертификату…». Выберите свой сертификат, при необходимости раскройте «Больше вариантов», затем нажмите «ОК». Этот дополнительный путь не поможет, если сертификат ещё не установлен в личное хранилище.

Дополнительный путь «По сертификату»: выберите свой сертификат из хранилища «Личное». Если доступно «Больше вариантов», откройте весь список. - Убедитесь, что в поле «Имя ключевого контейнера» появился путь именно вашего контейнера. Провайдер в поле «Выберите CSP для поиска ключевых контейнеров» должен соответствовать вашему ключу, а не просто повторять значение с иллюстрации. Нажмите «Далее».

После выбора в поле появляется путь контейнера вашего носителя. Не переписывайте путь с иллюстрации, затем нажмите «Далее». - В следующем окне проверьте владельца и срок сертификата. При необходимости откройте «Свойства». Нажмите «Установить» и дождитесь результата. Если мастер предлагает выбрать хранилище, используйте «Личное» текущего пользователя. После успешного завершения нажмите «Готово».

Сверьте владельца и срок действия, затем нажмите «Установить». После успешной установки завершите мастер кнопкой «Готово».
Этот порядок также показан в примере мастера установки из контейнера у КриптоПро. Для браузера настройку выполняйте в учётной записи ОС того пользователя, который будет подписывать документы.
Альтернативный путь: «Инструменты КриптоПро»
- Откройте «Инструменты КриптоПро» и раздел «Контейнеры».
- Дождитесь списка контейнеров, выберите свой носитель и нужный контейнер. Сверьте сведения сертификата.
- Нажмите «Установить сертификат» и дождитесь сообщения о завершении. Название действия может немного отличаться в вашей сборке.
- Откройте раздел «Сертификаты», выберите хранилище «Личное» и проверьте установленный сертификат. Затем выполните диагностику в браузере по следующему разделу статьи.
Если УЦ выдал отдельный файл сертификата
В классическом CSP откройте «Сервис» и «Установить личный сертификат…». Выберите выданный УЦ файл, проверьте сведения и свяжите сертификат с соответствующим существующим контейнером закрытого ключа. Завершите мастер установки в личное хранилище текущего пользователя.
Файл .cer не восстанавливает отсутствующий закрытый ключ. Если нужного контейнера нет, остановитесь и выясните, где хранится ваш ключ. Не загружайте ключ в обычные вложения TesLab и не переносите его с защищённого носителя на компьютер ради этой настройки.
Проверьте сведения о сертификате и его связь с ключом. При ошибке цепочки получите нужные корневой и промежуточные сертификаты из официального источника вашего УЦ. Личный сертификат не следует помещать в доверенные корневые. Для работы с собственным сертификатом не требуется корень тестового УЦ с диагностической страницы.
Включить расширение браузера
После установки системного ПО откройте тот браузер и профиль браузера, где будете работать в TesLab. Проверьте, что расширение КриптоПро установлено и включено.
- Chrome и Edge: откройте меню «Расширения», затем управление расширениями. Для Chrome 139 и новее старое расширение 1.2.x не подходит. Если магазин недоступен, устанавливайте актуальное расширение из файла только по официальной инструкции КриптоПро.
- Firefox: установите расширение по ссылке из инструкции изготовителя, подтвердите добавление и проверьте включение.
- Chromium-Gost и Яндекс Браузер для организаций: КриптоПро предлагает их как варианты без отдельной настройки расширения после установки комплекта.
Если корпоративная политика запрещает установку или включение расширения, обратитесь к администратору. После изменения установки полностью закройте и снова откройте браузер. При переходе в другой профиль браузера ещё раз проверьте расширение.
Особенности macOS и Linux
macOS: установите подходящий комплект CSP и поддержку своего носителя, затем личный сертификат в пользовательское хранилище CSP. При работе в Safari активируйте расширение в настройках Safari, в разделе расширений; при необходимости откройте приложение CryptoPro_ECP. Пользуйтесь инструкцией для macOS.
Linux: выберите комплект под дистрибутив и архитектуру, установите требуемые пакеты CSP и поддержку носителя, настройте расширение браузера. Сертификат должен быть доступен пользователю, запускающему браузер. Названия пакетов и команды приведены в инструкции для Linux. Шаги мастера Windows к этой ОС не относятся.
Проверить компоненты и доступ к ключу
- Подключите носитель и в рабочем браузере откройте официальную диагностику КриптоПро.
- Проверьте состояния расширения, плагина и CSP. При отказе следуйте подсказке именно того компонента, который не работает.
- Убедитесь, что доступен ваш сертификат. Проверьте владельца и срок.
- При необходимости выполните предусмотренное страницей тестовое подписание понятного текста своим сертификатом. До подтверждения прочитайте, какие данные будут подписаны.
Появление сертификата в списке ещё не доказывает доступ к закрытому ключу. Успешное тестовое подписание проверяет этот доступ, но не заменяет привязку в TesLab и проверку конкретного документа на сервере.
Разрешить обращение с сайта TesLab
При обращении TesLab к сертификатам или ключу компонент может попросить разрешение. Сверьте адрес сайта с открытым приложением и разрешите нужную операцию.
Постоянное добавление сайта в доверенные не является обязательным шагом. Если оно нужно и разрешено организацией, настройте конкретный адрес приложения:
- В браузере, где открыт TesLab, раскройте меню расширения КриптоПро и выберите «Настройка доверенных сайтов». Откроется страница настроек CAdES Browser Plugin.
- Возьмите адрес из адресной строки приложения. Оставьте HTTPS, имя сайта и порт, если он указан, без пути страницы, параметров и фрагмента после
#. Например, для открытогоhttps://x.teslab.ru/system/myукажитеhttps://x.teslab.ru. Адрес приложения и адрес сервера лаборатории могут различаться. - Введите этот адрес в поле «Добавить новый» и нажмите кнопку «+».

Пример для приложения, открытого на x.teslab.ru. После ввода адреса нажмите «+», чтобы добавить его в список. - Проверьте, что адрес появился отдельной строкой в списке. Если ошиблись, удалите неверную строку кнопкой «×» и добавьте правильную.
- Нажмите «Сохранить» и дождитесь сообщения об успешном сохранении.

Убедитесь, что адрес появился отдельной строкой, затем нажмите «Сохранить». Ввод адреса и нажатие «+» ещё не завершают настройку. - Вернитесь в TesLab и повторите обращение к своему сертификату. При работе с другого адреса приложения настройку проверяют отдельно.
Добавляйте только нужный адрес, а не все поддомены TesLab одной маской. Если список задан или заблокирован корпоративной политикой, обратитесь к администратору.
Доверенный узел перестаёт вызывать соответствующие вопросы плагина об обращении к сертификатам и ключам. Эта настройка не заменяет PIN носителя. Описание разрешений и доверенных узлов.
Привязать свой сертификат
- Войдите в TesLab под своей учётной записью привычным способом.
- Откройте «Мой профиль», затем строку «Электронная подпись». До привязки её статус показывает «Нет».
- Дождитесь обращения к КриптоПро и появления окна выбора.
- Выберите свой сертификат. Для проверки серийного номера, владельца, срока и УЦ нажмите кнопку «i» в карточке.
- Подтвердите выбор. Для привязки TesLab создаёт служебную подпись выбранным ключом; при необходимости подтвердите обращение к ключу и введите PIN в криптографическом окне.
- Дождитесь сообщения «Сертификат привязан», затем проверьте статус «Привязана» в профиле.


Даже единственный сертификат при привязке нужно явно подтвердить. Отмена выбора не создаёт связь. Привязка подтверждает доступ к выбранному ключу и связывает сертификат с профилем, но не подписывает протоколы и не проверяет полномочия для них.
Проверить существующую привязку
Откройте строку «Электронная подпись» со статусом «Привязана». В окне показан серийный номер, а при доступности сертификата на этом компьютере также его сведения и срок. Доступны действия «Загрузить новую подпись» и «Отвязать подпись».

Если сертификат установлен в личном хранилище, но его срок истёк, окно сообщает о недействительности. Если сертификат не найден или компонент недоступен, привязка на сервере может сохраняться. Сначала проверьте рабочее место и носитель, не удаляйте связь автоматически.
При подписании протокола существующая привязка ограничивает выбор соответствующим сертификатом. Если он недоступен, подключите его носитель или замените привязку. Без привязки выбор сертификата при подписании может оставаться доступным, но для входа по сертификату нужна связь с профилем.
Заменить сертификат после перевыпуска
- Установите новый сертификат на рабочем месте и проверьте его ключ.
- Откройте «Мой профиль», «Электронная подпись», «Загрузить новую подпись».
- Явно выберите новый сертификат, сверив владельца, срок и серийный номер.
- Дождитесь служебного подписания и сообщения «Сертификат заменён». Повторно проверьте окно управления.
Название кнопки означает выбор другого сертификата и замену связи. Загружать файл .sig не требуется. Предварительно отвязывать прежний сертификат не нужно.
«Отвязать подпись» удаляет связь с профилем для входа. Это действие не отзывает сертификат в УЦ, не удаляет ключ с носителя и не снимает ранее поставленные подписи документов.
Разобраться с отказом
- Расширение не загружено: проверьте браузер, его профиль, включение и актуальность расширения, корпоративные ограничения.
- Расширение есть, плагин или CSP недоступен: проверьте системное ПО и перезапуск браузера. Одной переустановки расширения может быть недостаточно.
- Сертификаты не найдены: проверьте носитель, установку сертификата в личное хранилище текущего пользователя и срок действия. Сертификат с истёкшим или ещё не начавшимся сроком не предлагается для обычного подписания в браузере.
- Сертификат виден, подпись не создаётся: проверьте связь с контейнером, нужный носитель, драйвер, лицензию CSP и PIN. При блокировке носителя обратитесь к ответственному специалисту, не подбирайте PIN и не инициализируйте устройство.
- Ошибка цепочки или статуса отзыва: проверьте сертификаты УЦ, доступ к его сервисам, дату и время компьютера. Не отключайте проверку сертификатов ради обхода ошибки.
- Привязанный сертификат не найден: проверьте именно его носитель и факт перевыпуска. После перевыпуска замените связь на новый сертификат.
- «Этот сертификат уже используется»: он связан с другим сотрудником. Проверьте учётную запись, не привязывайте чужой сертификат.
- «Вы уже привязали этот сертификат»: повторная регистрация того же сертификата не нужна. Проверьте существующую связь.
- Диагностика проходит, TesLab отклоняет регистрацию или проверку: сохраните точный ответ сервера. Возможна проблема сети или серверного сервиса проверки, переустановка CSP на ПК не всегда поможет.
- Привязка успешна, протокол отклонён: отдельно проверьте совпадение СНИЛС, назначение подписантом, включение электронной подписи и состояние документа.
При смене учётной записи или сервера повторно откройте профиль и начните действие заново. Если связь прервалась после отправки, перед повтором проверьте фактическую привязку. Для поддержки подготовьте текст ошибки, этап операции, ОС, браузер и версии компонентов. Не передавайте PIN, пароли или закрытый ключ.
Проверить готовность
- Компоненты отвечают в выбранном браузере.
- Свой сертификат установлен, действует и имеет доступ к ключу.
- В TesLab открыта собственная учётная запись, сведения и результат привязки проверены.
- Для конкретного протокола выполнены условия подписания: функция включена, назначение и состояние документа подходят.
СНИЛС проверяется при серверной проверке подписи протокола. Сообщение об успешной привязке само по себе эту проверку не заменяет.
Далее: Подписание протоколов личной ЭЦП. Параметры лаборатории описаны в статье Настройки электронного подписания протоколов. Вернуться к оглавлению специалиста ИЛ.