МенеджерКриптографии.НачатьПодписывание (CryptoManager.BeginSigning)

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

НачатьПодписывание (BeginSigning)

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

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

Синтаксис:

НачатьПодписывание(<ОписаниеОповещения>, <ИсходныеДанные>, <Сертификат>, <ТипПодписи>)

Параметры:

<ОписаниеОповещения> (обязательный)

Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения подписывания данных со следующими параметрами:

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

<ИсходныеДанные> (обязательный)

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

<Сертификат> (необязательный)

Тип: СертификатКриптографии.
Используемый сертификат криптографии.
Если параметр не указан, то в хранилище персональных сертификатов должен быть ровно один сертификат. В противном случае генерируется исключительная ситуация, указанная в объекте ОписаниеОповещения.

<ТипПодписи> (необязательный)

Тип: ТипПодписиКриптографии.
Тип подписи криптографии.
Методы, отвечающие за установку подписи, поддерживают только следующие типы подписей:

CMS (CMS) ,
CAdESBES (CAdESBES) ,
CAdEST (CAdEST) ,
CAdESC (CAdESC) ,
CAdESXLongType2 (CAdESXLongType2) ,
CAdESAv3 (CAdESAv3) .

Значение по умолчанию: CAdESBES.

Описание варианта метода:

Начинает создание подписи в формате CMS (базируется на PKCS#7) и возвращает ее как ДвоичныеДанные или сохраняет ее в файл.
Подпись создается алгоритмами, которые заданы свойствами АлгоритмХеширования и АлгоритмПодписи.
В данные подписи исходный файл не включается.
В данные подписи могут быть включены сертификаты, в зависимости от свойства ВключениеСертификатовВПодпись.
Если сертификат не указан, то для подписи используется единственный установленный персональный сертификат.
По завершении будет вызвана процедура, указанная в ОписаниеОповещения. Процедура должна иметь параметры:

<ПодписанныеДанные> - помещается подписанные данные типа ДвоичныеДанные.
<ДополнительныеПараметры>.

Вариант синтаксиса: Сохранение данных в файл

Синтаксис:

НачатьПодписывание(<ОписаниеОповещения>, <ИсходныеДанные>, <ВыходныеДанные>, <Сертификат>, <ТипПодписи>)

Параметры:

<ОписаниеОповещения> (обязательный)

Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения подписания данных со следующими параметрами:

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

<ИсходныеДанные> (обязательный)

<ВыходныеДанные> (обязательный)

Тип: Строка.
Имя файла, в который будут выгружены данные подписи.

<Сертификат> (необязательный)

<ТипПодписи> (необязательный)

CMS (CMS) ,
CAdESBES (CAdESBES) ,
CAdEST (CAdEST) ,
CAdESC (CAdESC) ,
CAdESXLongType2 (CAdESXLongType2) ,
CAdESAv3 (CAdESAv3) .

Значение по умолчанию: CAdESBES.

Описание варианта метода:

Данные подписи записываются в файл.

Описание:

Создает подпись в формате CMS (базируется на PKCS#7) и возвращает ее как ДвоичныеДанные или сохраняет ее в файл.
Подпись создается алгоритмами, которые заданы свойствами АлгоритмХеширования и АлгоритмПодписи.
В данные подписи исходный файл не включается.
В данные подписи могут быть включены сертификаты, в зависимости от свойства ВключениеСертификатовВПодпись.
Если сертификат не указан, то для подписи используется единственный установленный персональный сертификат.
По завершении будет вызвана процедура, указанная в параметре &ОписаниеОповещения.

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

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

См. также:

МенеджерКриптографии, метод Подписать
МенеджерКриптографии, метод ПодписатьАсинх

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

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

Описание изменено в версии 8.3.21.

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