Zum Hauptinhalt springen

Changelog

Alle relevanten Änderungen am FIT-Connect Java SDK werden in dieser Datei dokumentiert.

Das Format basiert auf Keep a Changelog und hält sich an Semantic Versioning.

[2.1.0] - 2024-07-24​

Hinzugefügt​

  • Attachment Chunking (Story)
    • Übertragung großer Attachment-Files (> 500 MB) als Fragmente
    • Abruf fragmentierter Attachments und zusammensetzen der Chunks zum ursprünglichen File
    • neue Methode Attachment.fromLargeAttachment() zum autom. Chunking
  • Basic Authentication über Nutzername und Passwort für die HTTP-Proxy Konfiguration (Story)
  • Zugriff auf den Issuer im Eventlog Status (Story)
  • Zugriff auf die AttachmentId (Story)
  • In der SubscriberConfig können die privaten Keys zur Entschlüsselung und zum Signieren auch direkt als JWK übergeben werden (Story)

Änderungen​

  • Update des Metadatenschemas auf 1.3.0
  • Update des SET-Schemas auf 1.2.2
  • Modulkonfiguration
    • die Module API und Core wurden in das Client-Modul integriert
    • damit ist der Client nicht mehr von zwei weiteren Modulen abhängig, sondern erzeugt im Build und beim Laden über Maven nur noch ein einzelnes Client-Modul

Entfernt​

Die Zip-Kompression im JWE-Header wurde entfernt (Story). Siehe hierzu:

RFC 8725, Sec. 3.6: Compression of data SHOULD NOT be done before encryption, because such compressed data often reveals information about the plaintext.

Aktualisierte Bibliotheken​

  • JWKValidator 2.1.1
  • Nimbus/Jose 9.37.3
  • Lombok 1.18.34
  • Jackson 2.17.2
  • JsonSchemaValidator 1.5.0
  • Junit 5.10.3
  • Maven-Surefire-Plugin 3.3.1
  • Maven-Failsafe-Plugin 3.3.1
  • Maven-Jar-Plugin 3.4.2
  • Maven-Checkstyle-Plugin 3.4.0
  • Maven-Javadoc-Plugin 3.8.0
  • Maven-Git-Commit-Plugin 9.0.1

[2.0.3] - 2024-05-23​

Änderungen​

Downgrade der Nimbus/Jose Library auf 9.37.x, um die Größenbeschränkung des Payloads bei aktivierter Zip-Compression im JWE Header aufzuheben. Siehe hierzu https://bitbucket.org/connect2id/nimbus-jose-jwt/issues/545

Aktualisierte Bibliotheken​

  • Nimbus/Jose 9.37

[2.0.2] - 2024-05-23​

Behobene Bugs​

  • Fix des transactionTimestamp Datentyps der PaymentInformation im Metadaten (Story)

Aktualisierte Bibliotheken​

  • Nimbus/Jose 9.39
  • Lombok 1.18.32
  • OkHttp 5.0.0-alpha.14
  • Jackson 2.17.1
  • JsonSchemaValidator 1.4.0
  • Logback 1.5.6
  • Mockito 5.12
  • Slf4j 2.0.13

[2.0.1] - 2024-03-15​

Behobene Bugs​

  • Die Validierung von ARS Schlüsseln bei der Abfrage von Routing-Informationen wurde so angepasst, dass auch Regionen die in einer anderen Region enthalten sind, korrekt geprüft werden (Story)

Änderungen​

Um im Log keine sensiblen Daten zu loggen wurden folgende Anpassungen in der Logback Konfiguration vorgenommen:

  • Das Loglevel für den Schema Validator wurde für com.networknt.* auf INFO gesetzt
  • Das Loglevel für den OkHttp Client wurde für okhttp3.* auf INFO gesetzt

Aktualisierte Bibliotheken​

  • JWK-Validator 2.1.0
  • Jackson 2.17.0
  • Logback 1.5.3
  • Mockito 5.11
  • Maven GPG Plugin 3.2.0
  • Maven Assembly Plugin 3.7.0
  • Maven Git Commit ID Plugin 8.0.1

[2.0.0] - 2024-02-20​

