C_12394_Anlage

Inhaltsverzeichnis

1 Änderungsbeschreibung

Es ist Verbesserungsbedarf identifiziert worden, der zur Klarheit der Regelungen um die Selbstauskunft Version 2 beiträgt. Dafür werden sowohl die Textstellen um Kapitel 2.5.3.2, als auch die Anforderungen angepasst. Die Regelungen sind größtenteils redaktionell.

2 Änderung in gemSpec_Perf

2.1 Anpassung an Kapitel 2.5.3.2 Selbstauskunft Version 2

Die Selbstauskunft Version 2, auch Selbstauskunft v2, setzt bei der Erfassung und Übermittlung auf JSON-basierten Inhalt und löst die Lieferung von Dateien ab. Dieses Datenliefermodell ist die Evolution der Selbstauskunft Version 1. Durch die direkte Übermittlung in einem HTTP-Request als POST-Body werden Abläufe schlanker und Automatisierung gefördert. Die Einführung eines neuen Inhaltsschemas begünstigt die zukünftige Erweiterbarkeit ohne Abhängigkeiten zu dezentralen Produkttypen und erweitert die geltenden Regelungen nach [gemSpec_OM#2.4] in moderner Weise.

Es kann nur jeweils ein Schema für einen Produkttyp gewählt werden. Die Verarbeitung kann auch in geeigneter Form außerhalb des Produkttyps umgesetzt werden, sodass der Anbieter die vollständige Aufbereitung und Übermittlung gewährleistet und die Erfüllung nicht direkt über den Produkttyp erfolgt. Für Produkttypen mit ZETA-Guard gelten diese Regelungen nicht. Diese liefern analoge Informationen über die Telemetriedaten.

<< Ablösung und Aktualisierung der Anforderung: >>

A_26181 - Performance - Selbstauskunft v2 - Format und Übermittlung

Der Produkttyp MUSS notwendige Metadaten für die Selbstauskunft im JSON-Format gemäß A_26180 erfassen, verarbeiten und an die Schnittstelle I_OpsData_Update der Betriebsdatenerfassung gemäß [gemSpec_SST_LD_BD] versenden. [<=]

<< Entfernen des Hinweistextes unter der Anforderung, da bereits im obigen Text darauf eingegangen wird: >>

Hinweis: Die Verarbeitung kann auch in geeigneter Form außerhalb des Produkttyps umgesetzt werden, sodass der Anbieter die vollständige Aufbereitung und Übermittlung gewährleitet und die Erfüllung nicht direkt über den Produkttyp erfolgt.

<< Aktualisierte Anforderung: >>

A_26181-01 - Performance - Selbstauskunft v2 - Format und Übermittlung

Der Produkttyp MUSS notwendige Metadaten für die Selbstauskunft im JSON-Format gemäß Schemadefinition erfassen, verarbeiten und an die Schnittstelle I_OpsData_Update der Betriebsdatenerfassung gemäß [gemSpec_SST_LD_BD] versenden. [<=]

<< Ablösung der Anforderung: >>

A_26180 - Performance - Selbstauskunft v2 - Grundgerüst

Der Produkttyp MUSS folgende Werte als Grundgerüst für die Selbstauskunft v2 im angegebenen Format zusammenstellen und liefern.
{

"timestamp": < Zeitangabe als String gemäß ISO 8601 unter expliziter Angabe einer Zeitzone im Format YYYY-MM-DDTHH:mm:ss[.fff]Z, als String >,
"ci":  < logische CI-ID des abgefragten Dienstes gemäß TI-ITSM, als String >,
"host": < Hostname der liefernden Instanz mit maximal 50 Zeichen, als String>,
"ptv": < Produkttypversion gem. gemSpec_OM::ProductTypeVersion, als String >,
"pv": < Produktversion gem. gemSpec_OM::Tab_ProdIdent*, als String >,
"konv": < Konfigurationsversion gem. [A_20219-*], als String >,
"sv": < Übermittelte Schemaversion der Selbstauskunftslieferung, als Integer >
}
Bei der Erstellung der Selbstauskunft ist darauf zu achten, dass weder Whitespaces noch Newlines zwischen JSON-Elementen enthalten sind (kein Indenting) und Vorgaben nach [RFC7493] eingehalten werden. [<=]

<< Entfernen des Hinweistextes unter der Anforderung: >>

Hinweis: Wird nur das Grundgerüst geliefert, so ist der Wert der Schemaversion (sv) mit 0 zu belegen.

2.3.5.2.1 Schemadefinitionen

In diesem Kapitel werden die verschiedenen Schemaversionen der Selbstauskunft gelistet.

<< Aktualisierte Anforderung mit neuem Titel "[...] - Schemaversion 1" statt "[...] - Grundgerüst": >>

A_26180-01 - Performance - Selbstauskunft v2 - Schemaversion 1

Der Produkttyp MUSS folgende Werte für die Selbstauskunft v2 im angegebenen Format zusammenstellen und liefern.
{

"timestamp": < Zeitangabe als String gemäß ISO 8601 unter expliziter Angabe einer Zeitzone im Format YYYY-MM-DDTHH:mm:ss[.fff]Z, als String >,
"ci":  < logische CI-ID des abgefragten Dienstes gemäß TI-ITSM, als String >,
"ptv": < Produkttypversion gem. gemSpec_OM::ProductTypeVersion, als String >,
"pv": < Produktversion gem. gemSpec_OM::Tab_ProdIdent*, als String >,
"konv": < Konfigurationsversion gem. [A_20219-*], als String >,
"sv": 1
}
Bei der Erstellung der Selbstauskunft ist darauf zu achten, dass weder Whitespaces noch Newlines zwischen JSON-Elementen enthalten sind (kein Indenting) und Vorgaben nach [RFC7493] eingehalten werden. [<=]

<< Stornierung der Anforderung, da nicht für ZeroTrust-Anwendungen nutzbar: >>

A_27271 - Performance - Selbstauskunft v2 - Schemaversion 1

Der Produkttyp MUSS folgende Werte für die Selbstauskunft v2 im angegebenen Format zusammenstellen und liefern.
{

"timestamp": < Zeitangabe als String gemäß ISO 8601 unter expliziter Angabe einer Zeitzone im Format YYYY-MM-DDTHH:mm:ss[.fff]Z, als String >,
"ci":  < logische CI-ID des abgefragten Dienstes gemäß TI-ITSM, als String >,
"host": < Hostname der liefernden Instanz, als String>,
"ptv": < Produkttypversion gem. gemSpec_OM::ProductTypeVersion des Resource Servers, als String >,
"pv": < Produktversion gem. gemSpec_OM::Tab_ProdIdent des Resource Servers, als String >,
"konv": < Konfigurationsversion gem. [A_20219-01] des Resource Servers, als String >,
"ztpv": < Produktversion gem. gemSpec_OM::Tab_ProdIdent des ZETA-Guard, als String >,
"ztkonv": < Konfigurationsversion gem. [A_20219-01] des ZETA-Guard, als String >,
"sv": 1
} [<=]