ABCPRO.NES 1.1.37

<img src="images/nes_logo.svg" width="200px" style="width: 100px; display:block;"/>

Paczka eADM i Niezbędne Elementy Struktury (dokumentu elektronicznego) 2.0

• Krótki opis zawartości
• Biblioteki .NET
• Historia wersji
• Przykłady użycia bibliotek .NET
• Opis merytoryczny

Zawartość

Biblioteki NES służą do tworzenia paczki eADM, która swoją strukturą odpowiada paczce archiwalnej przekazywanej do Archiwów Państwowych. Paczka oprócz samych dokumentów, zawiera opisujące je pliki metadanych. Więcej informacji można znaleźć w Rozporządzeniu Prezydenta Rzeczypospolitej Polskiej w sprawie szczegółowego sposobu oraz szczegółowych warunków przekazywania skargi wraz z aktami sprawy i odpowiedzią na skargę do sądu administracyjnego (Dz.U. z 2019 r. poz. 1003).

Biblioteki zostały wykorzystane do stworzenia rozwiązania dostępnego pod adresem https://paczka-eadm.abcpro.pl/ pozwalającego na przeglądanie zawartości paczki eADM.

W tym katalogu znajduje się:

• oryginalny schemat XSD nes_20.xsd dla metadanych paczki eADM i schemat XSD Metadane-1.7.xsd dla metadanych paczki archiwalnej,
• kod źródłowy biblioteki do tworzenia, edycji i zapisu plików XML metadanych zgodnych ze schematami ABCPRO.NES zarówno w wersji 1.7 jak i 2.0. Biblioteka pozwala na utworzenie pliku XSD na podstawie modelu. W przeciwieństwie do oryginalnego pliku XSD, - który można pobrać również z profilu Ministerstwa Cyfryzacji, ten wygenerowany z modelu nie zawiera żadnych błędów walidacji i referencji do zewnętrznych słowników, wszystkie elementy są opatrzone komentarzem, ponadto dodano możliwość umieszczania elementów ds:Signature czyli odwzorowania podpisów elektronicznych. W katalogu doc znajduje się dokumentacja wygenerowana na podstawie schematu,
• kod źródłowy biblioteki do tworzenia paczki eADM ABCPRO.NES.ArchivalPackage. Za pomocą biblioteki można tworzyć, edytować i zapisywać dokumenty i metadane w paczce eADM zgodnie z wymogami rozporządzeń.
• kod źródłowy biblioteki do składania i weryfikacji podpisu elektronicznego plików XML ABCPRO.NES.XAdES
• kod źródłowy biblioteki do składania i weryfikacji podpisu elektronicznego paczki eADM ABCPRO.NES.ArchivalPackage.Cryptography

NuGet

<a href="https://www.nuget.org/packages/ABCPRO.NES/"><img alt="Nuget" src="https://img.shields.io/nuget/v/ABCPRO.NES?label=abcpro.nes%20nuget"> <img alt="Nuget" src="https://img.shields.io/nuget/dt/ABCPRO.NES"></a>

Historia wersji

Historia wersji ABCPRO.NES

⇪ Do góry

Przykłady

Generowanie schematu XSD

XElement schema;
using (var xsdGenerator = new XsdGenerator()) {
    schema = xsdGenerator.GetSchema();
}
var filePath = @"..\..\..\nes_20_generated.xsd";
schema.Save(filePath);

Tworzenie dokumentu XML metadanych

Abc.Nes.Document document = GetModel(); 
var filePath = Path.Combine(Path.GetTempPath(), "nes.xml");
new Abc.Nes.Converters.XmlConverter().WriteXml(document, filePath);

Ładowanie dokumentu XML metadanych

var filePath = Path.Combine(Path.GetTempPath(), "nes.xml");
if (!File.Exists(filePath)) { throw new FileNotFoundException(); }
var document = new Abc.Nes.Converters.XmlConverter().LoadXml(filePath);

Walidacja dokumentu XML metadanych

Domyslnie komunikaty wyświetlane są w języku angielskim. W celu włączenia komunikatów w języku polskim w pliku AssemblyIno.cs projektu należy dodać dyrektywę [assembly: NeutralResourcesLanguage("pl")] lub z poziomu kodu ustawić polskie CultureInfo.

