Сервер КриптоПро в конфигурации TesLab

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

Сервер КриптоПро в конфигурации TesLab

Поле «Сервер КриптоПро» задаёт адрес службы, которой TesLab передаёт данные и электронную подпись для серверной проверки. Настройка общая: она участвует в проверке документов, входе по ЭЦП, привязке сертификата сотрудника и отдельных операциях усовершенствования подписи. Если сертификат не виден при выборе на компьютере, начните с носителя и программ рабочего места: смена серверного адреса не добавит сертификат в список.

В этой статье

Понять, относится ли ошибка к настройке

  • Сертификат не виден при выборе. Проверьте рабочее место по инструкции подготовки компьютера к электронной подписи.
  • Подпись передана, сервер вернул отказ. Проверяйте доступность службы, точную пару файлов и состояние сертификата.
  • Не получается войти по ЭЦП или привязать сертификат. Эти операции также используют серверную проверку. Запишите, на каком этапе получен отказ.

Настройка не устанавливает личный ключ, не создаёт недостающие подписи и не меняет изображения печатей. Смена адреса не запускает повторную проверку всех прежних документов.

Подготовить адрес и контрольный комплект

  1. Уточните у ответственного за криптографическую инфраструктуру или поддержки TesLab предусмотренный для установки обработчик.
  2. Получите полный адрес со схемой и необходимым путём. Сохраните прежнее значение и время изменения.
  3. Проверьте доступ к службе с сервера TesLab: сеть, DNS и доверие к TLS-сертификату. Открытие сайта на компьютере сотрудника не подтверждает доступность с сервера.
  4. Подготовьте исходный документ и созданный именно для него файл подписи SIG или SGN. После подписания исходный документ нельзя изменять или пересохранять в другом формате.

Возможны три варианта:

  • Пустое поле: локальный обработчик на сервере TesLab.
  • Центральный сервис TesLab: согласованный адрес приводится к стандартному обработчику. Произвольные путь, порт и параметры такого адреса не используются.
  • Собственный сервис: полный согласованный URL совместимого обработчика. Для внешней службы используйте HTTPS без логина, пароля и фрагмента #… в адресе. TesLab не дописывает к нему путь API. HTTP допустим только для специально настроенной службы на этом же сервере через localhost или loopback-адрес.

На указанный адрес отправляются проверяемые данные и подписи. Главная страница продукта КриптоПро или кабинет облачной подписи сами по себе не подтверждают совместимость с TesLab.

Сохранить и перечитать адрес

  1. Сотрудник с доступом к параметрам системы открывает «Компания → Конфигурация → TesLab → Внешние сервисы».
  2. В поле «Сервер КриптоПро» укажите согласованный адрес целиком. Удаление всего значения выбирает локальный обработчик.
  3. Выйдите из изменённого поля и дождитесь сообщения «Адрес сохранён». При нормализации центрального адреса поле покажет сохранённое значение.
  4. Нажмите «Перечитать» и сверьте адрес с ожидаемым. Затем выполните контрольную проверку подписи.
Адрес сервера КриптоПро, подтверждение сохранения и кнопка Перечитать
1. Полный адрес обработчика. 2. Подтверждение сохранения. 3. Независимое чтение значения. Сохранение адреса не проверяет подпись.

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

Использовать локальный обработчик

Очистка поля выбирает локальный обработчик, а не отключает контроль ЭЦП. На сервере должны быть установлены и настроены криптографические компоненты для PHP, доверенные сертификаты и доступ к необходимым службам проверки.

Перед очисткой запишите прежний адрес и уточните готовность локального обработчика. После изменения проверьте документ с подписью. Если сотрудники используют вход по ЭЦП или привязку сертификатов, отдельно проверьте и эти сценарии на согласованной учётной записи. Успех проверки одного документа не подтверждает все операции.

Проверить документ и подпись

  1. Откройте «Компания → ЭлектроПодпись» и выберите «Проверить подпись».
  2. Загрузите точный исходный документ. Нужен непустой файл размером до 30 МиБ.
  3. После сообщения «Документ загружен» добавьте относящийся к нему файл SIG или SGN, также до 30 МиБ.
  4. Прочитайте результат и отдельно состояние сертификата. Для проверки уже готовой пары личный закрытый ключ и ввод PIN не требуются.
Вкладка Проверить подпись и область загрузки исходного документа
1. Выберите «Проверить подпись». 2. Сначала загрузите исходный документ.
Документ загружен, следующий шаг предлагает файл подписи SIG или SGN
1. После загрузки документа добавьте соответствующий файл подписи.
  • «Подпись соответствует документу»: соответствие этой пары установлено. Дополнительно прочитайте результат проверки действительности сертификата.
  • «Подпись не соответствует документу»: проверьте версию исходника и выбранную подпись, запросите исходный комплект у отправителя.
  • «Проверка не завершена»: соответствие не установлено. Проверьте соединение и сообщение, повторите после устранения причины.
Результат проверки пары файлов и отдельное состояние сертификата
1. Соответствие подписи документу. 2. Действительность сертификата на момент проверки. Это два отдельных результата.

Подробности доступны в инструкции проверки электронной подписи по файлу SIG/SGN.

Разобрать отказ

  • Адрес не сохраняется: проверьте полный URL, HTTPS и отсутствие пробелов, встроенного логина или фрагмента. После конфликта перечитайте значение.
  • Нет связи или ответ не похож на результат проверки: ответственный проверяет URL обработчика, доступ с сервера, TLS и совместимость службы. Не заменяйте HTTPS на HTTP для удалённого сервиса.
  • Сервер сообщает об отсутствии криптопровайдера: нужна настройка серверных компонентов. Переустановка плагина на компьютерах сотрудников не устраняет такой отказ.
  • Подпись соответствует документу, сертификат не прошёл проверку: выясните срок, отзыв и доверие к цепочке сертификатов. Соответствие пары не является безусловным подтверждением действительности сертификата.

Что передать ответственному

Сохраните время операции, этап, текст сообщения, прежний и ожидаемый адреса, имена проверяемой пары и результат перечитывания настройки. Сопоставьте время с техническим журналом. Закрытый ключ и PIN в обращении не нужны. Например, после переноса сервера сначала сохраняют прежний адрес, вводят новый, перечитывают его и проверяют контрольный комплект.