Инициирует выполнение усовершенствования подписи в формате CAdES-BES. При создании усовершенствованной подписи выполняется обращение к серверам меток времени, адреса которых указаны в поле АдресаСерверовМетокВремени. Поддерживаемые форматы: CAdEST, CAdESC, CAdESXLongType2, CAdESAv3. По завершении будет вызвана процедура, указанная в <ОписаниеОповещения>.
Синтаксис
НачатьУсовершенствованиеПодписи(<ОписаниеОповещения>, <ИсходныеДанные>, <ТипПодписи>)НачатьУсовершенствованиеПодписи(<ОписаниеОповещения>, <ИсходныеДанные>, <ВыходныеДанные>, <ТипПодписи>)Примеры платформы
МенеджерКриптографии.НачатьУсовершенствованиеПодписи(
Оповещение, ПодписьCAdESBES, Результат, ТипПодписиКриптографии.CAdESXLongType2);Полное описание, параметры и ограничения
МенеджерКриптографии.НачатьУсовершенствованиеПодписи (CryptoManager.BeginEnhancingSignature)
МенеджерКриптографии (CryptoManager)
НачатьУсовершенствованиеПодписи (BeginEnhancingSignature)
Доступен, начиная с версии 8.3.20.
Вариант синтаксиса: Данные подписи в возвращаемом значении
Синтаксис:
НачатьУсовершенствованиеПодписи(<ОписаниеОповещения>, <ИсходныеДанные>, <ТипПодписи>)
Параметры:
<ОписаниеОповещения> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения усовершенствования со следующими параметрами:
<ВыходныеДанные> - помещаются данные усовершенствованной подписи типа ДвоичныеДанные.
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.
<ИсходныеДанные> (обязательный)
Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Исходные данные могут размещаться в файле (в этом случае указывается имя файла) или представлены как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.
<ТипПодписи> (необязательный)
Тип: ТипПодписиКриптографии.
Тип подписи криптографии.
Значение по умолчанию: CAdEST.
Описание варианта метода:
Данные подписи возвращаются методом как Обещание с результатом ДвоичныеДанные.
Вариант синтаксиса: Данные подписи сохраняются в файл
Синтаксис:
НачатьУсовершенствованиеПодписи(<ОписаниеОповещения>, <ИсходныеДанные>, <ВыходныеДанные>, <ТипПодписи>)
Параметры:
<ОписаниеОповещения> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения усовершенствования подписи со следующими параметрами:
<ИмяФайла> - имя файла, в который осуществлен вывод.
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.
<ИсходныеДанные> (обязательный)
Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Исходные данные могут размещаться в файле (в этом случае указывается имя файла) или представлены как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.
<ВыходныеДанные> (обязательный)
Тип: Строка, Поток, ПотокВПамяти, ФайловыйПоток.
Имя файла или поток, в который будут выгружены данные подписи.
<ТипПодписи> (необязательный)
Тип: ТипПодписиКриптографии.
Тип подписи криптографии.
Значение по умолчанию: CAdEST.
Описание варианта метода:
Данные подписи записываются в файл. Возвращает Обещание с результатом Неопределено
Описание:
Инициирует выполнение усовершенствования подписи в формате CAdES-BES.
При создании усовершенствованной подписи выполняется обращение к серверам меток времени, адреса которых указаны в поле АдресаСерверовМетокВремени.
Поддерживаемые форматы:
CAdEST,
CAdESC,
CAdESXLongType2,
CAdESAv3.
По завершении будет вызвана процедура, указанная в <ОписаниеОповещения>.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
МенеджерКриптографии.НачатьУсовершенствованиеПодписи(
Оповещение, ПодписьCAdESBES, Результат, ТипПодписиКриптографии.CAdESXLongType2);
Использование в версии:
Доступен, начиная с версии 8.3.20.
Описание изменено в версии 8.3.24.
Методическая информация
Практические примеры
Подпись: последовательные оповещения двух этапов
Обработчик усовершенствования получает двоичные данные и удержанный менеджер. Он начинает архивную метку только после завершения первого этапа.
Где и как запускать
Синтаксический пример для толстого клиента Windows в своей учебной форме. Фрагмент без процедуры вставляется в тело обработчика. Здесь компоненты, COM и криптография не запускались.
Подготовка
В своём учебном Windows-приложении заранее установите поддерживаемый криптопровайдер. В коде выбран Microsoft Enhanced RSA and AES Cryptographic Provider с типом 24; если его нет, этот пример не подготовлен.
Подготовьте собственную действительную подпись CAdES-BES в файле C:\УчебныеДанные\заказ.p7s. Для проверки метки используйте свою подпись CAdES-T с настоящей меткой. Произвольный текст с расширением p7s не является подписью.
Для получения метки создайте строковый реквизит формы АдресСервераМеток и заполните действительным адресом разрешённого учебного TSA. Подготовьте доверие сертификатам и разрешение на обращение к этому сервису. Здесь сервис не вызывается.
Все три процедуры находятся в одном модуле формы; в варианте без выходного файла обработчики получают ДвоичныеДанные.
&НаКлиенте
Процедура ДополнитьПодпись()
Крипто = Новый МенеджерКриптографии("Microsoft Enhanced RSA and AES Cryptographic Provider", "", 24);
Крипто.АдресаСерверовМетокВремени.Добавить(АдресСервераМеток);
Оповещение = Новый ОписаниеОповещения("ПослеУсовершенствования", ЭтотОбъект, Крипто);
Крипто.НачатьУсовершенствованиеПодписи(Оповещение, "C:\УчебныеДанные\заказ.p7s", ТипПодписиКриптографии.CAdEST);
КонецПроцедуры
&НаКлиенте
Процедура ПослеУсовершенствования(СМеткой, Крипто) Экспорт
Сообщить("Получено байт: " + Строка(СМеткой.Размер()));
Оповещение = Новый ОписаниеОповещения("ПослеАрхивнойМетки", ЭтотОбъект, "Учебная подпись");
Крипто.НачатьДобавлениеАрхивнойМеткиВремени(Оповещение, СМеткой);
КонецПроцедуры
&НаКлиенте
Процедура ПослеАрхивнойМетки(Архивная, Название) Экспорт
Сообщить(Название + ": " + Строка(Архивная.Размер()) + " байт");
КонецПроцедурыРазбор по шагам
Начните усовершенствование своей подписи с оповещением.
В первом обработчике используйте реальный результат и ранее созданный менеджер.
Во втором обработчике покажите реальный размер архивной подписи.
Как проверить результат
Оба обработчика имеют два параметра по выбранным вариантам API.
Второй этап не запускается сразу вслед за первым в исходной процедуре.
Ожидаемый результат
Показан синтаксис для указанной подготовки. Здесь код не запускался; реальные результаты и побочные эффекты проверяются только при будущем осознанном выполнении в своём учебном приложении.
На что обратить внимание
Нельзя вручную вызывать обработчик с фиктивными байтами и считать это результатом криптографии.
При ошибке TSA или подписи успешное завершение не обещается.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.