var filePath = Path.Combine(Path.GetTempPath(), "nes.xml");
if (!File.Exists(filePath)) { throw new FileNotFoundException(); }
ar converter = new Abc.Nes.Converters.XmlConverter();
var valid = converter.Validate(filePath);
// converter.ValidationErrors - errors

W celu wykonania bardziej szczegółowej walidacji należy użyć metody GetValidationResult.

var c = new  Abc.Nes.Validators.DocumentValidator();
var result = c.Validate(GetModel(true));
foreach (var item in result) {
    Console.WriteLine(item.DefaultMessage);                
}

Korzystanie z modelu metadanych

var document = new Abc.Nes.Document() {
    Identifiers = new List<Abc.Nes.Elements.IdentifierElement> {
        new Abc.Nes.Elements.IdentifierElement() {
            Type = Enumerations.IdTypes.ObjectMark.GetIdTypes(),
            Value = "ABC-A.123.77.3.2011.JW.",
            Subject = new Elements.SubjectElement() {
                Institution = new Elements.InstitutionElement() {
                    Name = "Urząd Miasta Wołomierz"
                }
            }
        }
    },
    Titles = new List<Abc.Nes.Elements.TitleElement> {
        new Abc.Nes.Elements.TitleElement(){
            Original = new Abc.Nes.Elements.TitleWithLanguageCodeElement(){
                Type = Enumerations.LanguageCode.pol,
                    Value = "Tytuł dokumentu"
            },
            Alternative = new List<Elements.TitleWithLanguageCodeElement> {
                new Elements.TitleWithLanguageCodeElement() {
                    Type = Enumerations.LanguageCode.eng,
                    Value = "Document title"
                }
            }
        }
    },
    Dates = new List<Elements.DateElement> {
        new Elements.DateElement() {
            Type = Enumerations.EventDateType.Created,
            Date = "2020-06-22"
        }
    },
    Formats = new List<Elements.FormatElement> {
        new Elements.FormatElement() {
            Type = ".pdf",
            Specification = "1.7",
            Uncompleted = Enumerations.BooleanValues.False,
            Size = new Elements.SizeElement() {
                Measure = Enumerations.FileSizeType.kB.GetSizeType(),
                    Value = "4712"
                }
            }
    },
    Access = new List<Elements.AccessElement> {
        new Elements.AccessElement() {
            Access = Enumerations.AccessType.Public,
            Description = "Uwagi dotyczące dostępności",
            Date = new Elements.AccessDateElement() {
                Type = Enumerations.AccessDateType.After,
                Date = "2020-06-23"
            }
        }
    },
    Types = new List<Elements.TypeElement>() {
        new Elements.TypeElement() {
            Class = Enumerations.DocumentClassType.Text.GetDocumentClassType(),
            Kinds = new List<string> { Elements.TypeElement.GetDocumentKindType(Enumerations.DocumentKindType.Document) }
        }
    },
    Groupings = new List<Elements.GroupingElement> {
        new Elements.GroupingElement() {
            Type = "Rejestr korespondencji przychodzącej",
            Code = "RKP01",
            Description = "tekstowy opis grupy"
        }
    },
    Authors = new List<Elements.AuthorElement> {
        new Elements.AuthorElement() {
            Functions = new List<string> { Enumerations.AuthorFunctionType.Created.GetAuthorFunctionType() },
            Subject = new Elements.SubjectElement() {
                Institution = new Elements.InstitutionElement() {
                    Name = "Urząd Miasta Wołomierz"
                }
            }
        }
    },
    Senders = new List<Elements.SenderElement> {
        new Elements.SenderElement() {
            Subject = new Elements.SubjectElement() {
                Institution = new Elements.InstitutionElement() {
                    Name = "Urząd Miasta Wołomierz"
                }
            }
        }
    },
    Recipients = new List<Elements.RecipientElement> {
        new Elements.RecipientElement() {
            CC = Enumerations.BooleanValues.False,
            Subject = new Elements.SubjectElement() {
                Institution = new Elements.InstitutionElement() {
                    Name = "Urząd Miasta Wołomierz"
                }
            }
        },
        new Elements.RecipientElement() {
            CC = Enumerations.BooleanValues.True,
            Subject = new Elements.SubjectElement() {
                Institution = new Elements.InstitutionElement() {
                    Name = "Regionalna Izba Obrachunkowa w Łodzi"
                }
            }
        }
    },
    Relations = new List<Elements.RelationElement> {
        new Elements.RelationElement {
            Identifiers = new List<Elements.IdentifierElement> {
                new Elements.IdentifierElement() {
                    Type = "SystemID",
                    Value = "P00112233.pdf.xades"
                }
            },
            Type = Enumerations.RelationType.HasReference.GetRelationType()
        },
        new Elements.RelationElement {
            Identifiers = new List<Elements.IdentifierElement> {
                new Elements.IdentifierElement() {
                    Type = "SystemID",
                    Value = "dek2010123.txt"
                }
            },
            Type = Enumerations.RelationType.HasAttribution.GetRelationType()
        },
        new Elements.RelationElement {
            Identifiers = new List<Elements.IdentifierElement> {
                new Elements.IdentifierElement() {
                    Type = "SystemID",
                    Value = "P00112233.docx"
                }
            },
            Type = Enumerations.RelationType.IsVersion.GetRelationType()
        },
        new Elements.RelationElement {
            Identifiers = new List<Elements.IdentifierElement> {
                new Elements.IdentifierElement() {
                    Type = "SystemID",
                    Value = "UPD12345.xml"
                }
            },
            Type = Enumerations.RelationType.HasReference.GetRelationType()
        }
    },
    Qualifications = new List<Elements.QualificationElement> {
        new Elements.QualificationElement() {
            Type = Enumerations.ArchivalCategoryType.BE10.GetArchivalCategoryType(),
            Date = "2005-03-05",
            Subject = new Elements.SubjectElement() {
            Institution = new Elements.InstitutionElement() {
                Name = "Urząd Miasta Wołomierz",
                    Unit = new Elements.InstitutionUnitElement() {
                        Name = "Wydział Organizacyjny",
                        Employee = new Elements.EmployeeElement() {
                            FirstNames = new List<string> { "Jan" },
                            Surname = "Kowalski",
                            Position = "Specjalista"
                        }
                    }
                }
            }
        }
    },
    Languages = new List<Elements.LanguageElement>() {
        new Elements.LanguageElement() {
            Type = Enumerations.LanguageCode.pol,
            Value = "polski"
        }
    },
    Description = "projekt dokumentu \"Requirements for elaboration and implementation of information system of General department of Archives\", przekazny przez Przewodniczącą Departamentu Generalnego Archiwów przy Radzie Ministrów Republiki Bułgarii",
    Keywords = new List<Elements.KeywordElement> {
        new Elements.KeywordElement() {
            Matters = new List<string> { "handel" },
            Places = new List<string> { "Polska" },
            Dates = new List<Elements.DateElement> {
                new Elements.DateElement() {
                    Range = Enumerations.DateRangeType.DateFromTo,
                    DateFrom = "2008",
                    DateTo = "2012"
                }
            },
            Others = new List<Elements.KeywordDataElement> {
                new Elements.KeywordDataElement() {
                    Key = "placówki handlowe",
                    Value = "Anna i Jan"
                }
            } 
        }
    },
    Rights = new List<string> { "© Unesco 2003 do polskiego tłumaczenia Naczelna Dyrekcja Archiwów Państwowych" },
    Locations = new List<string> { "Archiwum zakładowe Urzędu Miasta w Wołomierzu" },
    Statuses = new List<Elements.StatusElement> { 
        new Elements.StatusElement() { 
            Kind = "status dokumentu",
            Version = "numer wersji",
            Description = "opis"
        }
    }
};

