Devices (rs/nac/mac)

This resource returns the MAC addresses of all devices for the customer, divided into devices with network access status Allowed and Denied.

URL

https://<smc_server_address>/rs/nac/mac

Method

GET

Request header

Key Value
X-SMCRS-Auth-Session Session authentication token from the login response

Request body

empty

Response body

JSON object with the following structure:

Key Type Description
allowed Array of device objects List of devices with network access status Allow
denied Array of device objects List of devices with network access status Deny

Device objects have the following structure:

Key Type Description
deviceId Integer Internal device identifier
mac String MAC address of the device
deniedReason String

Possible values:

null: Network access is allowed.

denied by compliance violation: Network access is denied because of a compliance violation.

denied by admin: Network access is unconditionally denied in device settings.

HTTP response status

Status code Description
200 OK Request was successfully processed
401 Unauthorized Administrator is not authorized or the authentication token has expired
403 Forbidden Administrator does not have sufficient rights

Example request

POST /rs/nac/mac HTTP/1.1
Host: smc.yourcompany.com
X-SMCRS-Auth-Session: da81d6d2-3c02-4f18-8115-f4188d84e851

Example response

{
   "allowed": [
      {
         "deviceId": 12060,
         "mac": "021111111111",
         "deniedReason": null
      },
      {
         "deviceId": 12066,
         "mac": "022222222222",
         "deniedReason": null
      }
   ],
   "denied": [
      {
         "deviceId": 12069,
         "mac": "023333333333",
         "deniedReason": "denied by admin"
      },
      {
         "deviceId": 22079,
         "mac": "024444444444",
         "deniedReason": "denied by compliance violation"
      }
   ]
}