Biblioteka .NETWersja 2.0.4

Xades.Components

Podpisy elektroniczne XAdES-BES w Twojej aplikacji .NET – z certyfikatu w pliku, w magazynie Windows, na karcie lub tokenie. Sprawdzona z polskimi bramkami: e-Deklaracje, KSeF i PUESC.

dotnet add package Xades.Components

Wszystkie tryby podpisu

Enveloped, Enveloping oraz podpis zewnętrzny (detached) i wewnętrzny dla danych Base64.

Gotowa na DI

AddXadesComponents i IXadesSigner: konfiguracja z appsettings.json, wstrzykiwanie w ASP.NET Core i Worker Service.

SHA-256 i SHA-1

RSA-SHA256 i RSA-SHA1, XAdES 1.3.2 z czasem podpisu i odwołaniem do certyfikatu.

Karty i tokeny

Klucze w klasycznym CSP i w CNG KSP – także na kartach kryptograficznych i tokenach USB.

.NET Framework i .NET

netstandard2.0: .NET Framework 4.6.2+ oraz .NET 8 i nowsze.

Gotowe na bramki

Zachowuje formatowanie i komentarze dokumentu; zapisany plik nie psuje podpisu.

Korzystają z Xades.Components

Użycie komponentów

Rejestracja komponentów w DI – numer licencji lub domyślne ustawienia ze zmiennych środowiskowych. Do podpisu użyj IXadesSigner.

appsettings.jsonJSON
{
  "XadesComponents": {
    "SerialNumber": "YOUR-SERIAL-NUMBER",
    "CryptType": "SHA256",
    "EnvelopeType": "Enveloped"
  }
}
Program.csC#
builder.Services.AddXadesComponents(
    builder.Configuration.GetSection(XadesOptions.SectionName));
DeclarationService.csC#
public class DeclarationService(IXadesSigner signer)
{
    // CryptType and EnvelopeType come from the configuration
    public XmlDocument Sign(XmlDocument declaration, X509Certificate2 cert) =>
        signer.Sign(declaration, cert);
}

IXadesSigner jest zarejestrowany jako singleton. Nieprawidłowy numer licencji zostanie zgłoszony przy pierwszym pobraniu z kontenera, a nie przy pierwszym podpisie. Sign(dokument, cert, cryptType, envelopeType) nadpisuje ustawienia dla pojedynczego wywołania.

Licencja komercyjna

Biblioteka jest dostępna na licencji komercyjnej. Po zakupie otrzymasz numer licencji, który odblokowuje pełne działanie.

  • Bez numeru licencji działa w trybie próbnym: do 4 podpisów na proces, z komunikatem na standardowym wyjściu błędów.
  • Licencja obejmuje wsparcie techniczne przy integracji.