⇪ Do góry

Ładowanie paczki eADM

var path = @"../../../sample/ValidatedPackage.zip";
var mgr = new PackageManager();
mgr.LoadPackage(path);

var isNotEmpty = mgr != null && mgr.Package != null && !mgr.Package.IsEmpty;

Pobieranie informacji o ilości dokumentów w paczce eADM

var path = @"../../../sample/ValidatedPackage.zip";
var mgr = new PackageManager();
mgr.LoadPackage(path);

var count = mgr.GetDocumentsCount();

Pobieranie listy plików w paczce eADM

var path = @"../../../sample/ValidatedPackage.zip";
var mgr = new PackageManager();
mgr.LoadPackage(path);

var items = mgr.GetAllFiles();

Pobranie pliku metadanych dla wskazanej ścieżki pliku dokumentu

var path = @"../../../sample/ValidatedPackage.zip";
var mgr = new PackageManager();
mgr.LoadPackage(path);

var item = mgr.GetItemByFilePath("Dokumenty/Wniosek/Wniosek.xml");
if (item != null) {
    var metadataFile = mgr.GetMetadataFile(item);                
}

Pobranie obiektu folderu dla wskazanej ścieżki pliku dokumentu

var path = @"../../../sample/ValidatedPackage.zip";
var mgr = new PackageManager();
mgr.LoadPackage(path);

