Skip to content

Releases: gematik/api-kim

KIM v1.5.3

14 Dec 07:51
69f2c94
Compare
Choose a tag to compare

== KIM 1.5.3 Release Notes

=== Neu

  • Das Feature Anwendungskennzeichen wurde in der gemSpec_CM_KOMLE und in der gemSpec_FD_KOMLE spezifiziert. Das Clientmodul ermöglicht die Administration über den Administrationsmodul und der Account Manager realisiert die Eintragung in den VZD.
  • Anforderungen zum Einbringen der Anwendungskennung am Clientmodule sind erstellt (A_23713)
  • Anforderungen zur Einbringung der Anwendungskennung durch den KIM Fachdienst in den VZD sind erstellt (A_23718, A_23722)
  • Anforderungen für die Einbringung der Anwendungskennzeichen für den Verzeichnisdienst sind erstellt.
  • Anforderungen für das Reporting der neuen X-KIM-Header wurden erstellt (neu Clientmodul: A_23737, Fachdienst: A_23746, A_23748). Für das Betriebsdatenreporting wurde ein Report erstellt.
  • Am neuen Interface I_ServiceInformation wurde eine Passwort Policy in der Operation getServiceInformation beschrieben und kann dort abgefragt werden (A_23753, A_23754).
  • A_23541 wurde erstellt. Wenn im Benutzernamen die IP-Adresse und der Port angegeben sind, dann hat dies Vorrang vor DNS-SD.
  • Neue Anforderung erstellt A_23554 - "Weiterleitung MAIL FROM - SIZE-Parameter".
  • Anforderung "A_23467 - Übermittlung der KAS-Datenmenge" wurde erstellt
  • Neues Kapitel (6. Fehlernachrichten) in Primärsystem Leitfaden zu KIM auf gitHub
  • Ein neues Headerelement X-KIM-Support wurde in Github für Primärsysteme definiert.
  • Robustes Verhalten, bei fehlerhafter Zertifikatsprüfung durch Konnektor (A_24063)
  • Für Basis Consumer: eingeschränkte Befüllung der mail Attribute im VZD-Eintrag (A_24039, noVzdMailEntry)
  • Der Account Manager wertet das neue Attribut noVzdMailEntry in den Operationen setAccount und registerAccount aus (A_24038).
  • Eine neue Mailserver-Anforderung zur Prüfung der Größe einer KIM-Nachricht wurde definiert (A_24022).
  • Die Schnittstelle I_ServiceInformation hat eine neue Operation getAppTags zum Download der Anwendungskennzeichen.

