Esi.Core 1.0.0

Esi

E-IMZO PKCS#7 imzolarini tekshirish uchun .NET kutubxonasi.

Paketlar

ASP.NET Core loyihasida Esi.AspNetCoreni o'rnatish yetarli — Esi.Core bog'liqlik sifatida keladi.

O'rnatish

dotnet add package Esi.AspNetCore

Sozlash

builder.Services.AddEsi<TokenEsiIdentityProvider>(o =>
{
    o.BaseUrl = "http://your-esi-backend:8085";
    o.RealIp  = "your-server-ip";
});

IEsiIdentityProvider — foydalanuvchining STIR/JShShIR'ini qayerdan olishni siz belgilaysiz:

public sealed class TokenEsiIdentityProvider : IEsiIdentityProvider
{
    public EsiIdentity? GetIdentity(HttpContext context)
    {
        var user = context.User;

        if (!user.Identity.IsAuthenticated)
            return null;

        return EsiIdentity.For(
            user.FindFirst("tin")?.Value,
            user.FindFirst("pinfl")?.Value);
    }
}

Ishlatish — attribute bilan

Imzoli so'rov modeli EsiSignedRequestdan meros oladi:

public class DeleteOfferModel : EsiSignedRequest
{
    public int OfferId { get; set; }
}

Action'ga [VerifySignature] qo'yiladi — imzo tekshirilmasa action bajarilmaydi:

[HttpPost]
[VerifySignature]
public IActionResult DeleteOffer([FromBody] DeleteOfferModel model)
{
    // Imzo tekshirilgan: kriptografik haqiqiy va foydalanuvchiga tegishli
    return Ok();
}

Ishlatish — qo'lda

Attribute mos kelmasa (imzo ixtiyoriy, identity boshqa manbadan va h.k.):

var result = await esiClient.VerifyAsync(model.Signature, ct);

var validation = Pkcs7SignatureValidator.Validate(
    result, new SignatureCriteria(tin, pinfl));

if (!validation.IsValid)
    return BadRequest(validation.Error);

Faqat kriptografik tekshiruv (egasini solishtirmasdan):

var validation = Pkcs7SignatureValidator.Validate(result);

Tekshiruvni o'tkazib yuborish

Biznes qoidasi bo'yicha ba'zi so'rovlarda imzo talab qilinmasligi mumkin:

public EsiIdentity? GetIdentity(HttpContext context)
{
    var payload = GetPayload(context);

    if (payload is null)
        return null;

    if (payload.IsAgent)
        return EsiIdentity.Skip();   // imzo tekshirilmaydi

    return EsiIdentity.For(payload.Tin, payload.Pinfl);
}

Nima tekshiriladi

E-IMZO backend tomonidan:

• Imzo buzilmaganmi (Verified)
• Sertifikat ishonchli zanjirdanmi (CertificateVerified)
• Imzo qo'yilgan paytda sertifikat amal qilganmi (CertificateValidAtSigningTime)

Kutubxona tomonidan:

• Imzolovchi sertifikatidagi STIR/JShShIR berilgan qiymatlarga mos keladimi (prioritetli OR: avval STIR, mos kelmasa JShShIR)
• Ixtiyoriy: sertifikat seriali mos keladimi

Xatolar

SignatureValidationResult.Error qiymatlari:

Details maydoni — batafsil ma'lumot, faqat log uchun (ichida sertifikat qiymatlari bo'ladi, client'ga chiqarilmasin).

Litsenziya

MIT