var folder = mgr.GetParentFolder("dokumenty/Wniosek/Wniosek.xml");

Ładowanie, dodanie pliku z metadanymi i zapisanie paczki eADM

var path = @"../../../sample/ValidatedPackage.zip";
var mgr = new PackageManager();
mgr.LoadPackage(path);

mgr.AddFile(new DocumentFile() {
    FileData = File.ReadAllBytes(@"../../../sample/sample_file.pdf"),
    FileName = "TabelaWydatkow.pdf"
}, new Document() {
    Identifiers = new List<Elements.IdentifierElement>() {
        new Elements.IdentifierElement() {
            Type = "Numer tabeli",
            Value = "3",
            Subject = new Elements.SubjectElement() {
                Person = new Elements.PersonElement() {
                    FirstNames = new List<string> { "Jan" },
                    Surname = "Kowalski",
                    Contacts = new List<Elements.ContactElement> {
                        new Elements.ContactElement() {
                            Type = ContactType.Email.GetContactType(),
                                Value = "jan.kowalski@miastowolomierz.pl"
                            }
                        }
                    }
                }
            }
        },
        Titles = new List<Elements.TitleElement> {
            new Elements.TitleElement() {
                Original = new Elements.TitleWithLanguageCodeElement(){
                    Type = LanguageCode.pol,
                    Value = "Tabela wydatków"
                }
            }
        },
        Dates = new List<Elements.DateElement> {
            new Elements.DateElement() {
                Type = EventDateType.Created,
                Date = "2020-04-01 12:32:00"
            }
        },
        Formats = new List<Elements.FormatElement> {
            new Elements.FormatElement() {
                Type = "PDF",
                Specification = "1.7",
                Uncompleted = BooleanValues.False,
                Size = new Elements.SizeElement() {
                    Measure = FileSizeType.bajt.GetSizeType(),
                    Value = new FileInfo(@"../../../sample/sample_file.pdf").Length.ToString()
                }
            }
        },
        Access = new List<Elements.AccessElement> {
            new Elements.AccessElement() {
                Access = AccessType.Public
            }
        },
        Types = new List<Elements.TypeElement> {
            new Elements.TypeElement() {
                Class = DocumentClassType.Text.GetDocumentClassType(),
                Kinds = new List<string> { Elements.TypeElement.GetDocumentKindType(DocumentKindType.Regulation) }
            }
        },
        Groupings = new List<Elements.GroupingElement> {
        new Elements.GroupingElement() {
            Type = "Rejestr wydatków",
            Code = "KS_RW",
            Description = "Księgowość: rejestr wydatków"
        }
    }
});

mgr.Save(@"../../../sample/ValidatedPackage.zip");

Weryfikacja poprawności strukturalnej paczki ADM

Domyslnie komunikaty wyświetlane są w języku angielskim. W celu włączenia komunikatów w języku polskim w pliku AssemblyIno.cs projektu należy dodać dyrektywę [assembly: NeutralResourcesLanguage("pl")] lub z poziomu kodu ustawić polskie CultureInfo.