=== Geändert

  • Anforderungen zum cachen wurden präzisiert, Konfigurationsparameter wurden erweitert (A_22348, A_22416-01, A_22340-01, KOM-LE-A_2026-01, KOM-LE-A_2061-01).
  • AttachmentServices.yaml wurde erweitert, Tabelle 4: Operationen vom KAS wurde ergänzt (A_19375-05 - KAS – Implementierung der Schnittstelle).
  • Bezüglich des Header "Expires" wurde der Text der Anforderung mit dem Hinweis auf RFC4021 ergänzt (A_22417-01).
  • Die Festlegungen zu setAccount und deregisterAccount wurden optimiert (KOM-LE-A_2187-05).
  • Das Prüfverfahren "Produkttest" wurde für KOM-LE-A_2304 entfernt.
  • Die Anforderungen A_20189-02 und A_21389 wurden von der Clientmodul- in die Fachdienst-Spezifikation verschoben.
  • Es wurde ein Hinweistext unter die Anforderung A_21387-03 platziert, dass eine Aktualisierung bei Verwendung eines HBA erst bei einem Mailabruf erfolgen kann, da der POP3 Benutzername die benötigte userID bereitstellt.
  • Die KIM-Version 1.5 kann jetzt um ein optionales "+" erweitert sein. Verweise auf die gematik Dokumente und OpenAPI Definitionen wurden aktualisiert.
  • Passwortschutz der PKCS#12 Datei ist nun optional (A_19468-03)
  • Prüfverfahren "Produkttest" wurde für KOM-LE-A_2091-01 zugewiesen
  • Prüfverfahren wurde für GS-A_4864 auf Herstellererklärung geändert
  • GS-A_5138-02 "Performance – KOM-LE-Fachdienst – TLS-Verbindungsaufbau unter Last" wurde geändert.
  • A_20127-01 "Performance - KOM-LE-Fachdienst – Spitzenlastvorgaben für den KAS" wurde geändert.
  • KOM-LE-A_2187-05 geändert; Abhängigkeit für createCert vom VZD-Eintrag wurde entfernt. Der Aufbau des Json-Web-Token wurde geändert.
  • Die Anforderung "KOM-LE-A_2187-05 - Authentifizierung des KOM-LE-Teilnehmers über AUT-Zertifikat am AccountManager" wurde geändert, so dass die Aufruf getAccount keinen Abgleich mit dem VZD benötigt.
  • Eine Bildungsregel zur Ermittlung der HTTP Endpunkte wurde festgelegt (siehe Anforderung "A_19523 - Service-Discovery Administrationsmodul").
  • Die Anforderung "KOM-LE-A_2179-02 - Vermerk in der Nachricht bei erfolgreicher Entschlüsselung" wurde überarbeitet, der separate Fehlertext wurde entfernt, X-KIM-DecryptionResult (ID 00) wird gesetzt.
  • Anpassung der AttachementService.yaml Operation addAttachment (required true für Content-Length und Content-Disposition; A_22427-01)
  • Anforderung A_19385-03 wurde bzgl. Karenzzeit erweitert,
  • Anforderung A_19370-05 bzgl. dem unterschiedlichen Verhalten bei Fehlern angepasst.
  • Anpassung der AttachmentService.yaml ist erfolgt, neues Header-Element X-KIM-KAS-Size wurde definiert: A_23467 - Übermittlung der KAS-Datenmenge
  • Die neue Variante 1.5+ wurde in die Spezifikationen aufgenommen und als weitere mögliche Option genannt.
  • Die Anforderung KOM-LE-A_2136 wurde auf Herstellererklärung geändert
  • Präzisierung Kapitel "3.7 Administrationsmodul"; falsche Passage in Topic 4 gestrichen.
  • Operation add_attachement (AttachmentService.yaml) wurde bei der Description ergänzt: Pro Form-Part wird genau eine Adresse spezifiziert und der Form-Part wird mehrfach angegeben (exploded=true)
  • KOM-LE-A_2176-01 - Prüfen auf gültiges ENC-Zertifikat für den Empfänger im RCPT-Kommando" wurde geändert. Kein Abbruch wenn ein Empfänger ohne Zertifikat vorhanden.
  • Anforderung KOM-LE-A_2167-05 "Sperrung des Accounts" wurde präzisiert.
  • Anforderung A_19356-07 wurde verständlicher formuliert und ein Hinweis zum Content-Transfer-Encoding: base64 ergänzt.
  • Die Anforderung KOM-LE-A_2135-01 wurde auf Herstellererklärung geändert
  • A_19524-02 - Anforderung Verwaltung Resource Records Typs für Service Discovery, KIM" wurde präzisiert, feste Vorgabe für die Ports zw. den FD
  • A_19378-02 - KAS - prüfen der Größe der verschlüsselten E-Mail-Daten" mit Hinweis auf Quota erweitert
  • Anforderung A_22420-01 auf serverseitige Authentisierung geändert
  • Tab_Fehlercodes_KOMLE-Clientmodule" mit neuen Fehlercodes (4018 + 4019) erweitert, Afo A_20650-06 neuer Index
  • Beispiele in Kapitel "3.4.4.2.1 Entschlüsselung" wurden angepasst
  • Tab_Konfig_Parameter Konfigurationsparameter Fachdienst KOM-LE wurde erweitert: "Löschfrist von Nachrichten nach der endgültigen Deregistrierung"; KOM-LE-A_2139-03 Konfiguration Fachdienst (neuer Index)
  • Nachweis der Anforderungen KOM-LE-A_2184 wurde auf Herstellererklärung geändert.
  • Nachweis der Anforderungen A_19454 und A_19455 wurde auf Herstellererklärung geändert.
  • Die Schnittstelle I_AccountManager_Service wurde überarbeitet. Nicht schreibbare Attribute wurden aus setAccount entfernt.
  • Die Message-ID wurde in allen Beispielen ergänzt.
  • Die api-kim in GitHub wurde an KIM 1.5.3 angepasst (https://github.com/gematik/api-kim).
  • Teilweise Umbenennung von KOM-LE in KIM.
  • Optimierung des Verhaltens bei positiver Integritätsprüfung (KOM-LE-A_2050-06)
  • Optimierung des Verhaltens bei der initialen Registrierung des KOM-LE-Teilnehmers (A_19458-02).
  • Der Zeichensatz für den Local part von KIM-Adressen wurde genauer festgelegt (A_21455-01).
  • Der KAS muss die http HEAD Methode unterstützen, damit Clientmodule die Grüße der KAS Daten vor dem Download abfragen können (A_24002).

=== Gelöscht

  • Die Protokollierung von Performance Daten im Clientmodul wurde entfernt (geändert: KOM-LE-A_2079-01, gelöscht: KOM-LE-A_2084, KOM-LE-A_2088, KOM-LE-A_2089).
  • GS-A_5136 "Performance – KOM-LE-Clientmodul – Bearbeitungszeit unter Last" wurde gestrichen.
  • A_20130 "Performance - KOM-LE-Fachdienst - TLS Kanal KAS" wurde gelöscht.

KIM v1.5.2-1

23 Sep 05:35
531453e
Compare
Choose a tag to compare

KIM v1.5.2-1 - Release Notes

New feature

  • added new operation to revoke deregistration to I_AccountManager_Service in v2.3.0 (see I_AccountManager_Service for more details)
  • added new integrity checks to ensure correct setting of the from header in an e-mail
  • added an example for processing of an email that needs to be stored at the kas (see E-Mail Verarbeitung for more details)

Changes

  • change behavior for big attachments (see Umgang mit großen Anhängen for more details)
  • I_AccountManager_Service added some additional response codes
  • updated I_Attachment_Service to v2.3.0 based on some changes on response codes(see I_Attachment_Service for more details)
  • updated I_AccountLimit_Servic to 1.1.0 based on setting a minimum value for maxMailSize(see I_AccountLimit_Service for more details)
  • removed I_Directory_Application_Maintenance from this repo and replaced references to the github repository of the vzd
  • replaced sequence diagrams with plantuml based ones
  • updated json schema for kim attachment data structure