NKalkan 0.1.1

NKalcan

Библиотека для работы с криптопровайдером АО "НУЦ" KalkanCrypt

Данная библиотека использует C API, в том числе на Windows. KalkanCryptCOM.dll не используется.

Особенности работы с Windows.

В настройках Windows надо установить системную локаль на Kazakh (Kazakhstan). Это позволит прочитать названия организаций корректно.

Так как НУЦ не разрешает распространять бинарники, то надо самостоятельно положить KalkanCrypt_x64.dll в папку с конечным исполняемым файлом. Как например NKalcan.TestBed\bin\Debug\net7.0.

Особенности настройки Linux

Эта библиотека требует чтобы стандартные механизмы загрузки SO файлов на Linux заработали для libkalkancryptwr-64.so Или настройте в соответсвии с инструкциями в файле C/Linux/C/README.txt или можете выполнить следующие операции

• скопируйте файлы setup.sh и ld.kalkan.conf в папку C/Linux/C/ вашего SDK
• перейдите в папку C/Linux/C/
• запустите setup.sh

Поддержка MacOS

У меня нету Мака, потому есть вероятность что какие то проблемы есть. Если обнаружите баг, то создайте тикет в Гитхабе.

Примеры использования

Подпись XML документа

using NKalkan;

var certificatePath = "GOSTKNCA_60e31061cedbcc9f917a2be0fb8ec3c04eb4b598.p12";
var certificatePassword = "Qwerty12";
var documentToSign = "<xml><MyData /></xml>";
var client = new KalkanApi();

client.LoadKeyStore(KalkanStorageType.PKCS12, certificatePath, certificatePassword);
var signedXml = client.SignXml(documentToSign);

Console.WriteLine(signedXml);

Проверка XML документа

try
{
    api.VerifyXml(signedXml);
    Console.WriteLine("XML verified successfully!");
}
catch (Exception e)
{
    Console.WriteLine(e.Message);
}

Загрузка ключа из памяти

Загрузка из массива байт

var certificateBytes = File.ReadAllBytes(certificatePath);
api.LoadKeyStore(KalkanStorageType.PKCS12, certificateBytes, certificatePassword);

Загрузка из потока

using var stream = File.OpenRead(certificatePath);
api.LoadKeyStore(KalkanStorageType.PKCS12, stream, certificatePassword);

Загрузка из массива байт

var base64Content = Convert.ToBase64String(File.ReadAllBytes(certificatePath));
api.LoadKeyStoreFromBase64(KalkanStorageType.PKCS12, base64Content, certificatePassword);

Реализованные API методы

Если вам нужны определенные методы прямо сейчас, создайте задачу в Гитхабе, и с большой вероятностью вы увидите это в следующем релизе.

Лицензия

Данное ПО опубликовано под MIT лицензией.