A MACsec Policy configures IEEE 802.1AE Media Access Control Security (MACsec) encryption on Fabric Interconnect uplinks. It protects Layer 2 traffic with encryption and integrity validation using pre-shared key chains. The policy is applied to ethernet uplink port roles and port-channel uplinks in a Port Policy.
Location in Intersight GUI :
Policies » MACsec
Name Type Constraint Mandatory Default Value intersight Class intersight No
Name Type Constraint Mandatory Default Value organizations List organizations No
Name Type Constraint Mandatory Default Value policies Class policies No
Name Type Constraint Mandatory Default Value mac_sec List mac_sec No
Name Type Constraint Mandatory Default Value name String Regex: ^[a-zA-Z0-9_ . :-] {1, 64}$ Yes description String No managed Boolean true, falseNo truetags List tags No cipher_suite Choice GCM-AES-128, GCM-AES-256, GCM-AES-XPN-128, GCM-AES-XPN-256No GCM-AES-256confidentiality_ offset Choice CONF-OFFSET-0, CONF-OFFSET-30, CONF-OFFSET-50No CONF-OFFSET-0include_ icv_ indicator Boolean true, falseNo truekey_ server_ priority Integer min: 0, max: 255 No 16replay_ window_ size Integer min: 0 No 0 sak_expiry_time Integer min: 0 No 0 security_policy Choice Should-secure, Must-secureNo Should-securemac_sec_ea_pol Class mac_sec_ea_pol No primary_ key_ chain Class primary_ key_ chain No fallback_ key_ chain Class fallback_ key_ chain No
Name Type Constraint Mandatory Default Value key String Yes value String No type Choice KeyValue, PathTagNo
Name Type Constraint Mandatory Default Value ea_ pol_ ethertype String No ea_ pol_ mac_ address String Regex: ^[0-9A-Fa-f] {4}\. [0-9A-Fa-f] {4}\. [0-9A-Fa-f] {4}$ No
Name Type Constraint Mandatory Default Value name String Yes keys List keys No
Name Type Constraint Mandatory Default Value name String Yes keys List keys No
Name Type Constraint Mandatory Default Value id String No cryptographic_ algorithm Choice AES_256_CMAC, AES_128_CMACNo key_type Choice Type-0, Type-6, Type-7No octet_string String No send_ lifetime_ unlimited Boolean true, falseNo
MACsec requires a primary_key_chain (and optionally a fallback_key_chain) with pre-shared keys. Key material (octet_string) is sensitive — use !env for secrets. Each key can be set as unlimited lifetime (send_lifetime_unlimited: true) or time-bounded.
Example-1: MACsec Policy using GCM-AES-256 with a primary key chain in unlimited lifetime mode, with environment tags.
description : MACsec encryption for FI uplinks
cipher_suite : GCM-AES-256
security_policy : Should-secure
confidentiality_offset : CONF-OFFSET-0
include_icv_indicator : true
octet_string : !env MACSEC_PRIMARY_KEY
cryptographic_algorithm : AES_256_CMAC
send_lifetime_unlimited : true
Example-2: MACsec Policy with both primary and fallback key chains for high availability, referenced from a Port Policy uplink.
cipher_suite : GCM-AES-128
security_policy : Must-Secure
octet_string : !env MACSEC_PRIMARY_KEY
send_lifetime_unlimited : true
octet_string : !env MACSEC_FALLBACK_KEY
send_lifetime_unlimited : true
port_role_ethernet_uplinks :
ethernet_network_group_policy : prod-vlan-group
mac_sec_policy : macsec-uplinks