Внешняя компонента ROM-HMAC

Библиотека входит в SDK для возможности интеграции с RESTfull-сервисами, использующих для авторизации OAuth, OAuth2 или собственные механизмы авторизации на базе HMAC

ROM-HMAC - внешняя компонента 1С:Предприятие 8.x, реализована по технологии Native API, в соответствии с рекомендациями 1С, изложенными в руководстве «Технология создания внешних компонент». Библиотека написана на языке C++.

ROM-HMAC реализует функциональность HMAC-хеширования для платформы 1С. Реализация HMAC выполнена в соответствии с RFC 2104.

Hash-based message authentication code

1.0.1 (stable)

История версий

Авторские права принадлежат Simplit, согласно международной конвенции о защите авторских прав

• 1С:Предприятие 8.1
• 1С:Предприятие 8.2 обычное приложение
• 1С:Предприятие 8.2, 8.3 управляемое приложение:
  • сервер,
  • толстый клиент,
  • тонкий клиент,

• Windows Server 2012
• Windows Server 2008
• Windows 10
• Windows 8
• Windows 7
• Windows Vista
• Windows XP SP3

• ХешФункция / HashFunction – (чтение/запись), (число), функция используемая для хеширования, по умолчанию 32772 (SHA-1)
• ПровайдерТип / ProviderType – (чтение/запись), (число), тип CSP (Crypto Service Provider), по умолчанию 1 (PROV_RSA_FULL)
• ПровайдерИмя / ProviderName – (чтение/запись), (строка), имя CSP (Crypto Service Provider), по умолчанию «Microsoft Enhanced Cryptographic Provider v1.0»
• Версия / Version – (чтение), (строка), версия внешней компоненты

• ХешСумма / HashSum (Key,Text,Format) - выполнить HMAC-хеширование, где
  • Key - (строка), (обязательный), ключ хеширования, допустимо пустое значение
  • Text - (строка), (обязательный) строка для хеширования, допустимо пустое значение
  • Format - (число), (необязательный) формат вывода результата, по умолчанию HEXRAW

Для хеширования ROM-HASH использует стандартные функции Windows CryptoAPI.

В параметре ХешФункция / HashFunction допустимо использовать значения, приведенные в таблице алгоритмов (MSDN)

Наиболее часто используемые хеш-функции:

Пример использования параметра ХешФункция

HMAC.ХешФункция=32780;

В параметре ПровайдерТип / ProviderType допустимо использовать значения, приведенные в по ссылке (MSDN)

Наиболее часто используемые типы провайдеров:

Пример использования параметра ПровайдерТип

HMAC.ПровайдерТип=1;

В параметре ПровайдерИмя / ProviderName допустимо использовать значения, приведенные в по ссылке (MSDN)

Наиболее часто используемые имена провайдеров:

Пример использования параметра ПровайдерИмя

HMAC.ПровайдерИмя="Microsoft Enhanced Cryptographic Provider v1.0";

Формат по умолчанию HEXRAW

Возможные варианты формата возвращаемого значения

Windows Server 2003 и Windows XP не поддерживают вывод в формате HEXRAW

Пример использования параметра ПровайдерИмя

HMAC.ПровайдерИмя="Microsoft Enhanced Cryptographic Provider v1.0";

//Пример подключения внешней компоненты из общего макета
АдресВнешнейКомпоненты="ОбщийМакет.ROM_HMAC";
Результат=ПодключитьВнешнююКомпоненту(АдресВнешнейКомпоненты,"Simplit",ТипВнешнейКомпоненты.Native);
Если Результат Тогда
	HMAC = Новый ("AddIn.Simplit.ROM-HMAC");
КонецЕсли;

УстановитьВнешнююКомпоненту(<Местоположение>); ПодключитьВнешнююКомпоненту(<Местоположение>, <Имя>, <Тип>) ;

//Пример подключения внешней компоненты из ZIP-архива, хранящегося в общем макете
АдресВнешнейКомпоненты="ОбщийМакет.ROM_HMAC_ZIP";
Результат=ПодключитьВнешнююКомпоненту(АдресВнешнейКомпоненты,"Simplit",ТипВнешнейКомпоненты.Native);
Если Не Результат Тогда
	УстановитьВнешнююКомпоненту(АдресВнешнейКомпоненты);
	Результат=ПодключитьВнешнююКомпоненту(АдресВнешнейКомпоненты,"Simplit",ТипВнешнейКомпоненты.Native);
КонецЕсли; 
Если Результат Тогда
	HMAC = Новый ("AddIn.Simplit.ROM-HMAC");
КонецЕсли; 

Ключ="key";
Значение="The quick brown fox jumps over the lazy dog";
 
ХешСумма=HMAC.ХешСумма(Ключ,Значение);
// de7c9b85b8b78aa6bc8a7a36f70a90701c9db4d9 

// PROV_RSA_AES
HMAC.ПровайдерТип=24;
 
// MS_ENH_RSA_AES_PROV 
HMAC.ПровайдерИмя="Microsoft Enhanced RSA and AES Cryptographic Provider";
 
// SHA-256 (32780)
HMAC.ХешФункция=32780;
 
Ключ="key";
Значение="The quick brown fox jumps over the lazy dog";
 
ХешСумма=HMAC.ХешСумма(Ключ,Значение);
// f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8 

// MD5 (32771) в качестве хеш-функции
HMAC.ХешФункция=32771;
 
// Base64 (1) в качестве формата возвращаемого значения
ФорматЗначения=1;
 
Ключ="key";
Значение="The quick brown fox jumps over the lazy dog";
 
ХешСумма=HMAC.ХешСумма(Ключ,Значение);
// gAcHE0Y+d0m5DC3CSRHidQ==