class ara::idsm::EventReporter

Die Klasse EventReporter ist im Header ara/idsm/event_reporter.h definiert und dient in der Adaptive Platform dem Melden von sicherheitsrelevanten Ereignissen (Security Events) an das Intrusion Detection System Management (IdsM) [SWS_AIDSM_10101].

Verwendung und Instanziierung

Zur Verwendung der Klasse muss eine Instanz über den parametrisierten Konstruktor erzeugt werden, der einen Bezeichner vom Typ const ara::core::InstanceSpecifier& entgegennimmt [SWS_AIDSM_10301]. Dieser Konstruktor initialisiert den Reporter für den im Systemmodell konfigurierten Port vom Typ SecurityEventReportInterface [SWS_AIDSM_10301]. Interpretation: Die Bindung an den modellierten Port dürfte voraussetzen, dass der übergebene InstanceSpecifier im ARXML-Manifest konsistent definiert und zur Laufzeit auflösbar ist. Frage Q-ed2f606f7446b4ba (offen)

Fehlerbehandlung und Nebenläufigkeit

Hinsichtlich des Ausnahmeverhaltens ist die Konstruktion mit noexcept spezifiziert [SWS_AIDSM_10301]; der Konstruktor wirft somit keine C++-Exceptions. In Bezug auf Nebenläufigkeit ist die Konstruktionsfunktion explizit als thread-safe deklariert [SWS_AIDSM_10301]. Interpretation: Mehrere Threads dürften somit parallel Reporter-Instanzen für ihre jeweiligen Ports instanziieren können, ohne dass externe Synchronisationsmechanismen erforderlich sind. Frage Q-ddff9884a7b7cad8 (offen)

Zusammenspiel

Das Zusammenspiel mit dem IdsM basiert auf der Zuordnung der Instanz zu dem jeweiligen Modellierungsport: Durch die Spezifikation als EventReporter für das SecurityEventReportInterface [SWS_AIDSM_10301] stellt die Klasse die Schnittstelle dar, über die adaptive Applikationen Sicherheitsereignisse an die IdsM-Architektur übermitteln [SWS_AIDSM_10101].

Verwendung

Die Funktion ReportEvent aus dem Header ara/idsm/event_reporter.h dient dem Melden eines Security Events mit Kontextdaten [SWS_AIDSM_10304]. Beim Aufruf wird das Argument contextData vom Typ ContextDataType übergeben. Zusätzlich kann optional die Anzahl der Ereignisse über count (Typ CountType) angegeben werden, deren Standardwert auf 1 festgelegt ist [SWS_AIDSM_10304]. Die Funktion liefert keinen Rückgabewert (void) und wirft als noexcept-Deklaration keine Exceptions.

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist explizit als thread-safe definiert [SWS_AIDSM_10304] und kann ohne zusätzliche Synchronisationsmaßnahmen aus mehreren Threads parallel aufgerufen werden. Da die Signatur keinen Parameter für einen Zeitstempel bereitstellt, dürfte die Erfassung des Meldezeitpunkts vermutlich intern bei der Annahme des Ereignisses erfolgen. Frage Q-ab652343cc8009e9 (offen)

Zusammenspiel mit verwandten Schnittstellen

Die Spezifikation definiert mehrere verwandte Überladungen von ReportEvent für unterschiedliche Informationsumfänge:

• Meldung eines Ereignisses ohne Kontextdaten und Zeitstempel [SWS_AIDSM_10302].
• Meldung mit Zeitstempel, aber ohne Kontextdaten [SWS_AIDSM_10303].
• Meldung mit Kontextdaten und explizitem Zeitstempel [SWS_AIDSM_10305].
• Meldungen mit versionierten Kontextdaten vom Typ VersionedContextDataType, entweder ohne Zeitstempel [SWS_AIDSM_10306] oder mit Zeitstempel [SWS_AIDSM_10307].

Verwendung

Die Funktion [SWS_AIDSM_10305] übermittelt ein Security Event mit anwendungsspezifischen Kontextdaten sowie einem expliziten Zeitstempel. Über das Argument contextData vom Typ ContextDataType werden ereignisbezogene Nutzdaten übergeben, während timestamp (Typ const TimestampType) den genauen Erfassungszeitpunkt festhält. Der optionale Parameter count (Typ const CountType) besitzt den Standardwert 1 und gestattet das Melden mehrerer kumulierter Vorkommnisse. Die Funktion liefert keinen Rückgabewert (void).

Nebenläufigkeit und Fehlerbehandlung

