WMSignerFX

WMSigner для платформы .Net (WMSignerFX)

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

Цель статьи: пояснить специфику работы с библиотекой WebMoney.Cryptography (кодовое название WMSignerFX).

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

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

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

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

using WebMoney.Cryptography
using System;

namespace WebMoney.Examination
{
    public class Program
    {
        static void Main(string[] args)
        {
            // xml-представление ключа WebMoney Keeper Classic, полученное с помощью утилиты KeyExtractor 3.1 
            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 и BusinessTools.Cryptography.

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

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

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

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

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

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

VBScrip

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 Classic

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

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

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

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

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

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

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

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

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

• Сайт проекта WMSignerFX
• Инсталлер ClickOnce
• Исходный код
• Сборка для Windows (поддержка COM) и Linux
• Сборка для Windows CE
• Зеркало
• SVN репозиторий (старые версии в папке tags, текущая версия в папке trunk).

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

Категория: XML-интерфейсы

This article in other languages: English