Отладочный режим электронной подписи
Примечание
Доступно только в Enterprise версии.
Предупреждение
Режим предназначен исключительно для стендов разработки и тестирования. Подпись, полученная в этом режиме, не является усиленной квалифицированной подписью и не имеет юридической значимости. На продуктивном стенде режим должен быть выключен.
Зачем нужен
Штатное подписание работает через КриптоПро ЭЦП Browser plug-in и ключ в криптопровайдере на машине пользователя. На машине разработчика такого ключа обычно нет, и получить его непросто: закрытый ключ ГОСТ должен быть создан внутри самого КриптоПро, импортировать его извне нельзя.
Из-за этого любой сценарий, где встречается подписание, не деградирует, а блокируется целиком: процесс невозможно провести дальше шага подписи. Отладочный режим подменяет только криптографическую операцию — диалог выбора сертификата, запрос дайджеста, отправка подписи на сервер и обработка ошибок выполняются своим обычным путём.
Режимы
Поведение задаётся конфигурацией Citeck с идентификатором esign-dev-mode приложения edi (полный ключ — app/edi$esign-dev-mode). Значение — JSON:
|
Поведение |
|---|---|
|
Значение по умолчанию. Штатное подписание через КриптоПро. |
|
Сертификаты синтетические, подпись — маркерная строка. Криптографии нет вообще, внешние сервисы не вызываются. Годится, чтобы пройти процесс насквозь, но разобрать такую подпись платформа не сможет. |
|
Сертификаты и подпись берутся у симулятора ЭДО. Подпись — настоящая отсоединённая CMS, платформа разбирает её и заполняет владельца, серийный номер, издателя и срок действия сертификата. |
Для режима remote дополнительно задаётся url — адрес административного API
симулятора.
{
"mode": "remote",
"url": "/gateway/edi-sim/admin/api"
}
Важно
url обязан быть путём того же источника — как правило, маршрутом gateway.
Абсолютный адрес отвергается с ошибкой: в запросе на подписание уходит содержимое документа, а не его хэш, и вместе с ним — cookie сессии пользователя. Указание
внешнего хоста означало бы передачу и того, и другого на чужой сервер.
Чтобы адрес вида /gateway/edi-sim/… работал, симулятор должен быть зарегистрирован в ECOS.
Изменение значения
Артефакт конфигурации поставляется вместе с микросервисом ecos-edi со значением off.
Значение меняется в журнале конфигураций Citeck, либо патчем:
id: esign-dev-mode-remote
name:
ru: Включить отладочный режим ЭП
en: Enable e-signature debug mode
target: app/config$app/edi$esign-dev-mode
type: json
config:
operations:
- { op: set, path: '$.value', value: { mode: remote, url: '/gateway/edi-sim/admin/api' } }
Примечание
Значения конфигураций кешируются в браузере, поэтому изменение подхватывается не мгновенно — обновите страницу, если новое значение ещё не применилось.
Как это выглядит для пользователя
Режим не маскируется под обычное подписание:
при первом обращении к подписанию на странице показывается предупреждение с указанием включённого режима;
в диалоге выбора сертификата выводится баннер с тем же предупреждением;
сертификаты в списке помечены — в наименовании владельца добавлено «(отладка)», в издателе и криптопровайдере указано, что это отладочный источник.
Ограничения
Методы, которые режим не может подменить осмысленно (
signXml,getHash,signHash, работа с файлами), возвращают явную ошибку, а не правдоподобный результат.Локальная проверка подписи всегда успешна: проверять нечего.
В режиме
stubподпись не является криптографической — платформа не сможет извлечь из неё данные сертификата.Список сертификатов фильтруется по сроку действия — так же, как это делает настоящий плагин. Истёкший или ещё не вступивший в силу сертификат в диалоге выбора не появится.
Подписание заведомо невалидным сертификатом
Если по сценарию нужен именно просроченный сертификат, он выбирается явно — тем же способом, что и в штатном режиме: вызывающая сторона передаёт отпечаток нужного
сертификата, и тогда фильтр по сроку не применяется. В режиме remote отпечатком выступает идентификатор сертификата в симуляторе.
Учтите при планировании проверок: на пути подписания из интерфейса платформа не вычисляет признаки isSignValid и isCertificateValid — они заполняются только для подписей,
полученных от провайдера ЭДО. Поэтому содержательная негативная проверка ставится с другой стороны: подпись создаётся действием симулятора с указанием просроченного
сертификата и приходит в Citeck штатным путём приёма документов.