Skip to content

MACsec Policy

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

Diagram
NameTypeConstraintMandatoryDefault Value
intersightClassintersightNo

NameTypeConstraintMandatoryDefault Value
organizationsListorganizationsNo

NameTypeConstraintMandatoryDefault Value
policiesClasspoliciesNo

policies (compute.intersight.organizations)

Section titled “policies (compute.intersight.organizations)”
NameTypeConstraintMandatoryDefault Value
mac_secListmac_secNo

mac_sec (compute.intersight.organizations.policies)

Section titled “mac_sec (compute.intersight.organizations.policies)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$Yes
descriptionStringNo
managedBooleantrue, falseNotrue
tagsListtagsNo
cipher_suiteChoiceGCM-AES-128, GCM-AES-256, GCM-AES-XPN-128, GCM-AES-XPN-256NoGCM-AES-256
confidentiality_offsetChoiceCONF-OFFSET-0, CONF-OFFSET-30, CONF-OFFSET-50NoCONF-OFFSET-0
include_icv_indicatorBooleantrue, falseNotrue
key_server_priorityIntegermin: 0, max: 255No16
replay_window_sizeIntegermin: 0No0
sak_expiry_timeIntegermin: 0No0
security_policyChoiceShould-secure, Must-secureNoShould-secure
mac_sec_ea_polClassmac_sec_ea_polNo
primary_key_chainClassprimary_key_chainNo
fallback_key_chainClassfallback_key_chainNo

tags (compute.intersight.organizations.policies.mac_sec)

Section titled “tags (compute.intersight.organizations.policies.mac_sec)”
NameTypeConstraintMandatoryDefault Value
keyStringYes
valueStringNo
typeChoiceKeyValue, PathTagNo

mac_sec_ea_pol (compute.intersight.organizations.policies.mac_sec)

Section titled “mac_sec_ea_pol (compute.intersight.organizations.policies.mac_sec)”
NameTypeConstraintMandatoryDefault Value
ea_pol_ethertypeStringNo
ea_pol_mac_addressStringRegex: ^[0-9A-Fa-f]{4}\.[0-9A-Fa-f]{4}\.[0-9A-Fa-f]{4}$No

primary_key_chain (compute.intersight.organizations.policies.mac_sec)

Section titled “primary_key_chain (compute.intersight.organizations.policies.mac_sec)”
NameTypeConstraintMandatoryDefault Value
nameStringYes
keysListkeysNo

fallback_key_chain (compute.intersight.organizations.policies.mac_sec)

Section titled “fallback_key_chain (compute.intersight.organizations.policies.mac_sec)”
NameTypeConstraintMandatoryDefault Value
nameStringYes
keysListkeysNo

keys (compute.intersight.organizations.policies.mac_sec.primary_key_chain)

Section titled “keys (compute.intersight.organizations.policies.mac_sec.primary_key_chain)”
NameTypeConstraintMandatoryDefault Value
idStringNo
cryptographic_algorithmChoiceAES_256_CMAC, AES_128_CMACNo
key_typeChoiceType-0, Type-6, Type-7No
octet_stringStringNo
send_lifetime_unlimitedBooleantrue, 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.

compute:
intersight:
organizations:
- name: MyOrganization
policies:
mac_sec:
- name: macsec-uplinks
description: MACsec encryption for FI uplinks
cipher_suite: GCM-AES-256
security_policy: Should-secure
confidentiality_offset: CONF-OFFSET-0
include_icv_indicator: true
key_server_priority: 16
primary_key_chain:
name: primary-keychain
keys:
- id: "01"
key_type: Type-6
octet_string: !env MACSEC_PRIMARY_KEY
cryptographic_algorithm: AES_256_CMAC
send_lifetime_unlimited: true
tags:
- key: env
value: prod

Example-2: MACsec Policy with both primary and fallback key chains for high availability, referenced from a Port Policy uplink.

compute:
intersight:
organizations:
- name: MyOrganization
policies:
mac_sec:
- name: macsec-ha
cipher_suite: GCM-AES-128
security_policy: Must-Secure
primary_key_chain:
name: primary-chain
keys:
- id: 1
octet_string: !env MACSEC_PRIMARY_KEY
send_lifetime_unlimited: true
fallback_key_chain:
name: fallback-chain
keys:
- id: "01"
key_type: Type-6
octet_string: !env MACSEC_FALLBACK_KEY
send_lifetime_unlimited: true
port:
- name: fi-ports
port_role_ethernet_uplinks:
- ports:
- from: 49
to: 50
admin_speed: 100Gbps
ethernet_network_group_policy: prod-vlan-group
mac_sec_policy: macsec-uplinks