create macsec connectivity-association

create macsec connectivity-association ca_name pre-shared-key ckn ckn cak [encrypted encrypted_cak | cak]

Description

Creates a named connectivity-association (CA) object that holds MAC Security (MACsec) key authentication data.

Syntax Description

connectivity-association Secures connectivity provided between MACsec stations.
ca_name Defines CA object name.
pre-shared-key Selects static MACsec key consisting of both a CKN and CAK:
ckn

Selects CA key name.

This public (non-secret) key name allows each of the MKA participants to select which connectivity association k ey (CAK) to use to process a received MACsec key agreement (MKA) protocol packets (MKPDU).

ckn

Sets the CA key name. Length allowed is 1–32 characters, entered as ASCII or an octet string preceded with 0x.

cak

Sets the connectivity association key (CAK). If you are using 256-bit cipher suite, then the CAK must be 32 octets. The 128-bit cipher suite can use either a 16- or 32-octet CAK.

This is a long-lived secret key used to derive short-lived lower-layer keys (ICK, KEK, and SAK) which are used for key distribution and data encryption.

cak Sets the non-encrypted CAK value. Must be entered as an octet string (for example: “0x859e72f0…”). A 128-bit (16 octet) CAK requires 32 hexadecimal digits, and a 256-bit (32 octet) CAK requires 64 hexadecimal digits. These values are secret and should be generated off switch with a suitable pseudorandom number generator.
encrypted Designates that secret key value is in encrypted format.
encrypted_cak Sets the value for the secret key. The encrypted CAK value is generated by the show configuration macsec command for previously configured CAKs.

Default

N/A.

Usage Guidelines

Up to 64 unique CA profiles can be created.

Example

The following example creates the CA object "testca" with a CKN of "the blue key" and 128-bit CAK of “0x01020304050607080910111213141516”:
# create macsec connectivity-association testca pre-shared-key ckn “the blue key” cak “0x01020304050607080910111213141516”
The following example creates the CA object "testca2" with a CKN of "the red key" and 256-bit CAK of “0x0102030405060708091011121314151617181920212223242526272829303132”:
# create macsec connectivity-association testca2 pre-shared-key ckn “the red key” cak “0x0102030405060708091011121314151617181920212223242526272829303132”
# show macsec connectivity-association
MACsec CAK Bit 
CA Name Ports Length CAK Name (CKN)
 -------------------------------- --------------------
testca None 128 the blue key 
testca2 None 256 the red key 
Note

Note

The CAKs shown here are examples. Use your own random number for maximum security.

History

This command was first available in ExtremeXOS 30.1.

Platform Availability

This command is available on the following platforms.

Note

Note

The MACsec feature requires the installation of the MAC Security feature pack license.
Platform Ports
ExtremeSwitching 5320 All ports of all models except stacking ports.
ExtremeSwitching 5420 All ports of all models except stacking ports.
ExtremeSwitching 5520 All ports, except 5520-VIM-4X and 5520-24X 10G ports
ExtremeSwitching 5720 All ports of all models except stacking ports.