МенеджерКриптографии.НачатьДобавлениеАрхивнойМеткиВремени

Методы · BeginAddingArchiveTimestamp

Инициирует добавление в подпись архивной метки времени 3 версии. При добавлении метки выполняется обращение к серверам меток времени, указанным в поле АдресаСерверовМетокВремени. По завершении, будет вызвана процедура, указанная в <ОписанииОповещения>.

Синтаксис

НачатьДобавлениеАрхивнойМеткиВремени(<ОписаниеОповещения>, <Подпись>)
НачатьДобавлениеАрхивнойМеткиВремени(<ОписаниеОповещения>, <Подпись>, <ВыходныеДанные>)
Полное описание, параметры и ограничения

МенеджерКриптографии.НачатьДобавлениеАрхивнойМеткиВремени (CryptoManager.BeginAddingArchiveTimestamp)

МенеджерКриптографии (CryptoManager)

НачатьДобавлениеАрхивнойМеткиВремени (BeginAddingArchiveTimestamp)

Доступен, начиная с версии 8.3.20.

Вариант синтаксиса: Данные подписи в возвращаемом значении

Синтаксис:
НачатьДобавлениеАрхивнойМеткиВремени(<ОписаниеОповещения>, <Подпись>)
Параметры:

<ОписаниеОповещения> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения проверки подписи со следующими параметрами:
<ВыходныеДанные> - ДвоичныеДанные c результатом.

<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<Подпись> (обязательный)
Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Подпись может размещаться в файле (в этом случае указывается имя файла) или представлена как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.
Вариант синтаксиса: Данные подписи сохраняются в файл

Синтаксис:
НачатьДобавлениеАрхивнойМеткиВремени(<ОписаниеОповещения>, <Подпись>, <ВыходныеДанные>)
Параметры:

<ОписаниеОповещения> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения проверки подписи со следующими параметрами:
<ВыходныеДанные> - ДвоичныеДанные с результатом.

<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<Подпись> (обязательный)
Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Подпись может размещаться в файле (в этом случае указывается имя файла) или представлена как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.

<ВыходныеДанные> (обязательный)
Тип: Строка, Поток, ПотокВПамяти, ФайловыйПоток.
Имя файла или поток, в который будут выгружены данные подписи.
Описание:

Инициирует добавление в подпись архивной метки времени 3 версии.
При добавлении метки выполняется обращение к серверам меток времени, указанным в поле АдресаСерверовМетокВремени.

По завершении, будет вызвана процедура, указанная в <ОписанииОповещения>.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

См. также:
МенеджерКриптографии, метод ДобавитьАрхивнуюМеткуВремени
МенеджерКриптографии, метод ДобавитьАрхивнуюМеткуВремениАсинх

Использование в версии:

Доступен, начиная с версии 8.3.20.

Методическая информация

Практические примеры

Подпись: последовательные оповещения двух этапов

Обработчик усовершенствования получает двоичные данные и удержанный менеджер. Он начинает архивную метку только после завершения первого этапа.

Где и как запускать

Синтаксический пример для толстого клиента Windows в своей учебной форме. Фрагмент без процедуры вставляется в тело обработчика. Здесь компоненты, COM и криптография не запускались.

Подготовка

  1. В своём учебном Windows-приложении заранее установите поддерживаемый криптопровайдер. В коде выбран Microsoft Enhanced RSA and AES Cryptographic Provider с типом 24; если его нет, этот пример не подготовлен.

  2. Подготовьте собственную действительную подпись CAdES-BES в файле C:\УчебныеДанные\заказ.p7s. Для проверки метки используйте свою подпись CAdES-T с настоящей меткой. Произвольный текст с расширением p7s не является подписью.

  3. Для получения метки создайте строковый реквизит формы АдресСервераМеток и заполните действительным адресом разрешённого учебного TSA. Подготовьте доверие сертификатам и разрешение на обращение к этому сервису. Здесь сервис не вызывается.

  4. Все три процедуры находятся в одном модуле формы; в варианте без выходного файла обработчики получают ДвоичныеДанные.

&НаКлиенте
Процедура ДополнитьПодпись()
    Крипто = Новый МенеджерКриптографии("Microsoft Enhanced RSA and AES Cryptographic Provider", "", 24);
    Крипто.АдресаСерверовМетокВремени.Добавить(АдресСервераМеток);
    Оповещение = Новый ОписаниеОповещения("ПослеУсовершенствования", ЭтотОбъект, Крипто);
    Крипто.НачатьУсовершенствованиеПодписи(Оповещение, "C:\УчебныеДанные\заказ.p7s", ТипПодписиКриптографии.CAdEST);
КонецПроцедуры
&НаКлиенте
Процедура ПослеУсовершенствования(СМеткой, Крипто) Экспорт
    Сообщить("Получено байт: " + Строка(СМеткой.Размер()));
    Оповещение = Новый ОписаниеОповещения("ПослеАрхивнойМетки", ЭтотОбъект, "Учебная подпись");
    Крипто.НачатьДобавлениеАрхивнойМеткиВремени(Оповещение, СМеткой);
КонецПроцедуры
&НаКлиенте
Процедура ПослеАрхивнойМетки(Архивная, Название) Экспорт
    Сообщить(Название + ": " + Строка(Архивная.Размер()) + " байт");
КонецПроцедуры

Разбор по шагам

  1. Начните усовершенствование своей подписи с оповещением.

  2. В первом обработчике используйте реальный результат и ранее созданный менеджер.

  3. Во втором обработчике покажите реальный размер архивной подписи.

Как проверить результат

  1. Оба обработчика имеют два параметра по выбранным вариантам API.

  2. Второй этап не запускается сразу вслед за первым в исходной процедуре.

Ожидаемый результат

Показан синтаксис для указанной подготовки. Здесь код не запускался; реальные результаты и побочные эффекты проверяются только при будущем осознанном выполнении в своём учебном приложении.

На что обратить внимание

  1. Нельзя вручную вызывать обработчик с фиктивными байтами и считать это результатом криптографии.

  2. При ошибке TSA или подписи успешное завершение не обещается.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.