Group devices with MAC lists
A MAC list (static host list) is a named group of addresses: exact MACs, vendor prefixes (OUIs) or regular expressions. An access policy rule with the condition Device is in MAC list then matches every device in the list. Use MAC lists when you know the devices of a group, for example the printers of a site, or every device of one camera vendor.
Before you begin
Section titled “Before you begin”- An administrator role with
identity:writefor the lists andpolicy:writefor the rules. - MAC authentication on the network and an access policy for MAC authentication, see Devices by MAC address.
Step 1: Create the list
Section titled “Step 1: Create the list”-
Open Devices › MAC lists and select Add host list.
-
Fill in:
Field Value Name Printers(required)Description optional Host type MAC address (or IP address) Host format List: exact addresses; partial MACs match as prefixes. Subnet / prefix: MAC prefixes or OUIs such as aa:bb:ccoraa:bb:cc:00:00:00/24(for IP lists: CIDRs such as10.0.0.0/8and ranges such as10.0.0.1-50). Regular expression: RE2 expressions, unanchored. -
Add entries:
- Add entry for one value and an optional description.
- Bulk add to paste many: one per line,
valueorvalue,description(comma, semicolon or tab). A header row is skipped. - Import CSV to load a file in the same format.
-
Select Save.
Values are normalised on save: MACs become aa:bb:cc:dd:ee:ff, subnets are
masked, ranges expanded, duplicates dropped. A list holds up to 10,000
entries.
Example bulk input:
aa:bb:cc:00:11:22,Lobby printeraa:bb:cc:00:11:23,Finance printer00-11-22-33-44-55Step 2: Use the list in a rule
Section titled “Step 2: Use the list in a rule”- Open Access › Access policies and the MAC authentication policy.
- Add a rule (or edit one), Add condition, choose Device is in
MAC list and pick
Printers. - Set Then: Allow, VLAN
40(and an ACL if you need one). - Select Done, then Save changes.
The condition is Connection:Client-Mac-Address BELONGS_TO_GROUP Printers.
Renaming a list rewrites the rules that use it.
Manage lists
Section titled “Manage lists”On Devices › MAC lists, each list has Export CSV, Clone, Edit and Delete. Opening a list shows a summary and Referenced by: the rules that use it. A list that a rule still uses cannot be deleted; the console names the rules (Host list is in use). Remove it from the rules first.
Verify
Section titled “Verify”- Access › Test access, A device (MAC address), with a MAC from the list: the result shows the rule that uses the list.
- Monitor › Sign-in log: the device’s MAB request with the rule name.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause | Fix |
|---|---|---|
| Sign-in log: Denied: no rule of the policy allowed this device, although the MAC is in the list | The list is a Subnet / prefix list with a wrong prefix length, or the entry has a typo. | Open the list and check the entry; test the MAC in Test access. |
| A device matches the wrong rule | A rule above (for example Device is Known) matched first. | Move the MAC list rule up. |
| Vendor prefix lists do not match phones or laptops | Phones and laptops use random (private) MAC addresses, which carry no vendor prefix. | Use MAC lists for headless devices; identify users’ devices by certificate. |
| Deleting fails with Host list is in use | A rule uses the list. | Remove the condition from the rule and save, then delete. |