clase ara::idsm::EventReporter

La clase EventReporter está definida en el encabezado ara/idsm/event_reporter.h y sirve en la Adaptive Platform para notificar eventos relevantes para la seguridad (Security Events) al Intrusion Detection System Management (IdsM) [SWS_AIDSM_10101].

Uso e instanciación

Para utilizar la clase se debe crear una instancia a través del constructor parametrizado, que recibe un identificador del tipo const ara::core::InstanceSpecifier& [SWS_AIDSM_10301]. Este constructor inicializa el notificador para el puerto del tipo SecurityEventReportInterface configurado en el modelo del sistema [SWS_AIDSM_10301]. Interpretación: la vinculación al puerto modelado probablemente presuponga que el InstanceSpecifier transferido esté definido coherentemente en el manifiesto ARXML y pueda resolverse en tiempo de ejecución. Pregunta Q-ed2f606f7446b4ba (abierta)

Tratamiento de errores y concurrencia

En cuanto al comportamiento frente a excepciones, la construcción está especificada con noexcept [SWS_AIDSM_10301]; por tanto, el constructor no lanza excepciones de C++. Con respecto a la concurrencia, la función de construcción está declarada explícitamente como segura para hilos (thread-safe) [SWS_AIDSM_10301]. Interpretación: de este modo, múltiples hilos probablemente puedan instanciar en paralelo instancias de notificador para sus respectivos puertos, sin que se requieran mecanismos de sincronización externos. Pregunta Q-ddff9884a7b7cad8 (abierta)

Interacción

La interacción con el IdsM se basa en la asignación de la instancia al puerto de modelado correspondiente: mediante la especificación como EventReporter para el SecurityEventReportInterface [SWS_AIDSM_10301], la clase representa la interfaz a través de la cual las aplicaciones adaptativas transmiten eventos de seguridad a la arquitectura de IdsM [SWS_AIDSM_10101].

usar

La función ReportEvent de la cabecera ara/idsm/event_reporter.h sirve para notificar un Security Event con datos de contexto [SWS_AIDSM_10304]. En la llamada se transfiere el argumento contextData de tipo ContextDataType. Además, se puede indicar opcionalmente la cantidad de eventos mediante count (tipo CountType), cuyo valor por defecto está fijado en 1 [SWS_AIDSM_10304]. La función no devuelve ningún valor (void) y, al ser una declaración noexcept, no lanza excepciones.

Concurrencia y restricciones

La interfaz está definida explícitamente como segura para subprocesos (thread-safe) [SWS_AIDSM_10304] y se puede invocar en paralelo desde varios subprocesos sin medidas de sincronización adicionales. Dado que la firma no proporciona ningún parámetro para una marca temporal, la captura del momento de notificación presumiblemente tiene lugar de forma interna al admitir el evento. Pregunta Q-ab652343cc8009e9 (abierta)

Interacción con interfaces afines

La especificación define varias sobrecargas afines de ReportEvent para distintos alcances de información:

• Notificación de un evento sin datos de contexto ni marca temporal [SWS_AIDSM_10302].
• Notificación con marca temporal, pero sin datos de contexto [SWS_AIDSM_10303].
• Notificación con datos de contexto y marca temporal explícita [SWS_AIDSM_10305].
• Notificaciones con datos de contexto versionados de tipo VersionedContextDataType, bien sin marca temporal [SWS_AIDSM_10306] o bien con marca temporal [SWS_AIDSM_10307].

usar

La función [SWS_AIDSM_10305] transmite un Security Event con datos de contexto específicos de la aplicación, así como una marca temporal explícita. A través del argumento contextData de tipo ContextDataType se transfieren datos útiles relativos al evento, mientras que timestamp (tipo const TimestampType) registra el momento exacto de captura. El parámetro opcional count (tipo const CountType) tiene el valor por defecto 1 y permite notificar varias incidencias acumuladas. La función no proporciona ningún valor devuelto (void).

Concurrencia y tratamiento de errores