Hinzugefügt​

  • Bidirektionale Kommunikation mit FIT-Connect Antwortkanal (Story)
    • neue Submissions für einen existierenden Case senden
    • Antworten (Replies) auf Submissions senden
    • Antworten empfangen
    • Liste der verfügbaren Cases und Replies
    • aktuellen Status für Replies abfragen
    • Neuer FitConnect-ReplyChannel, der den öffentlichen Reply-Verschlüsselungsschlüssel und eine Liste von Verarbeitungsstandards überträgt
    • ReplyChannelKeyGenerator zur Erzeugung von ephemeral-keys für die Ver- und Entschlüsselung von Replies
  • ServiceType-Getter an der ReceivedSubmission (Story)
  • Setzen des ApplicationDate an der SendableSubmission über setApplicationDate(localDate) (Story)
    • Zurückdatieren des Einreichungsdatums
    • unabhängig vom technischen issued-at Zeitstempel der Submission
  • Konfiguration von HTTP-Client-Timeouts in der neuen HttpConfig (Story)
    • readTimeout setzen
    • writeTimeout setzen
    • connectionTimeout setzen
  • Für die Validierung lokaler Fachdatenschemata können beliebige Schema-formate vom lokalen Dateisystem über die config.yaml oder ApplicationConfig hinzugefügt werden (Story)
  • Neue DTOs für Callback-Benachrichtigung über neue Submissions und Replies (Story)
  • Zugriff auf den technischen submitted-at (iat) Zeitstempel an der ReceivedSubmission (Story)
  • Neuer KeyGenerator zur Erzeugung von X.509-Testzertifikaten, RSA-KeyPairs und JWKs (Story)

Änderungen​

Details zu den Änderungen im Zusammenhang mit diesem Update entnehmen Sie bitte dem Update Guide

  • Aktualisierte Schemata:
    • Metadaten-Schema 1.2.0
    • SET-Schema 1.2.1
  • Model-Klassen vom Client-Modul wurden in das API-Modul verschoben (Story)
  • Umbenennung von API-Methoden (Story)
    • statische ClientFactory-Methoden zu ClientFactory.create...(config)
    • statische ReplyChannel-Methoden zu ReplyChannel.of...()
    • DefaultEnvironments für TEST, STAGE und PROD wurden umbenannt in Environments
  • Das EventLog Status Objekt wurde umbenannt von SubmissionStatus in Status (Story)
    • dieses wird sowohl für getSubmissionStatus als auch für getReplyStatus verwendet
    • enthält das neue issuedAt Datum
  • Die ReceivedSubmission implementiert Comparable<Date> und wird autom. nach issuedAt sortiert (Story)
  • Neues HttpConfig-Objekt (Story):
    • enthält HTTP TimeoutConfig
    • ProxyConfig wurde nach HttpConfig verschoben
  • Die Polling-Methode getAvailableSubmissionsForDestination (ohne Limit und Offset) lädt nun implizit ALLE verfügbaren Einreichungen (rekursiv in 25er-Chunks). Die macht es einfacher, eine Liste aller verfügbaren Einreichungen zu laden, ohne explizit Paging einzusetzen. (Story)
  • Der JWKValidator 2.0.0 cached Anfragen, was die Geschwindigkeit der Schlüsselüberprüfung verbessert
  • Detailliertere Protokollierung von Requests mit HTTP-Methode, Statuscode und benötigter Zeit (Story)

Behobene Bugs​

  • Das Zeitstempelformat in der Callback-Validierung wurde von Millisekunden auf Sekunden korrigiert (Story)
  • Korrigierte Json Validator Locale, welche zu Build-Fehlern in Umgebungen mit deutscher Locale führte (Story)
  • Der korrekte Content-Type Header (cty) wurde zum JWE-Header hinzugefügt (Story)
  • Ein Fehler, der bei der Validierung von Routing-Services mit mehreren Diensten innerhalb der JWT-Claims auftrat, wurde behoben (Story)

Veraltet​

Die Attachment fromString-Methoden werden ab SDK-Version 3.0.0 als deprecated markiert, da sie bei falscher Verwendung zu Problemen mit der Zeichencodierung führen können (Story).

Entfernt​

  • Command-Line-Client (Story)
    • der ausführbare Kommandozeilen-Client wurde aus dem SDK entfernt und ist nun ein eigenständiges Projekt
    • siehe FIT-Connect Tools Repository für weitere Informationen
  • Apache Tika-Library (wurde vom cli-Modul verwendet)
  • JCommander-Library (wurde vom cli-Modul verwendet)

Aktualisierte Bibliotheken​

  • JWK-Validator 2.0.0
  • Nimbus/Jose 9.37.3
  • OkHttp 5.0.0-alpha.12
  • Lombok 1.18.30
  • Jackson 2.16.1
  • Logback 1.5.0
  • SLF4J 2.0.12
  • SnakeYaml 2.2
  • JsonSchemaValidator 1.3.3
  • Junit 5.10.2
  • Mockito 5.10
  • Wiremock 3.0.1

[1.0.0] - 2023-08-04​

Hinzugefügt​

  • JWK Test-Zertifikat Generator
  • Integration des Demo-Projekts ins SDK

Änderungen​

  • JWK-Validator 1.5.1
  • Mockito Core 5.4.0
  • JSON Schema Validator 1.0.86
  • Maven 3.9.4
  • OpenCSV 5.8

[1.0.0-rc.1] - 2023-03-05​

  • Dies war die erste Release-Candidate Version des SDKs.