Skip to content

Devices

The Devices page is the endpoint repository: every MAC address Airgate has seen or that you added. Here you approve or block devices, set their owner and attributes, import and export them, and open one device for its full history. Access policies match on what this page holds, for example Device is Known.

Endpoints appear automatically when devices authenticate or are profiled. You can also add them by hand or import them from CSV.

Devices › Devices lists the endpoints of the tenant, most recently seen first, 50 per page by default. Each endpoint has one of three statuses:

Status Meaning
Known Allowed by [Endpoints Repository] MAC authentication.
Unknown Not yet approved: MAC authentication fails unless the access policy allows unknown devices.
Disabled Blocked: MAC authentication is rejected.

Select a row to open a quick-view panel with the status, posture and MAC caching badges, the Device and Identity & network details, up to 20 custom attributes, and Sign-in log and Sessions links. Open details opens the device detail page. Select the MAC address, or the arrow at the end of the row, to go straight there.

Your choice of columns, filters, sort and page are kept in the URL, so you can bookmark or share a filtered view.

MAC address is always shown. Use Columns to choose the others; the default set is marked default.

Column Meaning
MAC address The MAC address, a mark for randomized (private) addresses, and the MAC vendor.
Status (default) Known, Unknown or Disabled.
Device (default) The profiled category, family and device name.
Hostname / IP (default) The hostname and last IP address.
Owner (default) The registered user or group, and the description.
MAC caching (default) The guest MAC-auth expiry: active, expired or not cached.
Last auth (default) When the device last authenticated, and on which SSID.
Confidence How sure the profiler is of the device type.
MAC vendor The vendor from the IEEE OUI registry.
MAC type Randomized or Hardware.
First seen When the device was first seen.
Last seen (default) When the device was last seen.
Updated When the endpoint record last changed.
Attributes Number of custom attributes.

Select Filters to open the filter panel. Active filters show as chips above the table; Clear all removes them.

Filter Meaning
Status All, Known, Unknown or Disabled, each with a count. Always shown next to the search box.
Category Exact category, for example Printer; separate several with commas.
OS family Exact family; separate several with commas.
Posture A posture token: HEALTHY, CHECKUP, TRANSITION, QUARANTINE, INFECTED or UNKNOWN.
Profiled Profiled or Unprofiled.
MAC type Randomized (private) or Hardware (burned-in).
Guest MAC caching Active (cached), Expired or Not cached.
Last seen Seen in last hour, 24 hours, 7 days, 30 days, or Not seen for 7+, 30+ or 90+ days.
Owner Exact owner, ignoring case, for example alice@contoso.com.
Custom attribute An attribute name and a value. An empty value or * matches any endpoint that has the attribute.
Field Meaning
MAC address Required, in any notation. Stored as aa:bb:cc:dd:ee:ff. If the MAC already exists, Airgate offers to open it.
Status Known, Unknown or Disabled.
Disabled reason Shown for Disabled. Recorded as the Disabled Reason attribute.
Owner The registered user or group, for example alice@contoso.com.
MAC caching expires Optional guest MAC-auth expiry.
Description For example lobby printer.
Category, OS family, Device name Optional profile, for example Printer, HP, LaserJet M507. Setting a profile locks it: the profiler does not reclassify the endpoint until you release the lock.

Import endpoints from CSV takes a file of up to 64 MiB or 200,000 rows, separated by ,, ; or TAB. The only required column is the MAC (mac, MAC Address, Calling-Station-Id and similar names are recognised). Other known columns are status, owner, description, category, family, device_name and mac_auth_expires_at; any other column becomes a custom attribute. Empty cells never clear a value.

Option Meaning
When the MAC already exists Merge (update with non-empty cells; attributes merged), Replace attributes (as merge, but each row’s attributes replace the existing set) or Skip existing (only create new endpoints).
Status of new endpoints without a status column Known, Unknown or Disabled.
Action What it does
Search Searches the list. Press / to jump to the box. When the search is a full MAC address that exists, Enter opens it. If it does not exist, the empty list offers Add for that MAC.
Filters Opens the filter panel.
Columns Chooses the visible columns. Reset to default restores the default set.
Refresh Reloads the list.
Export Downloads the endpoints that match the current search and filters as endpoints-<timestamp>.csv.
Import Opens the import dialog. Validate (dry run) reports what would be created, updated, skipped or fail; Import writes the rows. Template downloads a sample file.
Bulk edit Opens Bulk update by MAC list: paste up to 10,000 MAC addresses in any notation, then Set status (with an optional reason), Set attributes, Clear MAC caching or Delete. Delete asks you to type the number of endpoints to confirm.
Add device Opens the Add endpoint form.
Change status In the quick-view panel. Choose Known, Unknown or Disabled and an optional Reason. A reason is recorded as Disabled Reason or Enabled Reason, with your e-mail, when the endpoint is disabled or re-enabled.
Copy MAC Copies the MAC address.
Bulk Set status Select rows, then pick a status. Endpoints already in that status are skipped.
Bulk Set attributes Merges attributes into each selected endpoint. An empty value deletes the attribute. Endpoints that would exceed 256 attributes are left unchanged and reported.
Bulk Clear MAC caching Removes the guest MAC-auth expiry. Known endpoints keep passing MAC authentication; guests who relied on caching must log in through the portal again.
Bulk Delete Asks you to type the number of endpoints to confirm. A deleted device that connects again is re-created as Unknown.
Select all … matching the filter After selecting the whole page, extends the selection to every matching endpoint, up to 10,000.
Rows per page 25, 50, 100 or 200.

