Port SERVICEACCESS - MACSEC¶

Port für das Öffnen von MACsec-geschützten Verbindungen, die von anderen Ports verwendet werden können

Dieser Port erfordert, dass ein PCAP-Treiber installiert ist.

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Physical Layer ❲Netzwerkzugriff❳
Netzwerkadapter			[ONLINE]	string	Netzwerkadapter, der zum Empfang von Netzwerkpaketen verwendet werden soll
MAC-Adresse ❲Client❳		‚02:00:4C:4F:4F:50‘		string	String (Format: 02:00:4C:4F:4F:50), ‚default‘ wenn die Adapter-MAC-Adresse verwendet werden soll
VLAN-Einstellungen ❲IEEE 802.1Q❳
VLAN-Modus		disable	[disable, single tagging]	string	Mit ‚auto‘ wird die Einstellung aus der Datenbank übernommen. ‚disable‘ für deaktiviertes VLAN. Oder ‚single tagging‘, wenn eine feste VLAN-ID angegeben werden soll
VLAN-ID	VLAN-Modus: ‚single tagging‘	0		int	Wenn eingehende Pakete ein VLAN-Tag besitzen, werden sie gefiltert und nur Pakete mit dieser VLAN-ID werden akzeptiert. Eingehende Pakete ohne VLAN-Tag werden ebenfalls akzeptiert.
Einstellungen für MACsec Key Agreement ❲MKA❳
Connectivity Association Key ❲CAK❳				string	Schlüssel für das MACsec Key Agreement als Hex-String (128 oder 256 bit).
Connectivity Association Key Name ❲CKN❳				string	Text, der den CAK identifiziert als Hex-String (8 bis 256 bit).
Algorithmen für MACsec-Protokoll		‚[GCM-AES-XPN-256, GCM-AES-256, GCM-AES-XPN-128, GCM-AES-128]‘		string	Liste der unterstützten MACsec Algorithmen. Die Syntax und eine Liste aller unterstützten Algorithmen sind in der Hilfe beschrieben (Tool tracetronic: Ethernet).
Zykluszeit MKA [ms]		500		int	Zeitlicher Abstand zwischen zwei gesendeten MKPDUs in Millisekunden (Defaultwert=500 ms, wie in IEEE 802.1X-2020 Abschnitt 9.10 NOTE 2 spezifiziert)
MKA nicht stoppen		☐		bool	MKA bleibt über die Testfallausführung hinaus aktiv.

Jobs 🛈¶

GetMacSecValues¶

Ermittelt die aktuellen Werte für SCI, AN, SAK und CipherSuite, die sich z.B. ändern können, wenn die Gegenstelle die Vergabe eines neuen SAK veranlasst. Liegen noch keine Werte vor, wird ein leeres Dictionary zurückgegeben.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Dictionary mit ermittelten Werten zu SCI, AN, SAK und CipherSuite. Für XPN-Algorithmen sind auch XPN Salt und XPN SCI List enthalten.

RekeyMacSec¶

Veranlasst die Vergabe eines neuen SAK. Als Key-Server wird ein neuer SAK generiert und verteilt. Anderenfalls wird durch Wahl eines neuen Member Identifiers erzwungen, dass der Key-Server einen neuen SAK generiert und verteilt. Falls bis zum angegebenen Timeout kein SAK verteilt bzw. empfangen werden konnte, ist der Rückgabewert ein leeres Dictionary. Das MKA-Protokoll bleibt im Hintergrund aktiv. Mit dem Job „GetMacSecValues“ kann auf spätere Änderungen der Verbindungsparameter im Testfall reagiert werden, wie z.B. der Empfang eines neuen SAK.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Timeout		5.0		float	Timeout in Sekunden

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Dictionary mit ermittelten Werten zu SCI, AN, SAK und CipherSuite. Für XPN-Algorithmen sind auch XPN Salt und XPN SCI List enthalten.

ShutdownMacSec¶

Schließt die MACsec-Sitzung

StartMacSecManipulation¶

Startet asynchron den Modus für die benutzerdefinierte Manipulation des MACsec Headers (s. Header-Manipulation). Gültige Werte für die MACsec-Header-Bits sind None = keine Manipulation, 0 = Bit nicht gesetzt und 1 = Bit gesetzt. Parameter mit Suffix „Flags“ sind keine MACsec-Header-Bits. Sie dienen zur Festlegung der Art der Manipulation. Die gültigen Werte dafür stehen in der Parameter spezifischen Beschreibung.

