Port SERVICEACCESS - MACSEC 🛈¶
Port für das Öffnen von MACsec-geschützten Verbindungen, die von anderen Ports verwendet werden können
Stimulation¶
Dieser Port besitzt keine Stimulus-Fähigkeiten.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Netzwerkname |
string |
Name des Netzwerkes, wie in SIL-Kit Config yaml definiert. |
|||
Kontrollername |
string |
Name des Kontrollers, wie in SIL-Kit Config yaml definiert. |
|||
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 ID |
0 |
int |
ID mit welcher VLAN-Pakete getagged werden sollen. (0 -> VLAN wird nicht verwendet) |
||
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.
Parametrierung
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.
Parametrierung
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.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
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 eine MKA-Manipulation (s. MKA-Manipulation).
Parametrierung
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.
Parametrierung
Parameter
Name |
Verfügbar wenn |
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 MKA-Manipulation (s. MKA-Manipulation).