classe ara::idsm::QualifiedEventsReceiver

A classe QualifiedEventsReceiver serve para a recepção de Security Events qualificados do Intrusion Detection System Manager (IdsM) [SWS_AIDSM_10800] no contexto do cabeçalho ara/idsm/qualified_events_receiver.h.

Uso e instanciação: uma instância é criada através do construtor QualifiedEventsReceiver(const ara::core::InstanceSpecifier& instance) para uma PPort modelada [SWS_AIDSM_10801]. O modelo de classes impõe semântica de movimento: o construtor de cópia [SWS_AIDSM_10804] e o operador de atribuição por cópia [SWS_AIDSM_10806] estão excluídos (= delete). Em vez disso, instâncias podem ser transferidas através do construtor de movimento [SWS_AIDSM_10803] ou da atribuição por movimento [SWS_AIDSM_10805].

Concorrência e thread safety: a criação da instância através do construtor parametrizado [SWS_AIDSM_10801], bem como a movimentação por meio do construtor de movimento [SWS_AIDSM_10803], estão especificadas como thread-safe. Por outro lado, a destruição através do destruidor virtual [SWS_AIDSM_10802] e a atribuição por movimento via operator= [SWS_AIDSM_10805] estão definidas como não seguras para threads (not thread-safe). Os chamadores devem, portanto, garantir que operações de atribuição e destruição não sejam executadas de forma concorrente no mesmo objeto.

Tratamento de erros: todas as funções especificadas de ciclo de vida e atribuição – construtores, destruidor e atribuição por movimento – estão identificadas com noexcept e, portanto, não disparam exceções.

O método síncrono Offer() do cabeçalho ara/idsm/qualified_events_receiver.h é chamado sem parâmetros de passagem e serve para sinalizar a prontidão para recepção de eventos de segurança qualificados [SWS_AIDSM_10808]. Mediante a chamada bem-sucedida, é permitido ao Intrusion Detection System Manager (IdsM) encaminhar subsequentemente eventos qualificados para a instância através do método de callback OnEventQualification [SWS_AIDSM_10808].

A assinatura declara a função com noexcept, de modo que não ocorrem exceções C++, e fornece como tipo de retorno ara::core::Result<void> [SWS_AIDSM_10808]. Como a especificação não lista códigos de erro específicos, um erro transportado no resultado provavelmente indica que a disponibilização no IdsM falhou. Pergunta Q-2eca6bb6ce27ec78 (aberta) Em relação à concorrência, a operação está expressamente especificada como não segura para threads (not thread-safe) [SWS_AIDSM_10808]. Os chamadores devem, portanto, assegurar que chamadas de Offer() não sejam executadas sem proteção em paralelo a outros métodos da instância.

O padrão de disponibilização corresponde à interação padronizada no módulo aidsm, no qual provedores de serviço habilitam ativamente seus serviços para o IdsM:

• No cabeçalho ara/idsm/timestamp_provider.h, a função Offer() ativa a disponibilização de carimbos de data/hora e permite ao IdsM a chamada de GetTimestamp [SWS_AIDSM_10408].
• No cabeçalho ara/idsm/context_data_provider.h, Offer() habilita a modificação de dados de contexto, permitindo ao IdsM chamadas de ModifyContextData [SWS_AIDSM_10507].

A função puramente virtual OnEventQualification é definida no cabeçalho ara/idsm/qualified_events_receiver.h e serve como callback abstrato para a receção de eventos de segurança qualificados (QSEv) com dados de contexto não versionados [SWS_AIDSM_10807].

Utilização e parâmetros: O método é chamado aquando da ocorrência de um evento qualificado pelo Intrusion Detection System Manager (IdsM). Declara os seguintes parâmetros de interface [SWS_AIDSM_10807]:

• event (EventIdType): Identificador unívoco do evento qualificado.
• contextData (ara::core::Optional<ContextDataType>): Dados de contexto não versionados opcionais do evento.
• timestamp (ara::core::Optional<TimestampType>): Carimbo de data/hora opcional da ocorrência do evento.

O método não possui valor de retorno (void) e não lança exceções (noexcept) [SWS_AIDSM_10807].

