ЭЦП по гостам Украины в 1С - Внешняя компонента BilboSign.dll

Bilbosign.dll по сути является адаптером комплекса "IIT Користувач ЦСК", который разработан АТ "ІІТ", и сейчас широко используется всеми системами, использующими ЭЦП. Функционал комплекса "Користувач центру сертифікації ключів" описан на сайте производителя.

Компонента работает на сервере и на клиенте. Опыт успешного использования - 3 года.

Поскольку работа с ЭЦП - для многих мутная тема, разработана демо-база 1С,  которую вы можете скачать ниже.
В конфигурацию встроены все необходимые компоненты для работы.
Читайте справочную информацию в конфигурации, там постарался подробно описать что к чему и как.

Описание некоторых свойств и методов библиотеки Bilbosign.dll

Подробное описание приведено во встроенной справке, здесь же я приведу только синтаксис  и описания некоторых основных функций.

Свойства
БиблиотекаИнициализирована (IsInitialized)
Описание: Тип: Булево. При первой загрузке = Ложь, после инициализации библиотеки = Истина

АвтономныйРежим (OfflineMode)
Описание: Тип: Булево. Содержит признак использования библиотеки в Ofline-режиме (без подключения к серверам АЦСК)

ЛичныйКлючСчитан (IsPrivateKeyReaded)
Описание: Тип: Булево. После успешного чтения личного ключа = Истина

НеобходимоУстановитьПараметры (NeedSetSettings)
Описание: Тип: Булево. Содержит признак необходимости выполнить установку параметров работы библиотеки.
Если инициализация компоненты выполняется впервые, то значение = Истина

Методы

Инициализировать (Initialize)
Синтаксис: Инициализировать()
Описание: Инициализирует работу EUSignCP.dll. Результат инициализации можно проверить через свойство БиблиотекаИнициализирована (IsInitialized)

ЗавершитьРаботу (Finalize)
Синтаксис: ЗавершитьРаботу()
Описание: Завершает работу EUSignCP.dll и выгружает её из памяти. Желательно завершать работу компоненты, если в ней больше нет необходимости.

ПолучитьОписаниеОшибки (GetErrorDescription)
Синтаксис: ПолучитьОписаниеОшибки(<КодОшибки>, <Язык>)
Описание: Возвращает локализованное представление ошибки по коду.

УстановитьНастройки (SetSettings)
Синтаксис: УстановитьНастройки()
Описание: Установка параметров работы с библиотекой с помощью графического интерфейса библиотеки.

ПоказатьСертификаты (ShowCertificates)
Синтаксис: ПоказатьСертификаты()
Описание:Отображение сертификатов из файлового хранилища с помощью графического интерфейса библиотеки.

ПоказатьСпискиОтозванныхСертификатов (ShowCRLs)
Синтаксис: ПоказатьСпискиОтозванныхСертификатов()
Описание:Отображение списков отозванных сертификатов из файлового хранилища с помощью графического интерфейса библиотеки.

ОпределитьПараметрыНосителяЛичногоКлюча (GetPrivateKeyMedia)
Синтаксис: ОпределитьПараметрыНосителяЛичногоКлюча(<ТипНосителя>, <Устройство>, <Пароль>)
Описание: Вызывает интерактивный выбор носителя ключа и ввод пароля при помощи графического интерфейса.
Работает только на клиенте. Используется обычно перед вызовом функции СчитатьЛичныйКлюч

СчитатьЛичныйКлюч (ReadPrivateKey)
Синтаксис: СчитатьЛичныйКлюч(<ТипНосителя>, <Устройство>, <Пароль>, <ДанныеСертификата>)
Описание: Выполняет чтение личного ключа с указанного носителя.

СчитатьЛичныйКлючИзДвоичныхДанных (ReadPrivateKeyBinary)
Синтаксис: СчитатьЛичныйКлючИзДвоичныхДанных(<ДвоичныеДанные>, <Пароль>, <ДанныеСертификата>)
Описание: Выполняет чтение личного ключа в виде двоичных данных.

СчитатьЛичныйКлючИзФайла (ReadPrivateKeyFile)
Синтаксис: СчитатьЛичныйКлючИзФайла(<ИмяФайла>, <Пароль>, <ДанныеСертификата>)
Описание: Выполняет чтение личного ключа из указанного файла.

СброситьЛичныйКлюч (ResetPrivateKey)
Синтаксис: СброситьЛичныйКлюч()
Описание: Стирает личный ключ из оперативной памяти

ПолучитьИнформациюОСертификате (GetCertificateInfo)
Синтаксис: ПолучитьИнформациюОСертификате(<Издатель>, <СерийныйНомер>, <ДанныеСертификата>)
Описание: По указанному издателю и серийному номеру сертификата получает полную информацию о сертификате.

