Figure 10.10: Ethernet security event ref

1. Diagrammtyp & Architektur-Kontext

• Diagrammtyp: AUTOSAR ECUC-Parameterdefinitions-Metamodell (UML-Klassendiagramm auf Basis des ECU Configuration Metamodels).
• Technischer Zweck & Einordnung: Spezifikation der Konfigurationsstruktur des BSW-Moduls EthIf (Ethernet Interface) zur Anbindung an den Intrusion Detection System Manager (IdsM). Das Modell definiert die Konfigurationscontainer, Schalter und symbolischen Referenzen, über die sicherheitsrelevante Frame-Verwerfungen auf Ethernet-Ebene als Security Events an den IdsM gemeldet werden.

2. Komponenten, Entitäten & Schnittstellen

• EthIfGeneral (EcucParamConfContainerDef):
  • Wurzel-/Allgemein-Container der EthIf-Konfiguration.
  • Hält via Komposition (+parameter) den booleschen Parameter EthIfEnableSecurityEventReporting (EcucBooleanParamDef, defaultValue = false).
  • Hält via Komposition (+subContainer) den optionalen Container EthIfSecurityEventRefs.
• EthIfSecurityEventRefs (EcucParamConfContainerDef):
  • Sub-Container unterhalb von EthIfGeneral mit Multiplizität [0..1].
  • Bündelt alle Security-Event-Referenzen des Ethernet-Interfaces.
• Security Event Referenzen (EcucReferenceDef):
  • Enthalten in EthIfSecurityEventRefs mit jeweils Multiplizität [0..1] und requiresSymbolicNameValue = true:
    1. ETHIF_SEV_DROP_UNKNOWN_ETHERTYPE: Event-Referenz bei Verwerfung von Frames mit unbekanntem/nicht konfiguriertem EtherType.
    2. ETHIF_SEV_DROP_VLAN_DOUBLE_TAG: Event-Referenz bei Detektion und Verwerfung von unerlaubtem VLAN Double-Tagging (Schutz vor VLAN-Hopping / 802.1Q-Anomalien).
    3. ETHIF_SEV_DROP_INV_VLAN: Event-Referenz bei ungültiger oder nicht zugeordneter VLAN-ID / Priority-Tagging.
    4. ETHIF_SEV_DROP_ETH_MAC_COLLISION: Event-Referenz bei Verwerfung infolge von MAC-Adresskollisionen bzw. erkanntem MAC-Spoofing.
• IdsMEvent (EcucParamConfContainerDef, aus Modul IdsM):
  • Zielcontainer (+destination) aller vier Referenzen.
  • Multiplizität im IdsM: [1..65535]; stellt die globale Security-Event-Instanz dar, an die das jeweilige Ereignis übergeben wird.

3. Dynamisches Verhalten & Sequenzablauf

• Trigger & Filterung im RX-Pfad:
  • Eingehende Ethernet-Frames werden in EthIf_RxIndication validiert.
  • Wird ein Frame aus einem der vier definierten Sicherheitsgründe verworfen (unbekannter EtherType, Double-Tagging, ungültiges VLAN, MAC-Kollision) und ist EthIfEnableSecurityEventReporting == TRUE, ermittelt EthIf die konfigurierte symbolische Event-ID.
• API-Aufruf / Meldeweg:
  • EthIf setzt synchron den Call an den IdsM ab: IdsM_SetSecurityEvent(IdsMEventId, ...) (bzw. modulspezifische Context-Data / PDU-Informationen gemäß SWS IdsM).
  • Der Aufruf erfolgt blockierungsfrei im Kontext des RX-Interrupts bzw. des RX-Main-Functions.
• Bypass / Deaktivierung:
  • Ist EthIfEnableSecurityEventReporting == FALSE oder die spezifische Referenz [0] unkonfiguriert, wird der Frame still verworfen bzw. nur über Standard-Fehlerpfade (z. B. DET) ohne IdsM-Interaktion behandelt.

4. Normative Relevanz & Entwickler-Hinweise

• Pre-Compile vs. Link-Time: EthIfEnableSecurityEventReporting dient als Pre-Compile-Schalter (#if (ETHIF_ENABLE_SECURITY_EVENT_REPORTING == STD_ON)). Bei Deaktivierung entfällt der gesamte Code-Overhead für Security-Event-Reporting und die Abhängigkeit zum IdsM-Header vollständig.
• Symbolic Name Resolution: Da requiresSymbolicNameValue = true vorgegeben ist, generiert der ECUC-Generator symbolische Literale (Konstanten/Enums) der Ziel-IdsMEvent-Instanzen. Fehlende Ziel-Referenzen bei aktiviertem Container führen zu Fehlern in der Validierungsphase des BSW-Konfigurators.
• Selektive Granularität: Durch die Einzelmultiplizität [0..1] der Referenzen kann jedes der vier Security-Events unabhängig aktiviert oder unterdrückt werden, um Event-Flooding am IdsM bei bekannten Netzwerkanomalien gezielt zu vermeiden.
• Hardware-Offloading: Erkennt bereits der Ethernet-Controller / Switch (z. B. VLAN-Filterung) ungültige Frames und verwirft diese in Hardware, ohne dass EthIf involviert wird, greifen die EthIf-Security-Events nicht; solche Ereignisse müssen in diesem Fall auf Ebene Eth / EthSwt konfiguriert werden.