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.
What this page shows
Section titled “What this page shows”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.
Fields and columns
Section titled “Fields and columns”List columns
Section titled “List columns”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. |
Filters
Section titled “Filters”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. |
Add endpoint form
Section titled “Add endpoint form”| 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
Section titled “Import”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. |
Actions
Section titled “Actions”| 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. |
Device detail
Section titled “Device detail”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. |
Detail actions
Section titled “Detail actions”| 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. |
Permissions
Section titled “Permissions”- 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.