klasse ara::idsm::ContextDataProvider

De abstracte klasse ara::idsm::ContextDataProvider dient voor het applicatiespecifiek beschikbaar stellen en wijzigen van contextgegevens voor de Intrusion Detection System Manager [SWS_AIDSM_10500]. Applicaties leiden over van de klasse, implementeren de callback ModifyContextData en sturen de vrijgave voor IdsM via de methoden Offer en StopOffer [SWS_AIDSM_10507]. De instantie kan niet worden gekopieerd, en aangezien centrale methoden niet thread-safe zijn, vereist gelijktijdige toegang vermoedelijk externe synchronisatie (interpretatie). Vraag (open)

meer ›

Context

De klasse ara::idsm::ContextDataProvider dient voor het beschikbaar stellen en wijzigen van contextgegevens voor het subsysteem Intrusion Detection System Manager (IdsM) [SWS_AIDSM_10500]. Binnen de beveiligingsarchitectuur fungeert de klasse als interface tussen een veiligheidsrelevante applicatie en de IdsM-dienst. Aangezien de lidfunctie ModifyContextData als puur virtueel is gespecificeerd [SWS_AIDSM_10509], vormt ContextDataProvider een abstracte basisklasse. Een applicatie leidt een eigen implementatie af om bij veiligheidsrelevante gebeurtenissen specifieke contextgegevens aan te vullen. De binding aan de architectuurconfiguratie vindt plaats via een ara::core::InstanceSpecifier voor de gemodelleerde provider-poort [SWS_AIDSM_10501].

Levenscyclus

Het aanmaken van een instantie vindt expliciet plaats via de constructor onder opgave van de poort-identifier (ara::core::InstanceSpecifier) en de bufferparameters additionalBytes en originalContextDataOffset [SWS_AIDSM_10501]. Deze constructor is als thread-safe gedeclareerd [SWS_AIDSM_10501]. Om eenduidig eigenaarschap voor het interface-eindpunt te garanderen, zijn zowel de copy constructor [SWS_AIDSM_10504] als de copy assignment operator [SWS_AIDSM_10506] verwijderd. Overdracht van de instantie is mogelijk via move-semantiek: de move constructor is thread-safe [SWS_AIDSM_10503], terwijl de assignment operator operator= met rvalue-referentie als niet thread-safe is gedefinieerd [SWS_AIDSM_10505].

Na het aanmaken bevindt de instantie zich in inactieve toestand. Pas door de expliciete aanroep van Offer() wordt de registratie geactiveerd en wordt IdsM geautoriseerd om ModifyContextData aan te roepen [SWS_AIDSM_10507]. Via StopOffer() kan deze autorisatie op elk moment weer worden ingetrokken [SWS_AIDSM_10508]. Voorafgaand aan de vernietiging van het object via de virtuele destructor [SWS_AIDSM_10502] moet volgens gangbare praktijk vermoedelijk StopOffer() worden aangeroepen om lopende callbacks door IdsM tijdig te stoppen (interpretatie). Vraag Q-ee65caee57919f00 (open) De virtuele destructor is gespecificeerd als niet thread-safe [SWS_AIDSM_10502].

Gebruikspad

Een typische use-case begint met de definitie van een applicatiespecifieke klasse die overerft van ContextDataProvider en de methode ModifyContextData implementeert [SWS_AIDSM_10509]. Na de instantiëring roept de applicatie Offer() aan om de contextgegevens beschikbaar te stellen voor IdsM [SWS_AIDSM_10507]. Zodra IdsM een beveiligingsgebeurtenis registreert waarvoor contextgegevens moeten worden aangevuld, roept het subsysteem de callback ModifyContextData aan [SWS_AIDSM_10509]. De methode ontvangt het datagebied als ara::core::Span<std::uint8_t> evenals de identificatie EventIdType, werkt de bufferinhoud bij en meldt het daadwerkelijke aantal bytes terug als ara::core::Result<std::size_t> [SWS_AIDSM_10509]. Als het beschikbaar stellen van gegevens moet worden beëindigd, roept de applicatie StopOffer() aan [SWS_AIDSM_10508].

Sequentiediagram: interactievolgorde tussen applicatie, ContextDataProvider en IdsM van de activering via Offer via de callback tot de deactivering via StopOffer. Bronnen: [SWS_AIDSM_10507], [SWS_AIDSM_10508], [SWS_AIDSM_10509]

Foutscenario's

Alle methoden van de interface zijn gedeclareerd met noexcept; fouten worden geretourneerd via het type ara::core::Result. De aanroep van Offer() retourneert een ara::core::Result<void> [SWS_AIDSM_10507], die door de applicatie moet worden gecontroleerd om eventuele fouten bij het leveren van de dienst af te vangen. Als de provider de gevraagde contextgegevens in ModifyContextData niet kan schrijven, meldt de implementatie vermoedelijk een systeemspecifieke fout in ara::core::Result<std::size_t> (interpretatie) [SWS_AIDSM_10509]. Vraag Q-585e19770d59309e (open)

Wat betreft concurrency moet worden opgemerkt dat Offer() [SWS_AIDSM_10507], StopOffer() [SWS_AIDSM_10508], ModifyContextData() [SWS_AIDSM_10509], de assignment operator [SWS_AIDSM_10505] en de destructor [SWS_AIDSM_10502] als niet thread-safe zijn gespecificeerd. Als aanroepen van deze methoden parallel vanuit meerdere threads plaatsvinden zonder externe synchronisatie, leidt dit vermoedelijk tot data races en onvoorspelbaar gedrag (interpretatie). Vraag Q-80b83a52aba53d67 (open)