Die Deklaration befindet sich im Header ara/idsm/event_reporter.h und ist explizit als threadsicher (thread-safe) spezifiziert [SWS_AIDSM_10305]. Aufrufe können demnach ohne zusätzliche Synchronisation aus parallelen Threads erfolgen. Durch die Kennzeichnung mit noexcept werden auf API-Ebene keine Exceptions propagiert; etwaige Fehler bei der Weiterleitung oder Pufferung dürften daher intern durch den Intrusion Detection System Manager verarbeitet werden. Frage Q-3b45e18c9a106a0f (offen)

Zusammenspiel und Alternativen

Die Schnittstelle gehört zu einer Gruppe überladener Reporting-Funktionen. Falls keine Kontextdaten oder Zeitstempel erforderlich sind, stehen leichtere Varianten wie [SWS_AIDSM_10302] (nur Zähler), [SWS_AIDSM_10303] (mit Zeitstempel) sowie [SWS_AIDSM_10304] (nur mit Kontextdaten) zur Verfügung. Werden strukturierte bzw. versionierte Datenformate benötigt, sind stattdessen die Überladungen mit VersionedContextDataType gemäß [SWS_AIDSM_10306] und [SWS_AIDSM_10307] einzusetzen.

Die Funktion ReportEvent stellt im Modul aidsm eine Schnittstelle zum Melden eines Security Events bereit, das mit versionierten Kontextdaten angereichert ist [SWS_AIDSM_10306]. Sie ist im Header ara/idsm/event_reporter.h definiert und liefert keinen Rückgabewert (void).

Beim Aufruf werden folgende Parameter verarbeitet:

• contextData (Typ VersionedContextDataType): Übergibt die versionierten Kontextinformationen des aufgetretenen Sicherheitsereignisses [SWS_AIDSM_10306].
• count (Typ const CountType, Vorgabewert 1): Bestimmt optional die Anzahl der kumulierten Vorkommnisse dieses Events [SWS_AIDSM_10306].

Bezüglich der Nebenläufigkeit ist die Funktion als threadsicher (thread-safe) spezifiziert [SWS_AIDSM_10306]. Durch die Deklaration mit noexcept ist zugesichert, dass die Ausführung keine C++-Ausnahmen wirft.

Im Zusammenspiel mit den übrigen Meldefunktionen deckt diese Überladung einen spezifischen Anwendungsfall ab:

• Zur Meldung ohne Kontextdaten stehen die Varianten ohne Zeitstempel [SWS_AIDSM_10302] oder mit Zeitstempel [SWS_AIDSM_10303] bereit.
• Für unversionierte Kontextdaten (ContextDataType) existieren Überladungen ohne Zeitstempel [SWS_AIDSM_10304] sowie mit Zeitstempel [SWS_AIDSM_10305].
• Sollen versionierte Kontextdaten zusammen mit einem expliziten Zeitstempel übermittelt werden, ist stattdessen [SWS_AIDSM_10307] zu verwenden. Interpretation: Da [SWS_AIDSM_10306] keinen Zeitstempelparameter besitzt, dürfte der Erfassungszeitpunkt intern bei Aufrufausführung generiert werden. Frage Q-23e60086ab409b24 (offen)

Verwendung und Aufrufkontext

Die Funktion ReportEvent aus dem Header ara/idsm/event_reporter.h dient dem Melden eines Security Events mit expliziten versionierten Kontextdaten sowie einem Zeitstempel [SWS_AIDSM_10307]. Sie nimmt die versionierten Daten contextData vom Typ VersionedContextDataType, einen Zeitstempel timestamp vom Typ TimestampType sowie optional die Ereignisanzahl count vom Typ CountType entgegen, welche standardmäßig mit dem Wert 1 vorbelegt ist [SWS_AIDSM_10307].

Nebenläufigkeit und Fehlerbehandlung

Die Funktion ist explizit als thread-safe spezifiziert [SWS_AIDSM_10307] und kann somit sicher parallel aus mehreren Threads aufgerufen werden. Da die Signatur keinen Rückgabewert vorsieht (void) und mit noexcept deklariert ist [SWS_AIDSM_10307], werden Fehler weder über C++-Exceptions noch über Statuscodes signalisiert; Interpretation: Fehlersituationen bei der Ereignisübermittlung dürften intern durch das Modul aidsm behandelt oder protokolliert werden. Frage Q-002c5fbc3202bcc2 (offen)

Zusammenspiel der Überladungen