La declaración se encuentra en la cabecera ara/idsm/event_reporter.h y está especificada explícitamente como segura para subprocesos (thread-safe) [SWS_AIDSM_10305]. Por consiguiente, las llamadas pueden realizarse desde subprocesos paralelos sin sincronización adicional. Mediante la designación con noexcept no se propagan excepciones a nivel de API; por lo tanto, los posibles errores de reenvío o almacenamiento en búfer presumiblemente sean procesados internamente por el Intrusion Detection System Manager. Pregunta Q-3b45e18c9a106a0f (abierta)

Interacción y alternativas

La interfaz pertenece a un grupo de funciones de notificación sobrecargadas. Si no se requieren datos de contexto o marcas temporales, se dispone de variantes más ligeras como [SWS_AIDSM_10302] (solo contador), [SWS_AIDSM_10303] (con marca temporal), así como [SWS_AIDSM_10304] (solo con datos de contexto). Si se requieren formatos de datos estructurados o versionados, deben utilizarse en su lugar las sobrecargas con VersionedContextDataType conforme a [SWS_AIDSM_10306] y [SWS_AIDSM_10307].

La función ReportEvent proporciona en el módulo aidsm una interfaz para notificar un Security Event enriquecido con datos de contexto versionados [SWS_AIDSM_10306]. Está definida en la cabecera ara/idsm/event_reporter.h y no devuelve ningún valor (void).

Al invocarla se procesan los siguientes parámetros:

• contextData (tipo VersionedContextDataType): transfiere la información de contexto versionada del evento de seguridad acaecido [SWS_AIDSM_10306].
• count (tipo const CountType, valor predeterminado 1): determina opcionalmente el número de incidencias acumuladas de este evento [SWS_AIDSM_10306].

En lo que respecta a la concurrencia, la función está especificada como segura para subprocesos (thread-safe) [SWS_AIDSM_10306]. Mediante la declaración con noexcept se garantiza que la ejecución no lanza excepciones de C++.

En combinación con las demás funciones de notificación, esta sobrecarga cubre un caso de uso específico:

• Para la notificación sin datos de contexto, están disponibles las variantes sin marca temporal [SWS_AIDSM_10302] o con marca temporal [SWS_AIDSM_10303].
• Para datos de contexto no versionados (ContextDataType), existen sobrecargas sin marca temporal [SWS_AIDSM_10304] y con marca temporal [SWS_AIDSM_10305].
• Si se van a transmitir datos de contexto versionados junto con una marca temporal explícita, se debe emplear en su lugar [SWS_AIDSM_10307]. Interpretación: dado que [SWS_AIDSM_10306] no posee ningún parámetro de marca temporal, el momento de captura presumiblemente se genera internamente durante la ejecución de la llamada. Pregunta Q-23e60086ab409b24 (abierta)

Uso y contexto de llamada

La función ReportEvent de la cabecera ara/idsm/event_reporter.h sirve para notificar un Security Event con datos de contexto versionados explícitos, así como una marca temporal [SWS_AIDSM_10307]. Recibe los datos versionados contextData de tipo VersionedContextDataType, una marca temporal timestamp de tipo TimestampType y opcionalmente el número de eventos count de tipo CountType, cuyo valor predeterminado está fijado por defecto en 1 [SWS_AIDSM_10307].

Concurrencia y tratamiento de errores

La función está especificada explícitamente como segura para subprocesos (thread-safe) [SWS_AIDSM_10307] y, por lo tanto, puede invocarse en paralelo desde varios subprocesos de manera segura. Como la firma no contempla ningún valor devuelto (void) y está declarada con noexcept [SWS_AIDSM_10307], los errores no se señalan mediante excepciones de C++ ni a través de códigos de estado; interpretación: las situaciones de error en la transmisión de eventos presumiblemente son tratadas o registradas internamente por el módulo aidsm. Pregunta Q-002c5fbc3202bcc2 (abierta)

Interacción de las sobrecargas