var path = @"../../../sample/ValidatedPackage.zip";
var mgr = new PackageManager();
mgr.LoadPackage(path);
var validateMetdataFiles = true;
var breakOnFirstError = false;
var result = mgr.Validate(out var message, validateMetdataFiles, breakOnFirstError);
if (!result) {
    throw new System.Exception(message);
}

W celu wykonania bardziej szczegółowej walidacji należy użyć metody GetValidationResult.

var path = @"../../../sample/ValidatedPackage.zip";
var mgr = new PackageManager();
mgr.LoadPackage(path);
var validateMetdataFiles = true;
var breakOnFirstError = false;
var result = mgr.GetValidationResult(validateMetdataFiles, breakOnFirstError);
if (!result.IsCorrect) {
    foreach (var item in result) {
        Console.WriteLine(item.DefaultMessage);
    }
}

⇪ Do góry

Podpisywanie pliku metadanych (podpis w treści pliku XML - enveloped)

var document = GetModel(); // utworzenie modelu dokumentu metadanych
var documentXml = new Abc.Nes.Converters.XmlConverter().GetXml(document); // konwersja modelu do XML

 using (var manager = new XadesManager()) {
    var xml = new MemoryStream(Encoding.UTF8.GetBytes(documentXml.ToString()));
    var result = manager.AppendSignatureToXmlFile(xml, CertUtil.SelectCertificate(),
    new SignatureProductionPlace() {
        City = "Warszawa",
        CountryName = "Polska",
        PostalCode = "03-825",
        StateOrProvince = "mazowieckie"
   },
   new SignerRole("Wiceprezes Zarządu"));

    var filePath = Path.Combine(Path.GetTempPath(), "signature.xml");
    if (File.Exists(filePath)) { File.Delete(filePath); }
    result.Save(filePath);
    // System.Diagnostics.Process.Start(filePath);
}

Podpisywanie pliku PDF (podpis okalający - enveloping)

var path = "../../../doc/nes_20_generated.pdf";
using (var manager = new XadesManager()) {
    var result = manager.CreateEnvelopingSignature(
        new MemoryStream(File.ReadAllBytes(path)), 
        CertUtil.SelectCertificate(),
        new SignatureProductionPlace() {
            City = "Warszawa",
            CountryName = "Polska",
            PostalCode = "03-825",
            StateOrProvince = "mazowieckie"
        },
        new SignerRole("Wiceprezes Zarządu"));

        var filePath = Path.Combine(Path.GetTempPath(), "signature.xml");
        if (File.Exists(filePath)) { File.Delete(filePath); }
        result.Save(filePath);

}

Podpisywanie pliku PDF (podpis zewnętrzny - detached)

