classe ara::idsm::ReportingModeProvider

A classe ara::idsm::ReportingModeProvider disponibiliza mecanismos para consultar e definir Reporting Modes para eventos relevantes para a segurança no Intrusion Detection System Manager [SWS_AIDSM_10600]. A instanciação é realizada de forma thread-safe através de um ara::core::InstanceSpecifier para um PPort modelado [SWS_AIDSM_10601]. Em tempo de execução, os métodos GetReportingMode e SetReportingMode permitem a leitura bem como a alteração do modo de um evento configurado. Uma vez que estes métodos não são thread-safe, um acesso concorrente tem de ser sincronizado externamente. Em caso de IDs de eventos desconhecidos, os métodos devolvem o erro IdsmErrc::kUnknownEventId.

mais ›

Contexto

A classe ara::idsm::ReportingModeProvider é definida no cabeçalho ara/idsm/reporting_mode_provider.h e serve, dentro do módulo Adaptive idsm, para disponibilizar e controlar dinamicamente Reporting Modes para o Intrusion Detection System Manager (IdsM) [SWS_AIDSM_10600]. Numa arquitetura de veículos em rede, o IdsM monitoriza eventos relevantes para a segurança (Security Events). Através do ReportingModeProvider, aplicações ou serviços de plataforma responsáveis podem aceder a eventos de segurança configurados a fim de apurar ou definir de que forma um evento deve ser comunicado ao sistema IdsM. A vinculação à arquitetura é efetuada através de um PPort modelado, especificado aquando da instanciação [SWS_AIDSM_10601].

Ciclo de vida

A classe é declarada como final [SWS_AIDSM_10600], o que exclui herança ou especialização polimórfica. A criação de um objeto realiza-se através do construtor explícito ReportingModeProvider(const ara::core::InstanceSpecifier& instance) [SWS_AIDSM_10601]. Através do parâmetro instance, é estabelecida a ligação ao PPort modelado concreto [SWS_AIDSM_10601]. Interpretação: a designação da instância transmitida aponta provavelmente para o deployment da interface configurado no modelo AUTOSAR para o serviço IdsM. Pergunta Q-a7c5bdfa7e2ba42b (aberta)

No que diz respeito à concorrência, o construtor é especificado como thread-safe (thread-safe) [SWS_AIDSM_10601]. Por outro lado, os dois métodos operacionais para ler e escrever os modos de relatório são explicitamente assinalados como não thread-safe (not thread-safe) [SWS_AIDSM_10602], [SWS_AIDSM_10603]. Se várias threads acederem em paralelo à mesma instância de ReportingModeProvider, o chamador tem de sincronizar este acesso externamente. O ciclo de vida da instância é tipicamente associado ao tempo de vida da aplicação utilizadora, que cria, gere e destrói o objeto após o término da interação.

Caminho de utilização

A utilização típica divide-se na inicialização, na consulta do estado atual e no ajuste, conforme necessário, do modo de relatório.

Em primeiro lugar, a aplicação instancia o provider para a porta prevista, especificando o respetivo InstanceSpecifier [SWS_AIDSM_10601]. Em seguida, o Reporting Mode atual para um determinado evento configurado pode ser consultado com o método GetReportingMode [SWS_AIDSM_10602]. O método devolve um ara::core::Result<ReportingModeType> que encapsula o modo ou sinaliza a ocorrência de um erro [SWS_AIDSM_10602].

Se a situação de segurança ou a configuração de diagnóstico exigir uma modificação, SetReportingMode é chamado [SWS_AIDSM_10603]. Esta chamada recebe o identificador eventId bem como o novo reportingMode e devolve um ara::core::Result<void> [SWS_AIDSM_10603]. A aplicação verifica o resultado para assegurar a conclusão bem-sucedida da alteração de configuração.

Diagrama de sequência: fluxo de utilização típico para consulta e atualização de um modo de relatório através do provider. Fontes: [SWS_AIDSM_10601], [SWS_AIDSM_10602], [SWS_AIDSM_10603]

Cenários de erro

Todos os métodos da classe são declarados com noexcept [SWS_AIDSM_10601], [SWS_AIDSM_10602], [SWS_AIDSM_10603]. O tratamento de erros é, portanto, realizado inteiramente sem exceções de C++, através do modelo de erros próprio do AUTOSAR ara::core::Result.

Tanto na obtenção através de GetReportingMode [SWS_AIDSM_10602] como na definição através de SetReportingMode [SWS_AIDSM_10603], pressupõe-se que o eventId fornecido corresponda a um evento de segurança configurado. Se for passado um identificador de evento desconhecido ou não registado no sistema, a operação falha e o Result contém o código de erro IdsmErrc::kUnknownEventId [SWS_AIDSM_10602], [SWS_AIDSM_10603]. Os componentes chamadores têm de avaliar o Result antes de aceder ao valor e, em caso de erro, iniciar o tratamento de erros ou o registo em log correspondente.