La función representa la variante especializada para eventos en los que se generan tanto una marca temporal como datos adicionales versionados [SWS_AIDSM_10307]. Complementa las demás sobrecargas de ReportEvent dentro del informador:

• Notificación sin datos de contexto y sin marca temporal [SWS_AIDSM_10302] o meramente con marca temporal [SWS_AIDSM_10303].
• Notificación con datos de contexto no versionados sin marca temporal [SWS_AIDSM_10304], así como con marca temporal [SWS_AIDSM_10305].
• Notificación con datos de contexto versionados sin marca temporal [SWS_AIDSM_10306].

usar

La función ReportEvent se proporciona a través de la cabecera ara/idsm/event_reporter.h y sirve para notificar Security Events sin datos de contexto ni marca temporal [SWS_AIDSM_10302]. Acepta como parámetro el número de eventos count de tipo CountType, el cual está predefinido de forma predeterminada con el valor 1 [SWS_AIDSM_10302]. La función no tiene valor devuelto (void) y garantiza mediante la designación noexcept que no se lanzan excepciones [SWS_AIDSM_10302]. En cuanto a la semántica de ejecución, el procesamiento interno presumiblemente no sea bloqueante, ya que no se especifica ningún tipo de retorno sincrónico de estado o asincrónico Future. Pregunta Q-6e240ebde61d8a83 (abierta)

Concurrencia y tratamiento de errores

Según la especificación, la llamada está clasificada como segura para subprocesos (thread-safe) y, por lo tanto, se puede invocar con seguridad desde subprocesos concurrentes [SWS_AIDSM_10302]. No existen códigos de error específicos, dado que la firma está fijada a void y noexcept [SWS_AIDSM_10302].

Interacción y alternativas

La función representa la sobrecarga más simple para la notificación de eventos. Siempre que se deba transmitir información ampliada, se dispone de sobrecargas afines:

• Notificación con marca temporal mediante TimestampType [SWS_AIDSM_10303].
• Notificación con datos de contexto regulares mediante ContextDataType [SWS_AIDSM_10304], así como combinada con marca temporal [SWS_AIDSM_10305].
• Notificación con datos de contexto versionados mediante VersionedContextDataType [SWS_AIDSM_10306], así como combinada con marca temporal [SWS_AIDSM_10307].

La función ReportEvent sirve para notificar un Security Event indicando explícitamente una marca temporal [SWS_AIDSM_10303]. Está declarada en la cabecera ara/idsm/event_reporter.h [SWS_AIDSM_10303].

usar

La llamada se realiza con el parámetro obligatorio timestamp de tipo TimestampType, así como con el contador opcional count de tipo CountType, que está predefinido con el valor por defecto 1 [SWS_AIDSM_10303]. La función no tiene valor devuelto (void) [SWS_AIDSM_10303].

Tratamiento de errores y concurrencia

La función está declarada como noexcept, razón por la cual no se producen excepciones de C++ [SWS_AIDSM_10303]. Dado que el tipo de retorno es void, no se transmiten códigos de error; por tanto, los errores que se produzcan presumiblemente se descartan internamente o se registran de forma asincrónica [SWS_AIDSM_10303]. Pregunta Q-2d3cd862f6867ba9 (abierta) Con respecto a la concurrencia, la función está catalogada como segura para subprocesos (thread-safe) y puede invocarse de manera segura desde subprocesos paralelos [SWS_AIDSM_10303].

Interacción

La función forma parte de una familia de interfaces ReportEvent sobrecargadas en el módulo aidsm:

• Sin marca temporal y sin datos de contexto, se encuentra disponible la función básica [SWS_AIDSM_10302].
• Con datos de contexto regulares de tipo ContextDataType, existen sobrecargas sin marca temporal [SWS_AIDSM_10304] y con marca temporal [SWS_AIDSM_10305].
• Con datos de contexto versionados de tipo VersionedContextDataType, están disponibles las firmas correspondientes sin marca temporal [SWS_AIDSM_10306] y con marca temporal [SWS_AIDSM_10307].