release 3.0.24

Author: AK47454453

RELEASE_NOTES.md

@@ -2072,3 +2072,66 @@
 | ➕ dodane    | 0             |
 | 🔧 zmienione | 6             |
 | ➖ usunięte  | 0             |
+
+
+# Changelog zmian - `## 3.0.24 (2026-04-22)`- `API: 2.4.0`
+
+## 1. ksef-client
+
+### 1.1 api.client.model
+- **exceptions/TooManyRequestsApiException.java**: ➕ dodanie klasy
+- **exceptions/TooManyRequestsProblemDetails.java**: ➕ dodanie klasy
+- **exceptions/BadRequestApiError.java**: ➕ dodanie klasy
+- **exceptions/BadRequestApiException.java**: ➕ dodanie klasy
+- **exceptions/BadRequestProblemDetails.java**: ➕ dodanie klasy
+- **exceptions/GoneApiException.java**: ➕ dodanie klasy
+- **exceptions/GoneProblemDetails.java**: ➕ dodanie klasy
+- **exceptions/UnauthorizedProblemDetails.java**: 🔧 dodanie pola `String timestamp`
+- **exceptions/ForbiddenProblemDetails.java**: 🔧 dodanie pola `String timestamp`
+- **exceptions/GetRateLimitIntegrationTest.java**: 🔧 aktualizacja testu
+- **HttpStatus.java**: 🔧 dodanie enuma `GONE(410)`
+
+### 1.2 client
+- **Headers.java**: 🔧 dodanie pól `X_ERROR_FORMAT = "X-Error-Format"` i `X_ERROR_FORMAT_PROBLEM_DETAILS = "problem-details"`
+
+### 1.3 system
+- **ExceptionHandler.java**: ➕ dodanie klasy odpowiedzialnej za parsowanie błedów odpowiedzi http, dodano obsługę dla http 400, 410, 429 zgodnie z propozycją API KSeF ([#764](https://github.com/CIRFMF/ksef-docs/issues/764)) - najpierw próba zdekodowania odpowiedzi w nowym modelu, a następnie cofa się do dotychczasowego formatu.
+
+### 1.4 api
+- **DefaultKsefClient.java**: 🔧 parsowanie błedów odpowiedzi http przeniesiono do `ExceptionHandler`
+
+### 1.5 api.services
+- **DefaultSignatureService.java**: 🔧 - dodano obsługę podpisywania dokumentów dla kluczy eksportowalnych
+
+### 1.6 sign
+- **CertUtil.java**: 🔧 rozbudowa metod o sprawdzanie algorytmów kluczy
+- **LocalSigningContext.java**: 🔧 dodano przeciążone metody `SignatureValue createSignatureValue` pod podpisywanie dla kluczy eksportowalnych, jedna oznaczona jako Deprecated
+- **SignContextProvider.java**: 🔧 zgodnie z `LocalSigningContext`
+
+## 2. demo-web-app
+
+### 2.1 integrationTest
+- **AuthorizationIntegrationTest.java**: 🔧 dodano test pod podpisywanie dla kluczy eksportowalnych
+- **BatchIntegrationTest.java**: 🔧 aktualizacja testów po przejściu na nowy model dla błedów http (nagłówek `X-Error-Format: "problem-details"`)
+- **QueryInvoiceIntegrationTest.java**: 🔧 aktualizacja testów po przejściu na nowy model dla błedów http (nagłówek `X-Error-Format: "problem-details"`)
+- **SessionIntegrationTest.java**: 🔧 aktualizacja testów po przejściu na nowy model dla błedów http (nagłówek `X-Error-Format: "problem-details"`)
+- **PeppolInvoiceIntegrationTest.java**: 🔧 zmiany związane z dodaniem placeholderów w `invoice_template_pef_correction.xml`
+- **ExceptionsApiIntegrationTest.java**: 🔧 dodanie testów o obsługę kolejnych typów błedów http zwracanych z API
+
+### 2.2 integrationTest.resources
+- **xml/invoices/sample/invoice_template_pef_correction.xml**: 🔧 dodanie placeholderów dla numeru KSeF i daty faktury korygowanej
+
+### 2.3 resources
+- **application.yaml**: 🔧 dodanie domyślnie nagłówka `X-Error-Format: "problem-details"`
+- **application-demo.yaml**: 🔧 dodanie domyślnie nagłówka `X-Error-Format: "problem-details"`
+- **application-prod.yaml**: 🔧 dodanie domyślnie nagłówka `X-Error-Format: "problem-details"`
+
+---
+## 3. Podsumowanie
+
+| Typ zmiany  | Liczba plików |
+|-------------|---------------|
+| ➕ dodane    | 8             |
+| 🔧 zmienione | 20            |
+| ➖ usunięte  | 0             |
+

demo-web-app/build.gradle.kts

@@ -8,7 +8,7 @@ plugins {
 }
 
 group = "pl.akmf.ksef"
-version = "3.0.23"
+version = "3.0.24"
 
 java {
     toolchain {
@@ -44,6 +44,7 @@ val testcontainersVersion = "1.21.3"
 val awaitilityVersion = "4.2.0"
 val googleZxing = "3.5.3"
 val reflectionsVersion = "0.10.2"
+val xadesVersion = "6.3"
 
 dependencies {
     implementation(project(":ksef-client"))
@@ -79,6 +80,10 @@ dependencies {
     implementation("org.awaitility:awaitility:${awaitilityVersion}")
 
     testImplementation("org.reflections:reflections:${reflectionsVersion}")
+
+    // weryfikacje podpisu
+    integrationTestImplementation("eu.europa.ec.joinup.sd-dss:dss-validation:${xadesVersion}")
+    integrationTestImplementation("eu.europa.ec.joinup.sd-dss:dss-policy-jaxb:${xadesVersion}")
 }
 
 sourceSets {

demo-web-app/src/integrationTest/java/pl/akmf/ksef/sdk/AuthorizationIntegrationTest.java

@@ -1,5 +1,12 @@
 package pl.akmf.ksef.sdk;
 
+import eu.europa.esig.dss.detailedreport.DetailedReport;
+import eu.europa.esig.dss.model.DSSDocument;
+import eu.europa.esig.dss.model.InMemoryDocument;
+import eu.europa.esig.dss.simplereport.SimpleReport;
+import eu.europa.esig.dss.spi.validation.CommonCertificateVerifier;
+import eu.europa.esig.dss.validation.SignedDocumentValidator;
+import eu.europa.esig.dss.validation.reports.Reports;
 import jakarta.xml.bind.JAXBException;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
@@ -29,7 +36,10 @@
 import pl.akmf.ksef.sdk.util.IdentifierGeneratorUtils;
 
 import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.security.KeyStore;
 import java.security.PrivateKey;
+import java.security.cert.Certificate;
 import java.security.cert.X509Certificate;
 import java.time.Duration;
 import java.time.OffsetDateTime;
@@ -114,6 +124,54 @@ void authorizeByKSeFCertificateWithECDSaEncoding() throws Exception {
         Assertions.assertNotNull(tokenResponse);
     }
 
+//    @Test
+    void signExportableKeysTest() throws Exception {
+        String alias = "ec-key-alias"; // your alias
+
+        String contextNip = IdentifierGeneratorUtils.generateRandomNIP();
+        AuthenticationChallengeResponse challenge = ksefClient.getAuthChallenge();
+        AuthTokenRequest authTokenRequest = new AuthTokenRequestBuilder()
+                .withChallenge(challenge.getChallenge())
+                .withContextNip(contextNip)
+                .withSubjectType(SubjectIdentifierTypeEnum.CERTIFICATE_SUBJECT)
+                .build();
+
+        String xml = AuthTokenRequestSerializer.authTokenRequestSerializer(authTokenRequest);
+
+        KeyStore ks = KeyStore.getInstance("Windows-MY");
+        ks.load(null, null);
+
+        if (ks.containsAlias(alias)) {
+            PrivateKey privateKey = (PrivateKey) ks.getKey(alias, null);
+            Certificate cert = ks.getCertificate(alias);
+
+            String signedXml = signatureService.sign(xml.getBytes(), (X509Certificate) cert, privateKey);
+            System.out.println("----");
+            System.out.println("signedXml: " + signedXml);
+            System.out.println("----");
+
+            byte[] bytes = signedXml.getBytes(StandardCharsets.UTF_8);
+            DSSDocument document = new InMemoryDocument(bytes);
+            SignedDocumentValidator validator = SignedDocumentValidator.fromDocument(document);
+            validator.setCertificateVerifier(new CommonCertificateVerifier());
+            Reports reports = validator.validateDocument();
+            SimpleReport simpleReport = reports.getSimpleReport();
+            List<String> simpleSignatureIds = simpleReport.getSignatureIdList();
+
+            for (String id : simpleSignatureIds) {
+                boolean valid = simpleReport.isValid(id);
+                System.out.println("Simple signature " + id + " - valid: " + valid);
+            }
+
+            DetailedReport detailedReport = reports.getDetailedReport();
+            boolean valid = detailedReport.isCertificateValidation();
+            System.out.println("Detailed report - valid: " + valid);
+
+        } else {
+            Assertions.fail("Could not find alias: " + alias + "in KeyStore.");
+        }
+    }
+
     @Test
     void authorizeByKSeFCertificateWithRSaEncoding() throws Exception {
         String contextNip = IdentifierGeneratorUtils.generateRandomNIP();

demo-web-app/src/integrationTest/java/pl/akmf/ksef/sdk/BatchIntegrationTest.java

@@ -6,10 +6,11 @@
 import org.springframework.beans.factory.annotation.Autowired;
 import pl.akmf.ksef.sdk.api.builders.batch.OpenBatchSessionRequestBuilder;
 import pl.akmf.ksef.sdk.api.services.DefaultCryptographyService;
-import pl.akmf.ksef.sdk.client.ExceptionDetails;
 import pl.akmf.ksef.sdk.client.model.ApiException;
-import pl.akmf.ksef.sdk.client.model.ExceptionResponse;
 import pl.akmf.ksef.sdk.client.model.UpoVersion;
+import pl.akmf.ksef.sdk.client.model.exceptions.BadRequestApiError;
+import pl.akmf.ksef.sdk.client.model.exceptions.BadRequestApiException;
+import pl.akmf.ksef.sdk.client.model.exceptions.BadRequestProblemDetails;
 import pl.akmf.ksef.sdk.client.model.session.EncryptionData;
 import pl.akmf.ksef.sdk.client.model.session.EncryptionInfo;
 import pl.akmf.ksef.sdk.client.model.session.FileMetadata;
@@ -187,12 +188,13 @@ void shouldThrowWhileSendWithExceededTotalPackageSize() throws JAXBException, IO
         // API KSeF powinno odrzucić żądanie ze względu na przekroczony limit fileSize
         ApiException apiException = assertThrows(ApiException.class, () ->
                 ksefClient.openBatchSession(request, UpoVersion.UPO_4_3, accessToken));
-        ExceptionResponse exceptionResponse = apiException.getExceptionResponse();
-        Assertions.assertFalse(exceptionResponse.getException().getExceptionDetailList().isEmpty());
-        ExceptionDetails details = exceptionResponse.getException().getExceptionDetailList().getFirst();
-        Assertions.assertEquals(21405, details.getExceptionCode());
-        Assertions.assertEquals("Błąd walidacji danych wejściowych.", details.getExceptionDescription());
-        Assertions.assertEquals("'fileSize' must be less than or equal to '5000000000'.", details.getDetails().getFirst());
+        BadRequestApiException badRequestApiException = (BadRequestApiException) apiException;
+        BadRequestProblemDetails exceptionResponse = badRequestApiException.getBadRequestProblemDetails();
+        Assertions.assertFalse(exceptionResponse.getErrors().isEmpty());
+        BadRequestApiError error = exceptionResponse.getErrors().getFirst();
+        Assertions.assertEquals(21405, error.getCode());
+        Assertions.assertEquals("Błąd walidacji danych wejściowych.", error.getDescription());
+        Assertions.assertEquals("'fileSize' must be less than or equal to '5000000000'.", error.getDetails().getFirst());
     }
 
     // Weryfikuje odrzucenie paczki przekraczającej limit rozmiaru 100 MiB (przed szyfrowaniem).
@@ -287,12 +289,13 @@ void shouldThrowWhileCloseSessionWithoutAllParts() throws JAXBException, IOExcep
 
         ApiException apiException = assertThrows(ApiException.class, () ->
                 closeSession(sessionReferenceNumber, accessToken));
-        ExceptionResponse exceptionResponse = apiException.getExceptionResponse();
-        Assertions.assertFalse(exceptionResponse.getException().getExceptionDetailList().isEmpty());
-        ExceptionDetails details = exceptionResponse.getException().getExceptionDetailList().getFirst();
-        Assertions.assertEquals(21205, details.getExceptionCode());
-        Assertions.assertEquals("Pakiet nie może być pusty.", details.getExceptionDescription());
-        Assertions.assertEquals("Nie przesłano zadeklarowanej '2' części pliku.", details.getDetails().getFirst());
+        BadRequestApiException badRequestApiException = (BadRequestApiException) apiException;
+        BadRequestProblemDetails exceptionResponse = badRequestApiException.getBadRequestProblemDetails();
+        Assertions.assertFalse(exceptionResponse.getErrors().isEmpty());
+        BadRequestApiError error = exceptionResponse.getErrors().getFirst();
+        Assertions.assertEquals(21205, error.getCode());
+        Assertions.assertEquals("Pakiet nie może być pusty.", error.getDescription());
+        Assertions.assertEquals("Nie przesłano zadeklarowanej '2' części pliku.", error.getDetails().getFirst());
     }
 
     // Weryfikuje odrzucenie paczki z liczbą części przekraczającą maksymalny limit 50.
@@ -325,12 +328,13 @@ void shouldThrowWhileSendWithExceededPartCount() throws JAXBException, IOExcepti
         // API KSeF odrzuca żądanie z przekroczoną liczbą części
         ApiException apiException = assertThrows(ApiException.class, () ->
                 ksefClient.openBatchSession(request, UpoVersion.UPO_4_3, accessToken));
-        ExceptionResponse exceptionResponse = apiException.getExceptionResponse();
-        Assertions.assertFalse(exceptionResponse.getException().getExceptionDetailList().isEmpty());
-        ExceptionDetails details = exceptionResponse.getException().getExceptionDetailList().getFirst();
-        Assertions.assertEquals(21161, details.getExceptionCode());
-        Assertions.assertEquals("Przekroczono dozwoloną liczbę części pakietów.", details.getExceptionDescription());
-        Assertions.assertEquals("Liczba części pliku musi być mniejsza lub równa niż 50.", details.getDetails().getFirst());
+        BadRequestApiException badRequestApiException = (BadRequestApiException) apiException;
+        BadRequestProblemDetails exceptionResponse = badRequestApiException.getBadRequestProblemDetails();
+        Assertions.assertFalse(exceptionResponse.getErrors().isEmpty());
+        BadRequestApiError error = exceptionResponse.getErrors().getFirst();
+        Assertions.assertEquals(21161, error.getCode());
+        Assertions.assertEquals("Przekroczono dozwoloną liczbę części pakietów.", error.getDescription());
+        Assertions.assertEquals("Liczba części pliku musi być mniejsza lub równa niż 50.", error.getDetails().getFirst());
     }
 
     // Weryfikuje wykrycie nieprawidłowo zaszyfrowanego klucza symetrycznego.