Асинхронная функция. Добавляет в подпись архивную метку времени версии 3. При добавлении метки выполняется обращение к серверам меток времени, указанным в поле АдресаСерверовМетокВремени. Для добавления архивной метки времени подпись должна иметь тип CAdES-BES или выше.
Синтаксис
ДобавитьАрхивнуюМеткуВремениАсинх(<Подпись>)ДобавитьАрхивнуюМеткуВремениАсинх(<Подпись>, <ВыходныеДанные>)Полное описание, параметры и ограничения
МенеджерКриптографии.ДобавитьАрхивнуюМеткуВремениАсинх (CryptoManager.AddArchiveTimestampAsync)
МенеджерКриптографии (CryptoManager)
ДобавитьАрхивнуюМеткуВремениАсинх (AddArchiveTimestampAsync)
Доступен, начиная с версии 8.3.20.
Вариант синтаксиса: Данные подписи в возвращаемом значении
Синтаксис:
ДобавитьАрхивнуюМеткуВремениАсинх(<Подпись>)
Параметры:
<Подпись> (обязательный)
Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Подпись может размещаться в файле (в этом случае указывается имя файла) или представлена как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.
Описание варианта метода:
Данные подписи возвращаются методом как Обещание с результатом ДвоичныеДанные.
Вариант синтаксиса: Данные подписи сохраняются в файл
Синтаксис:
ДобавитьАрхивнуюМеткуВремениАсинх(<Подпись>, <ВыходныеДанные>)
Параметры:
<Подпись> (обязательный)
Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Подпись может размещаться в файле (в этом случае указывается имя файла) или представлена как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.
<ВыходныеДанные> (обязательный)
Тип: Строка, Поток, ПотокВПамяти, ФайловыйПоток.
Имя файла или поток, в который будут выгружены данные подписи.
Если Неопределено, то результат работы метода вернется в возвращаемом значении типа ДвоичныеДанные.
Описание варианта метода:
Данные подписи записываются в файл. Возвращает Обещание с результатом Неопределено.
Возвращаемое значение:
Тип: Обещание.
Обещание. Результат выполнения обещания – двоичные данные подписи с добавленной архивной меткой времени (если ВыходныеДанные = Неопределено) иначе Неопределено.
Описание:
Асинхронная функция. Добавляет в подпись архивную метку времени версии 3.
При добавлении метки выполняется обращение к серверам меток времени, указанным в поле АдресаСерверовМетокВремени.
Для добавления архивной метки времени подпись должна иметь тип CAdES-BES или выше.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.20.
Методическая информация
Практические примеры
Подпись: дождаться усовершенствования и архивной метки
Асинхронные варианты возвращают Обещание. Следующий этап получает именно завершённый результат предыдущего.
Где и как запускать
Синтаксический пример для толстого клиента 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);
Архивная = Ждать Крипто.ДобавитьАрхивнуюМеткуВремениАсинх(СМеткой);
Сообщить("Байт с меткой: " + Строка(СМеткой.Размер()));
Сообщить("Байт с архивной меткой: " + Строка(Архивная.Размер()));
КонецПроцедурыРазбор по шагам
Вставьте полную асинхронную процедуру в свою форму толстого клиента.
Дождитесь усовершенствованной подписи.
Только затем передайте её в добавление архивной метки и дождитесь результата.
Как проверить результат
Оба результата получены через Ждать, а не остаются Обещанием.
При исключении следующая операция не считается выполненной.
Ожидаемый результат
Показан синтаксис для указанной подготовки. Здесь код не запускался; реальные результаты и побочные эффекты проверяются только при будущем осознанном выполнении в своём учебном приложении.
На что обратить внимание
Асинхронное выполнение не устраняет требования к криптопровайдеру, TSA и доверию.
Синхронный конструктор выбран для толстого клиента Windows; не переносите эту подготовку без изменений в веб-клиент.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.