УстановитьПараметрыФайловогоХранилища (SetFileStoreSettings)
Описание: Устанавливает текущие настройки файлового хранилища

УстановитьПараметрыOCSPСервера (SetOCSPSettings)
Описание: Устанавливает текущие настройки OCSP-сервера

УстановитьПараметрыTSPСервера (SetTSPSettings)
Описание: Устанавливает текущие настройки TSP-сервера

УстановитьПараметрыLDAPСервера (SetLDAPSettings)
Описание: Устанавливает текущие настройки LDAP-сервера

УстановитьПараметрыCMPСервера (SetCMPSettings)
Описание: Устанавливает текущие настройки CMP-сервера

Base64Кодировать (BASE64Encode)
Синтаксис: Base64Кодировать(<ИсходныеДанные>, <СтрокаBase64>)
Описание: Получает строку, закодированную по алгоритму base64.

Base64Раскодировать (BASE64Decode)
Синтаксис: Base64Раскодировать(<СтрокаBase64>), <ИсходныеДанные>)
Описание: Получает из строки закодированной по алгоритму base64 двоичные данные.

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

ПроверитьПодписьФайла (VerifyFile)
Синтаксис: ПроверитьПодписьФайла(<ИмяФайлаСПодписью>, <ИмяФайлаСДанными>, <ДанныеПодписи>)
Описание: Проверка внешней или внутренней подписи для файла.

ПодписатьФайлУпрощенно (RawSignFile)
Синтаксис: ПодписатьФайлУпрощенно(<ИмяФайлаСДанными>, <ИмяФайлаСПодписью>)
Описание: Формирование упрощенной подписи для файла.

ПроверитьУпрощеннуюПодписьФайла (RawVerifyFile)
Синтаксис: ПроверитьУпрощеннуюПодписьФайла(<ИмяФайлаСПодписью>, <ИмяФайлаСДанными>, <ДанныеПодписи>)
Описание: Проверка упрощенной подписи для файла.

ПодписатьДанные (SignData)
Синтаксис: ПодписатьДанные(<ИсходныеДанные>, <Подпись>)
Описание: Формирование внешней подписи в виде двоичных данных для строки или двоичных данных.

ПроверитьПодписьДанных (VerifyData)
Синтаксис: ПроверитьПодписьДанных(<ИсходныеДанные>, <Подпись>, <ДанныеПодписи>)
Описание: Проверка внешней подписи в виде двоичных данных для строки или двоичных данных.

ПодписатьДанныеBase64 (SignDataBase64)
Синтаксис: ПодписатьДанныеBase64(<ИсходныеДанные>, <Подпись>)
Описание: Формирование внешней подписи в формате Base64 для строки или двоичных данных.

ПроверитьПодписьДанныхBase64 (VerifyDataBase64)
Синтаксис: ПроверитьПодписьДанныхBase64(<ИсходныеДанные>, <Подпись>, <ДанныеПодписи>)
Описание: Проверка внешней подписи в виде строки Base64 для строки или двоичных данных.

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

ПроверитьВнутреннююПодписьДанных (VerifyDataInternal)
Синтаксис: ПроверитьВнутреннююПодписьДанных(<ПодписанныеДанные>, <ИсходныеДанные>, <ДанныеПодписи>)
Описание: Проверка внутренней подписи для двоичных данных.

ПроверитьВнутреннююПодписьДанныхСтрока (VerifyDataInternalStr)
Синтаксис: ПроверитьВнутреннююПодписьДанныхСтрока(<ПодписанныеДанные>, <ИсходныеДанные>, <ДанныеПодписи>)
Описание: Проверка внутренней подписи для строковых данных. Имеет смысл для работы с обычными текстовыми данными (например, xml, json)

ПодписатьДанныеВнутреннейПодписьюBase64 (SignDataInternalBase64)
Синтаксис: ПодписатьДанныеВнутреннейПодписьюBase64(<ВключатьСертификат>, <ИсходныеДанные>, <ПодписанныеДанные>)
Описание: Формирование внутренней подписи в виде Base64-строки для строки или двоичных данных.

ПроверитьВнутреннююПодписьДанныхBase64 (VerifyDataInternalBase64)
Синтаксис: ПроверитьВнутреннююПодписьДанныхBase64(<ПодписанныеДанные>, <ИсходныеДанные>, <ДанныеПодписи>)
Описание: Проверка внутренней подписи для данных в виде Base64-строки.

ПроверитьВнутреннююПодписьДанныхBase64Строка (VerifyDataInternalBase64Str)
Синтаксис: ПроверитьВнутреннююПодписьДанныхBase64Строка(<ПодписанныеДанные>, <ИсходныеДанные>, <ДанныеПодписи>)
Описание: Проверка внутренней подписи для строковых данных в виде Base64-строки. Имеет смысл для работы с обычными текстовыми данными (например, xml, json)