Concorrência: O método de callback está especificado como não sendo seguro para threads (not thread-safe) [SWS_AIDSM_10807]. As implementações do lado da aplicação devem, por isso, assegurar que chamadas concorrentes ou acessos concorrentes sejam sincronizados.

Ciclo de vida e interação: As chamadas a OnEventQualification por parte do IdsM dependem do estado: só são permitidas após a ativação através de Offer [SWS_AIDSM_10808] e são impedidas por StopOffer [SWS_AIDSM_10809]. Para eventos com dados de contexto versionados ou sem dados de contexto, existe uma sobrecarga independente de OnEventQualification com VersionedContextDataType [SWS_AIDSM_10810].

usar

A função-membro puramente virtual OnEventQualification serve como callback específico da aplicação para notificação sobre um evento de segurança qualificado (QSEv) com dados de contexto versionados ou sem dados de contexto [SWS_AIDSM_10810]. A função declara os seguintes parâmetros de transferência:

• event (EventIdType): Identificador do evento qualificado [SWS_AIDSM_10810].
• contextData (ara::core::Optional<VersionedContextDataType>): Dados de contexto versionados opcionais do evento [SWS_AIDSM_10810].
• timestamp (ara::core::Optional<TimestampType>): Carimbo de data/hora opcional do evento [SWS_AIDSM_10810].

A função não retorna nenhum valor (void) e está declarada com o especificador noexcept [SWS_AIDSM_10810].

Zusammenspiel e ciclo de vida

Para que o IdsM possa efetuar chamadas a OnEventQualification, o recetor tem de ativar previamente a interface através de Offer [SWS_AIDSM_10808]. Com StopOffer, chamadas subsequentes à função de callback voltam a ser impedidas [SWS_AIDSM_10809]. Enquanto SWS_AIDSM_10810 processa dados de contexto versionados, existe para dados não versionados a assinatura alternativa em conformidade com [SWS_AIDSM_10807].

Simultaneidade e tratamento de erros

A função está especificada como não segura para threads (not thread-safe) [SWS_AIDSM_10810]. Presumivelmente, a instância chamadora do IdsM ou a implementação concreta tem de assegurar a respetiva sincronização, caso as chamadas ocorram concorrentemente. Pergunta Q-6b9e9525b682ad70 (aberta) Como a assinatura está definida como noexcept e não retorna nenhum código de erro, nenhumas exceções podem escapar dentro da implementação de callback [SWS_AIDSM_10810].

A função StopOffer no cabeçalho ara/idsm/qualified_events_receiver.h é chamada de acordo com [SWS_AIDSM_10809] para encerrar o oferecimento do serviço receptor para eventos de segurança qualificados. Por meio da chamada síncrona, assegura-se que o Intrusion Detection System Manager (IdsM) subsequentemente não encaminhe mais nenhuma chamada ao método de callback OnEventQualification.

Em relação ao uso e comportamento de interface, aplicam-se as seguintes propriedades:

• Assinatura e tratamento de erros: a função não recebe parâmetros e não possui valor de retorno (void StopOffer() noexcept;). Como está declarada como noexcept, ela não lança exceções e não fornece códigos de erro [SWS_AIDSM_10809].
• Concorrência: a operação está explicitamente declarada na especificação como not thread-safe [SWS_AIDSM_10809]. Os componentes chamadores devem, portanto, assegurar que chamadas de StopOffer sejam sincronizadas externamente em relação a outros acessos à mesma instância.
• Contexto de chamada: a chamada provavelmente deve ocorrer de forma conveniente no âmbito do encerramento ordenado ou durante o cancelamento de registro do receptor de eventos, antes que a instância seja destruída. Pergunta Q-77dc1d3a09426bdf (aberta)

O padrão de projeto existe de forma análoga em outros provedores de serviço do módulo aidsm. Assim, StopOffer no cabeçalho ara/idsm/timestamp_provider.h encerra chamadas subsequentes de GetTimestamp pelo IdsM [SWS_AIDSM_10409], enquanto a função de mesmo nome em ara/idsm/context_data_provider.h impede chamadas futuras de ModifyContextData [SWS_AIDSM_10508]. Ambas as interfaces relacionadas estão implementadas de forma igualmente não segura para threads.