WMSignerFX

WMSigner для платформы .Net (библиотека WebMoney.Cryptography)

Данная статья предназначена для разработчиков, использующих интерфейсы WebMoney Transfer в Microsoft .Net/.Net Core приложениях. В статье описано как использовать с библиотеку WebMoney.Cryptography (кодовое имя библиотеки WMSignerFX).

Библиотека WebMoney.Cryptography используется для получения цифровой подписи сообщения закрытым ключом WM Keeper WinPro. Она реализована на управляемом (managed) языке (язык разработки C#) и не требует специальных прав для своей работы.

Текущая версия библиотеки 4.1.0.

Один и тот же класс Signer работает с ключами обеих схем: классической RSA и v2 (Ed25519). Схема выбирается перегрузкой метода Initialize или корневым элементом XML, но никогда не определяется по длине ключа.

Получение цифровой подписи сообщения с помощью библиотеки WebMoney.Cryptography

Пример получения подписи сообщения на языке C#:

using WebMoney.Cryptography
using System;

namespace WebMoney.Examination
{
    public class Program
    {
        static void Main(string[] args)
        {
            // xml-представление ключа WebMoney Keeper WinPro, полученное с помощью утилиты KeyExtractor
            string xmlKey = "<RSAKeyValue><Modulus>ccqACxNjlkI</Modulus><D>FW1RaQMqeIn8otCeHgD</D></RSAKeyValue>";

            Signer signer = new Signer();
            signer.Initialize(xmlKey);

            string signature = signer.Sign("message"); // подпись строки

            Console.WriteLine(signature);
        }
    }
}

Для запуска этого кода, необходимо добавить в проект ссылку на библиотеку WebMoney.Cryptography или подключить ее с помощью менеджера пакетов NuGet:

Install-Package WebMoney.Cryptography

При инициализации объекта класса Signer, используется представление ключа в XML-формате: <RSAKeyValue><Modulus>{0}</Modulus><D>{1}</D></RSAKeyValue>, где {0} и {1} — значение модуля и приватной экспоненты в формате Base64. Порядок байт little-endian.

Схемы ключей: RSA и v2 (Ed25519)

RSA (классический ключ) v2 (Ed25519)
Инициализация Initialize(KeeperKey), Initialize(xml) с корневым элементом <RSAKeyValue> Initialize(byte[] ed25519Seed), Initialize(xml) с корневым элементом <Ed25519KeyValue>
Кодировка сообщения Windows-1251 нормализация NFC, UTF-8 без BOM
Длина подписи 132 hex-символа 128 hex-символов
Повторная подпись того же сообщения другая (случайное дополнение) всегда одинаковая (детерминированная)

После инициализации свойство signer.IsV2 показывает, ключ какой схемы загружен.

Сообщение не должно содержать символ \r (для обеих схем).

Подпись ключом v2 (Ed25519)

Из XML-представления ключа (его можно получить утилитой KeyExtractor):

string xmlKey = "<Ed25519KeyValue><Seed>...</Seed></Ed25519KeyValue>";

using (Signer signer = new Signer())
{
    signer.Initialize(xmlKey);
    string signature = signer.Sign("message");   // 128 hex-символов, подпись детерминирована
}

Из seed (32 байта):

using (Signer signer = new Signer())
{
    signer.Initialize(ed25519Seed);              // byte[32]; signer.IsV2 == true
    string signature = signer.Sign("message");
}

// XML-представление того же ключа
string xmlKey = Signer.ToV2XmlString(ed25519Seed);

Подпись ключом из файла .kwm

Ключ расшифровывается из файла с помощью WMID и пароля. Пароль передается как байты в кодировке Windows-1251:

using WebMoney.Cryptography;

byte[] password = Encoding.GetEncoding(1251).GetBytes(passwordText);

using (DecryptedKey key = DecryptedKey.Decrypt(File.ReadAllBytes(kwmPath), wmid, password))
using (Signer signer = new Signer())
{
    signer.Initialize(key);
    string signature = signer.Sign(message);
}

Освобождение ресурсов

Классы KeeperKey, DecryptedKey и Signer реализуют IDisposable и при вызове Dispose затирают байты закрытого ключа в памяти, поэтому используйте их в блоке using. DecryptedKey принимает массивы во владение, поэтому передавайте ему копии.

Возможные исключения при инициализации объекта класса Signer:

  1. ArgumentNullException.
  2. ArgumentOutOfRangeException (пустая строка).
  3. XmlException — строка не в XML-формате.
  4. FormatException — узел Modulus или D не содержат строку в Base64 формате.
  5. CryptographicException — неверный формат XML-документа (см. выше) или длина ключа меньше 528 бит или modulus является четным числом.

Перечисленные исключения относятся к ключу RSA.

Возможные исключения при подписи строки (вызов метода Sign):

  1. ArgumentNullException.
  2. ArgumentException — строка содержит недопустимые символы ('\r' — недопустимый символ).
  3. InvalidOperationException — объект класса Signer не инициализирован. Перед использованием объект класса Signer нужно инициализировать, вызвав один из методов Initialize (см. описание выше).

Пример получения подписи сообщения на языке VBScript и JScript (для использования в гаджетах Windows Vista и Windows 7):

VBScript

Dim signer
Dim signature

Set signer = CreateObject("WebMoney.Cryptography.Signer")
signer.Initialize("<RSAKeyValue><Modulus>ccqACxNjlkI</Modulus><D>FW1RaQMqeIn8otCeHgD</D></RSAKeyValue>")

signature = signer.Sign("test")

Call MsgBox(signature)

JScript

var signer = WScript.CreateObject("WebMoney.Cryptography.Signer");
signer.Initialize("<RSAKeyValue><Modulus>ccqACxNjlkI</Modulus><D>FW1RaQMqeIn8otCeHgD</D></RSAKeyValue>");

var signature = signer.Sign("test");

WScript.Echo(signature);

Для запуска этого кода, необходимо зарегистрировать WebMoney.Cryptography как COM-компонент:

RegAsm.exe .\..\PUBLIC\v3.2-bin\WebMoney.Cryptography.dll \tlb
gacutil.exe /if .\..\PUBLIC\v3.2-bin\WebMoney.Cryptography.dll
gacutil.exe /if .\..\PUBLIC\v3.2-bin\BusinessTools.Cryptography.dll

Утилиты RegAsm и gacutil следует поместить в рабочую папку.

Получение XML-представления ключа WM Keeper WinPro

Получить представление ключа WM Keeper WinPro можно с помощью программы Key Extractor.

Обратите внимание! Начиная с версии библиотеки 3.1. формат представления ключа WM Keeper изменился. Старый формат более не поддерживается.

Рекомендации по использованию библиотеки.

Xml-представление ключа WMKeeper рекомендуется хранить в конфигурационном файле приложения в зашифрованном виде. Подробнее о шифровании разделов конфигурационного файла вы можете узнать в библиотеке MSDN

Использование библиотеки WebMoney.Cryptography в операционных системах GNU/Linux.

Проект Mono позволяет использовать библиотеку WebMoney.Cryptography и программу Key Extractor практически на любой операционной системе семейства Unix. Ни библиотека, ни программа не требуют какой-либо доработки для этого. Дополнительную информацию смотрите в статье Key Extractor.

Список изменений

Версия 4.1 от 8 октября 2026

  1. Добавлена поддержка ключей v2(формата Ed25519).

Версия 4.0 от 9 декабря 2021

  1. Добавлена поддержка .Net Core (.Net Standard 2.0).

Версия 3.3.1

  1. Добавлена возможность подключения с помощью менеджера пакетов NuGet.
  2. Объединена библиотека BusinessTools.Cryptography и WebMoney.Cryptography.
  3. Исправлена ошибка "Invalid Key Length", возникавшая при расшифровке некоторых ключей.

Поддержка участников

Техническая поддержка осуществляется по e-mail:

Ссылки на ресурсы

Старые версии

Зеркала на CodePlex, Google Code и SourceForge содержат старые версии и не обновляются.
Все исполняемые файлы и библиотеки подписаны цифровой подписью. Безопасность файлов без валидной цифровой подписи не гарантируется.