Route: /devices/<MAC address or endpoint ID>. The page opens from the list, from search, or from links in other pages. A breadcrumb leads back to the list.

The header shows the MAC address, the status and a summary (hostname, device, owner, IP). Under it, four tiles show Status, Device, MAC caching and Last seen. A banner explains a Disabled or Unknown status, with Enable or Mark Known.

If the MAC does not exist, the page says Endpoint not found and offers Back to endpoints, Sign-in log and Add for that MAC.

Tab What it shows
Overview Endpoint card: MAC address, MAC type, MAC vendor, owner, description, added, last seen, updated and endpoint ID. Device profile card: category, OS family, device name, confidence, source, profiled at, hostname, IP address, DHCP fingerprint, DHCP vendor and user agent. Last network context: last authentication, network device, SSID, IP address, roles and recent authentications. Guest & MAC caching: MAC caching state and expiry, the guest account, the registered guest device, Username and Guest Role ID.
Attributes The custom attributes (Endpoint:<name> in policy, and through the [Endpoints Repository] authorization source). Attributes that Airgate maintains are marked sys.
Sessions & access Accounting sessions (state, started, duration, network device, SSID or port, IP, user, roles, traffic) and Access records (time, result, service, username, auth method, network device, roles or profiles), the last 25 of each. Open in the sign-in log opens the full log for this MAC. Shown with monitor:read.
Fingerprints Classification on the stored evidence (the current profile and verdict), Rule evidence (status, rule, fact, verdict, confidence, priority), Collected fingerprints (fact, value, source, times seen, last seen) and Profile history (when, event, change, confidence, reason). A banner warns of a profile conflict: a headless device that now looks like a computer, which can indicate MAC spoofing.
Policy context The attributes this endpoint contributes to a RADIUS request, grouped by namespace (Endpoint, Tips, Authorization:[Endpoints Repository] and others), computed the same way as a live authentication. Filter them, switch to JSON, or Copy JSON.
Action What it does
Change status As in the list. If the device has an active session, Airgate reminds you that the change applies at the next authentication and offers Send CoA.
Actions › Edit owner & description Changes Owner and Description. Clear a field to remove it.
Actions › Edit device profile Sets Category, OS family and Device name, with Lock profile (manual) so the profiler leaves them alone.
Actions › Set MAC caching Sets the guest MAC-auth expiry with Expires at (local time) or a preset (+8 hours, +1 day, +7 days, +30 days, +1 year). Save expiry saves it.
Actions › Edit attributes Opens the Attributes tab. Edit attributes there edits the list; changes are merged with attributes written meanwhile by RADIUS, guest or the profiler. An empty value deletes the attribute. Up to 256 attributes; %{…} references are not allowed. Save or Discard.
Actions › Delete endpoint After confirmation, removes the endpoint with its status, profile, custom attributes and MAC caching. If the device connects again it is re-created as Unknown.
CoA Reauthenticate, Disconnect or Bounce port for the device’s active session, with an optional Reason shown in the CoA log and the sign-in log. See Change of Authorization.
Release lock On a manual profile. The profiler may reclassify the device on the next DHCP, HTTP or RADIUS observation; confidence drops to 0.
Re-profile Re-runs classification on the stored evidence. On the Fingerprints tab, Force also bypasses the stability holds and clears the profile when the evidence is insufficient.
Evidence Opens the Fingerprints tab.
Set expiry / Change / Clear On the Guest & MAC caching card. Clear removes the expiry after confirmation; a guest who relied on it must log in through the portal again.
Copy MAC, Refresh Copy the MAC address; reload the device, its records and sessions.
  • View: identity:read: Tenant Administrator, Network Administrator, Help Desk, Read-only Administrator and Platform Administrator.
  • Change: identity:write: Tenant Administrator, Network Administrator, Help Desk and Platform Administrator. Without it, bulk actions are replaced by Read-only: bulk changes need identity:write.
  • Sessions & access tab and the sign-in log links: monitor:read.
  • CoA menu: monitor:coa: Tenant Administrator, Network Administrator, Help Desk and Platform Administrator.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security