var path = "../../../doc/nes_20_generated.pdf";
using (var manager = new XadesManager()) {
    var result = manager.CreateDetachedSignature(new FileInfo(path).FullName, CertUtil.SelectCertificate(),
    new SignatureProductionPlace() {
        City = "Warszawa",
        CountryName = "Polska",
        PostalCode = "03-825",
        StateOrProvince = "mazowieckie"
    },
    new SignerRole("Wiceprezes Zarządu"));

    File.Copy(path, Path.Combine(Path.GetTempPath(), "nes_20_generated.pdf"), true);
    var filePath = Path.Combine(Path.GetTempPath(), "nes_20_generated.pdf.xades");
    if (File.Exists(filePath)) { File.Delete(filePath); }
    result.Save(filePath);

⇪ Do góry

Podpisywanie paczki eADM (podpis okalający - enveloping)

var path = @"../../../sample/ValidatedPackage.zip";
var outputPath = @"../../../sample/SignedPackage.xades";
using (var mgr = new PackageSignerManager()) {
    mgr.Sign(new FileInfo(path).FullName, 
    CertUtil.SelectCertificate(),
    new FileInfo(outputPath).FullName,
    new SignatureProductionPlace() {
        City = "Warszawa",
        CountryName = "Polska",
        PostalCode = "03-825",
        StateOrProvince = "mazowieckie"
    },
    new SignerRole("Wiceprezes Zarządu"),
    true, // Podpisz pliki w paczce eADM
    true, // Podpisz paczkę archiwalną
    false, // w pliku .xades umieść jedynie referencję do pliku paczki (podpis zewnętrzny - detached)
    true, // dodaj znacznik czasu
    "http://time.certum.pl" // adres serwera znacznika czasu
    );
}

Podpisywanie paczki eADM (podpis zewnętrzny - detached)

var path = @"../../../sample/ValidatedPackage.zip";
var outputPath = @"../../../sample/SignedPackage.zip";
using (var mgr = new PackageSignerManager()) {
    mgr.Sign(new FileInfo(path).FullName,
        CertUtil.SelectCertificate(),
        new FileInfo(outputPath).FullName,
        new SignatureProductionPlace() {
            City = "Warszawa",
            CountryName = "Polska",
            PostalCode = "03-825",
            StateOrProvince = "mazowieckie"
        },
        new SignerRole("Wiceprezes Zarządu"),
        true, // Podpisz pliki w paczce eADM
        true, // Podpisz paczkę archiwalną
        true, // w pliku .xades umieść jedynie referencję do pliku paczki (podpis zewnętrzny - detached)
        true  // Podpisz pliki w paczce eADM inne niż XML i PDF podpisem zewnętrznym
        );
}

var outputXadesFilePath = @"../../../sample/SignedPackage.zip.xades";
if (File.Exists(outputXadesFilePath)) {
    // ...
}

Podpisywanie wybranych plików w paczce eADM

var path = @"../../../sample/ValidatedPackage.zip";
var outputPath = @"../../../sample/SignedPackage.zip";
using (var mgr = new PackageSignerManager()) {
    mgr.SignInternalFile(new FileInfo(path).FullName,
        "Dokumenty/TabelaWydatkow.pdf",
        CertUtil.SelectCertificate(),
        new SignatureProductionPlace() {
            City = "Warszawa",
            CountryName = "Polska",
            PostalCode = "03-825",
            StateOrProvince = "mazowieckie"
        },
        new SignerRole("Wiceprezes Zarządu"),
        false, // Podpis zewnętrzny w pliku .xades
        new FileInfo(outputPath).FullName
    );
}

Podpisywanie paczki oraz wybranych plików w paczce eADM

var path = @"../../../sample/ValidatedPackage.zip";
var outputPath = @"../../../sample/SignedPackage.zip";
using (var mgr = new PackageSignerManager()) {
    mgr.Sign(new FileInfo(path).FullName,
        CertUtil.SelectCertificate(),
        new FileInfo(outputPath).FullName,
        new SignatureProductionPlace() {
            City = "Warszawa",
            CountryName = "Polska",
            PostalCode = "03-825",
            StateOrProvince = "mazowieckie"
        },
        new SignerRole("Wiceprezes Zarządu"),
        new string[] {"Dokumenty/Wniosek/Wniosek.xml", "Dokumenty/Tabela_Wydatkow.pdf"}, // Podpisz wybrane pliki w paczce eADM        
        true, // Podpisz paczkę archiwalną
        true, // w pliku .xades umieść jedynie referencję do pliku paczki (podpis zewnętrzny - detached)
        true  // Podpisz pliki w paczce eADM inne niż XML i PDF podpisem zewnętrznym
        );
}

var outputXadesFilePath = @"../../../sample/SignedPackage.zip.xades";
if (File.Exists(outputXadesFilePath)) {
    // ...
}

Podpisywanie pliku PDF znajdującego się na dysku

var path = @"../../../sample/sample_file.pdf";
var imagePath = @"../../../sample/legislator.png";
var outputpath = @"../../../sample/sample_file.signed.pdf";
var mgr = new PackageSignerManager();
mgr.SignPdfFile(
    new FileInfo(path).FullName,
    CertUtil.SelectCertificate(),
    CommitmentTypeId.ProofOfOrigin,
    "Warszawa",
    true,
    // wielkość obrazka 220x50 pikseli
    apperancePngImage :File.ReadAllBytes(new FileInfo(imagePath).FullName),
    apperancePngImageLocation: PdfSignatureLocation.BottomLeft,
    apperanceLocationX: 360F,
    apperanceLocationY: 620F, //700F,
    apperanceWidth: 220F,
    apperanceHeight: 50F,
    margin: 10F,
    outputFilePath: new FileInfo(outputpath).FullName
);

Pobranie informacji o podpisie z pliku .xades

var path = @"../../../sample/SignedPackage.zip.xades";
using (var mgr = new PackageSignerManager()) {
    var result = mgr.GetSignatureInfos(path);    
}

Pobranie informacji o podpisie z pliku w paczce eADM

var path = @"../../../sample/SignedPackage.zip";
using (var mgr = new PackageSignerManager()) {
    var result = mgr.GetSignatureInfos(path, "Dokumenty/LegalAct.pdf"); 
}

Weryfikacja podpisów w paczce eADM

var path = @"../../../sample/SignedPackage.zip";
var list = new List<ArchivalPackage.Cryptography.Model.SignatureVerifyInfo>();
using (var mgr = new PackageSignerManager()) {
    list.AddRange(mgr.VerifySignatures(path));
}

Pobranie informacji o podpisach oraz weryfikacja podpisów w paczce eADM

var path = @"../../../../sample/LegalActRIOzielonagora.zip";
using (var mgr = new PackageSignerManager()) {
    SignAndVerifyInfo[] result = mgr.GetSignAndVerifyInfo(path);
}

Weryfikacja podpisu dla wskazanego pliku w paczce eADM

var path = @"../../../sample/SignedPackage.zip";
var list = new List<ArchivalPackage.Cryptography.Model.SignatureVerifyInfo>();
using (var mgr = new PackageSignerManager()) {
    list.AddRange(mgr.VerifySignatures(path, "Dokumenty/LegalAct.zip.xades"));
}

Weryfikacja podpisów w pliku xades paczki eADM

var path = @"../../../sample/SignedPackage.zip.xades";
var list = new List<ArchivalPackage.Cryptography.Model.SignatureVerifyInfo>();
using (var mgr = new PackageSignerManager()) {
    list.AddRange(mgr.VerifyXadesSignature(path));
}

Obsługa plików TAR i TAR.GZ

Konwersja do pliku ZIP i załadowanie pliku paczki eADM

var path = @"../../../sample/paczka_archiwalna_48.tar";
var pathZip = @"../../../sample/paczka_archiwalna_48.tar.zip";
      
using (var tar = new ArchivalPackage.Formats.Tar.TarFile(path)) {
    if (tar.ConvertToZip(pathZip)) {
        var mgr = new PackageManager();
        mgr.LoadPackage(pathZip);
        var isNotEmpty = mgr != null && mgr.Package != null && !mgr.Package.IsEmpty;
        Assert.IsTrue(isNotEmpty);
    }
}

Konwersja do pliku ZIP i załadowanie paczki eADM z użyciem strumieni

var path = @"../../../sample/paczka_archiwalna_48.tar";
using (var stream = File.OpenRead(path)) {
    using (var tar = new ArchivalPackage.Formats.Tar.TarFile(stream, ArchivalPackage.Formats.Tar.TarType.Tar)) {
        using (var zipStream = tar.ConvertToZip()) {
            if (zipStream != null && zipStream.Length > 0) {
                var mgr = new PackageManager();
                mgr.LoadPackage(zipStream);
                var isNotEmpty = mgr != null && mgr.Package != null && !mgr.Package.IsEmpty;
                Assert.IsTrue(isNotEmpty);
            }
        }
    }
}

Archiwum zawierające paczkę eADM i plik podpisu .xades

Rozpakowanie archiwum zawierającego paczke archiwalną i zewnetrzny plik podpisu .xades i ponowne jej podpisanie

var path = @"../../../sample/Paczka.testowa.30.03.21.podpisana.zip";

var signedPackageManager = new SignedPackageManager();
var info = signedPackageManager.Extract(path);

using (var manager = new XadesManager()) {
    var result = manager.CreateEnvelopingSignature(
        new MemoryStream(File.ReadAllBytes(Path.Combine(info.Directory, info.PackageFileName))), 
        CertUtil.SelectCertificate(),
        new SignatureProductionPlace() {
            City = "Warszawa",
            CountryName = "Polska",
            PostalCode = "03-825",
            StateOrProvince = "mazowieckie"
        },
        new SignerRole("Wiceprezes Zarządu"));

        var filePath = Path.Combine(info.Directory, info.SignatureFileName);
        if (File.Exists(filePath)) { File.Delete(filePath); }
        result.Save(filePath);
}

signedPackageManager.Compress(info);

⇪ Do góry

Historia

Historia niezbędnych elementów dokumentów elektronicznych rozpoczęła się 30 października 2006 roku wraz z wydaniem rozporządzenia Ministra Spraw Wewnętrznych i Administracji w sprawie niezbędnych elementów struktury dokumentów elektronicznych (Dz.U. z 2006 r. Nr 206, poz. 1517).

NES od początku miały opisywać dokumenty przekazywane do Archiwów Państwowych, a rozporządzenie wynika z delegacji zamieszczonej w ustawie o narodowym zasobie archiwalnym i archiwach (Dz.U. z 2019 r. poz. 553), a wydał je Minister Spraw Wewnętrznych i Administracji w rozporządzeniu w sprawie wymagań technicznych formatów zapisu i informatycznych nośników danych, na których utrwalono materiały archiwalne przekazywane do archiwów państwowych (Dz.U. z 2006 r. Nr 206, poz. 1519).

W Dz.U. z 2019 r. pod poz. 1003 opublikowano rozporządzenia Prezydenta Rzeczypospolitej Polskiej z 27 maja 2019 r. w sprawie szczegółowego sposobu oraz szczegółowych warunków przekazywania skargi wraz z aktami sprawy i odpowiedzią na skargę do sądu administracyjnego (Dz.U. z 2019 r. poz. 1003).

Z rozporządzenia wynika, że skargę oraz odpowiedź na skargę organ przekazuje w formie lub postaci, w jakiej zostały sporządzone. Natomiast skargę lub odpowiedź na skargę sporządzoną w formie dokumentu elektronicznego organ przekazuje do elektronicznej skrzynki podawczej sądu.

Jeżeli forma lub postać skargi i odpowiedzi na skargę różnią się, organ, przekazując dokument elektroniczny załącza uwierzytelnioną kopię kwalifikowaną pieczęcią elektroniczną, kwalifikowanym podpisem elektronicznym lub podpisem (profilem) zaufanym.

Akta sprawy organ przekazuje do sądu w takiej postaci, w jakiej są prowadzone. Akta można prowadzić w formie papierowej i elektronicznej. W przypadku gdy akta sprawy są prowadzone w postaci elektronicznej, organ przekazuje akta sprawy w sposób, o którym mowa w §7 ust. 1 rozporządzenia, wraz ze skargą lub odpowiedzią na skargę sporządzoną w formie dokumentu elektronicznego, do elektronicznej skrzynki podawczej sądu. Jeżeli w aktach sprawy prowadzonych w postaci elektronicznej znajdują się dokumenty, których treść nie jest dostępna w całości w postaci elektronicznej, organ przekazuje do sądu:

• akta sprawy, podając informację o sposobie i dacie przekazania dokumentów, których treść nie jest dostępna w całości w postaci elektronicznej;
• dokumenty, których treść nie jest dostępna w całości w postaci elektronicznej, wskazując na akta sprawy oraz datę ich przekazania do sądu.

Z §7 rozporządzenia wynika, że akta sprawy prowadzone w postaci elektronicznej przekazuje się jako wyodrębniony z systemu elektronicznego zarządzania dokumentacją, w rozumieniu przepisów o narodowym zasobie archiwalnym i archiwach, zbiór dokumentów obejmujących akta sprawy (paczka eADM). Opisane powyżej biblioteki służą do jej sporządzenia i podpisania bezpiecznym podpisem elektronicznym. Więcej informacji o eADM można znaleźć na stronie gov.legalis.pl.

⇪ Do góry

<a href="https://www.abcpro.pl"><img alt="www" src="https://img.shields.io/badge/www-abcpro.pl-orange?style=for-the-badge"></a>