Die Funktion stellt die spezialisierte Variante für Ereignisse dar, bei denen sowohl ein Zeitstempel als auch versionierte Zusatzdaten anfallen [SWS_AIDSM_10307]. Sie ergänzt die weiteren Überladungen von ReportEvent innerhalb des Reporters:

• Meldung ohne Kontextdaten und Zeitstempel [SWS_AIDSM_10302] oder rein mit Zeitstempel [SWS_AIDSM_10303].
• Meldung mit unversionierten Kontextdaten ohne Zeitstempel [SWS_AIDSM_10304] sowie mit Zeitstempel [SWS_AIDSM_10305].
• Meldung mit versionierten Kontextdaten ohne Zeitstempel [SWS_AIDSM_10306].

Verwendung

Die Funktion ReportEvent wird über den Header ara/idsm/event_reporter.h bereitgestellt und dient dem Melden von Security Events ohne Kontextdaten und Zeitstempel [SWS_AIDSM_10302]. Als Parameter akzeptiert sie die Ereignisanzahl count vom Typ CountType, welche standardmäßig mit dem Wert 1 vorbelegt ist [SWS_AIDSM_10302]. Die Funktion besitzt keinen Rückgabewert (void) und garantiert über die Kennzeichnung noexcept, dass keine Ausnahmen geworfen werden [SWS_AIDSM_10302]. Hinsichtlich der Ausführungssemantik dürfte die Verarbeitung intern nicht blockierend erfolgen, da kein synchroner Status- oder asynchroner Future-Rückgabetyp spezifiziert ist. Frage Q-6e240ebde61d8a83 (offen)

Nebenläufigkeit und Fehlerbehandlung

Gemäß Spezifikation ist der Aufruf als thread-safe eingestuft und kann somit sicher aus nebenläufigen Threads aufgerufen werden [SWS_AIDSM_10302]. Spezifische Fehlercodes existieren nicht, da die Signatur auf void und noexcept festgelegt ist [SWS_AIDSM_10302].

Zusammenspiel und Alternativen

Die Funktion stellt die einfachste Überladung zur Ereignismeldung dar. Sofern erweiterte Informationen übermittelt werden sollen, stehen verwandte Überladungen zur Verfügung:

• Meldung mit Zeitstempel über TimestampType [SWS_AIDSM_10303].
• Meldung mit regulären Kontextdaten über ContextDataType [SWS_AIDSM_10304] sowie kombiniert mit Zeitstempel [SWS_AIDSM_10305].
• Meldung mit versionierten Kontextdaten über VersionedContextDataType [SWS_AIDSM_10306] sowie kombiniert mit Zeitstempel [SWS_AIDSM_10307].

Die Funktion ReportEvent dient dem Melden eines Security-Events unter expliziter Angabe eines Zeitstempels [SWS_AIDSM_10303]. Sie ist im Header ara/idsm/event_reporter.h deklariert [SWS_AIDSM_10303].

Verwendung

Der Aufruf erfolgt mit dem obligatorischen Parameter timestamp vom Typ TimestampType sowie dem optionalen Zähler count vom Typ CountType, der mit dem Standardwert 1 vorbelegt ist [SWS_AIDSM_10303]. Die Funktion besitzt keinen Rückgabewert (void) [SWS_AIDSM_10303].

Fehlerbehandlung und Nebenläufigkeit

Die Funktion ist als noexcept deklariert, weshalb keine C++-Exceptions auftreten [SWS_AIDSM_10303]. Da der Rückgabetyp void ist, werden keine Fehlercodes übermittelt; auftretende Fehler dürften daher intern verworfen oder asynchron protokolliert werden [SWS_AIDSM_10303]. Frage Q-2d3cd862f6867ba9 (offen) Hinsichtlich der Nebenläufigkeit ist die Funktion als thread-safe eingestuft und kann sicher aus parallelen Threads aufgerufen werden [SWS_AIDSM_10303].

Zusammenspiel

Die Funktion ist Teil einer Familie überladener ReportEvent-Schnittstellen im Modul aidsm:

• Ohne Zeitstempel und ohne Kontextdaten steht die Basisfunktion zur Verfügung [SWS_AIDSM_10302].
• Mit regulären Kontextdaten vom Typ ContextDataType existieren Überladungen ohne Zeitstempel [SWS_AIDSM_10304] sowie mit Zeitstempel [SWS_AIDSM_10305].
• Mit versionierten Kontextdaten vom Typ VersionedContextDataType stehen entsprechende Signaturen ohne Zeitstempel [SWS_AIDSM_10306] und mit Zeitstempel [SWS_AIDSM_10307] bereit.