Parameter

Name	Gültige Werte	Typ	Beschreibung
AN		int	SecTag: Association Number
C	[False, True]	bool	SecTag-TCI: Changed Text Bit: ist in Kombination mit E zu benutzen. Siehe IEEE Std 802.1AE 2018
E	[False, True]	bool	SecTag-TCI: Encryption Bit: 0 - keine, 1 - Payload verschlüsselt
ES	[False, True]	bool	SecTag-TCI: End Station Bit
ICVFlags		int	SecTag: ICV Flags: None = keine Manipulation, 1 = setze ungültiges ICV
PNFlags		int	SecTag: Packet Number Flags: None = PNStart ist absolut, 1 = PNStart is relativ zu aktueller PN
PNStart		int	SecTag: Packet Number Start wird einmalig nach StartMacSecManipulation angewendet. Siehe PNFlags.
PNStep		int	SecTag: Packet Number Step wird nach dem initialen Paket auf jedes weitere Paket angewendet.
SC	[False, True]	bool	SecTag-TCI: Secure Channel Identifier in SecTAG enthalten
SCB	[False, True]	bool	SecTag-TCI: Single Copy Broadcast Capability Bit
SCI		ByteStream	SecTag: Secure Channel Identifier
SL		int	SecTag: Short Length
V	[False, True]	bool	SecTag-TCI: Version Bit
VlanId		int	ID mit welcher VLAN-Pakete getagged werden sollen. None = VLAN-ID wird nicht angewendet.

StartMkaManipulation¶

Startet die Manipulation ausgehender MKPDUs (s. MKA-Manipulation).

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Manipulator				object	Ein ByteStream oder ein benutzerdefiniertes Manipulationsobjekt, welches dynamisch auf zu sendende MKA-Pakete angewendet wird (s. MKA-Manipulation).

StartupMacSec¶

Baut eine durch MACsec gesicherte Verbindung mit der Gegenstelle auf. Ist dies innerhalb des angegebenen Timeouts nicht erfolgreich, wird ein leeres Dictionary zurückgegeben. Das MKA-Protokoll bleibt im Hintergrund aktiv. Mit dem Job „GetMacSecValues“ kann auf spätere Änderungen der Verbindungsparameter im Testfall reagiert werden, wie z.B. der Empfang eines neuen SAK.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Cak			object	Schlüssel für das MACsec Key Agreement als Hex-String (128 oder 256 bit). Mit None wird die TBC-Option verwendet.
Ckn			object	Text, der den CAK identifiziert als Hex-String (8 bis 256 bit). Mit None wird die TBC-Option verwendet.
KeyServerFlag	True	[False, True]	bool	True: Key-Server-Fähigkeit aktivieren, False: ein anderer MKA-Teilnehmer soll Key-Server sein
KeyServerPrio	1		int	Priorität von 0 (hoch) bis 255 (niedrig) mit der die Key-Server-Rolle wahrgenommen werden soll, falls KeyServerFlag=True
MkaAlgorithms			object	Liste der unterstützten MACsec Algorithmen. Die Syntax und eine Liste aller unterstützten Algorithmen sind in der Hilfe beschrieben (Tool tracetronic: Ethernet). Mit None wird die TBC-Option verwendet.
MkaCycleTime	500		int	Zeitlicher Abstand zwischen zwei gesendeten MKPDUs in Millisekunden (Defaultwert=500 ms, wie in IEEE 802.1X-2020 Abschnitt 9.10 NOTE 2 spezifiziert)
Timeout	5.0		float	Zeit (in Sekunden) die gewartet werden soll, bis MACsec aktiviert ist

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Dictionary mit ermittelten Werten zu SCI, AN, SAK und CipherSuite. Für XPN-Algorithmen sind auch XPN Salt und XPN SCI List enthalten.

StopMacSecManipulation¶

Stoppt asynchron den Modus für die benutzerdefinierte Manipulation des MACsec Headers (s. Header-Manipulation).

StopMkaManipulation¶

Stoppt die Manipulation ausgehender MKPDUs (s. MKA-Manipulation).