deviceTRUST 19.3.200 is now available. See the release notes for more information.

macOS Client 19.2.100

Welcome to our first release of the deviceTRUST macOS Client. This release includes support for the Citrix ICA protocol. See Installing the macOS Client for details on how to install the client.

The following properties of the macOS device are available within the virtual sessions:

  1. deviceTRUST Properties
  2. Display Properties
  3. Domain Properties
  4. Hardware Properties
  5. Input Properties
  6. Location Properties
  7. Logical Disk Properties
  8. macOS Properties
  9. macOS Firewall Properties
  10. Name Properties
  11. Network Properties
  12. OS Properties
  13. Power Properties
  14. Region Properties
  15. Screensaver Properties
  16. Security Product Properties
  17. User Properties
  18. Whois Properties

deviceTRUST Properties

The DEVICETRUST category of properties determines information about the deviceTRUST Client installed on the device.

  • DEVICE_DEVICETRUST_VERSION - The version of the deviceTRUST Client installed on the device.

Display Properties

The DISPLAY category of properties determines the displays that are available to the use of the remote device.

  • DEVICE_DISPLAY_COUNT - The number of displays detected.
  • DEVICE_DISPLAY_X_WIDTH - The width in pixels of the display.
  • DEVICE_DISPLAY_X_HEIGHT - The height in pixels of the display.
  • DEVICE_DISPLAY_X_BPP - The number of bits per pixel available to the display.
  • DEVICE_DISPLAY_X_DPI - The number of pixels per inch of the display.
  • DEVICE_DISPLAY_X_MONITOR_VENDOR - The vendor name that manufactured the monitor.
  • DEVICE_DISPLAY_X_MONITOR_PRODUCT - The product name of the monitor.
  • DEVICE_DISPLAY_X_MONITOR_SERIALNUMBER - The serial number of the monitor.
  • DEVICE_DISPLAY_X_MONITOR_EXTERNAL - Set to true when the monitor is external, otherwise false.
  • DEVICE_DISPLAY_X_ADAPTER_VENDOR - The vendor name that manufactured the display adapter.
  • DEVICE_DISPLAY_X_ADAPTER_PRODUCT - The product name of the display adapter.

Domain Properties

The DOMAIN category of properties determines the domain that the device belongs to.

  • DEVICE_DOMAIN - The name of the domain.
  • DEVICE_DOMAIN_DNS - The DNS name of the domain.
  • DEVICE_DOMAIN_JOINED - Set to true whenever the device is domain joined.

Hardware Properties

The HARDWARE category of properties determines information about the hardware on the remote device.

  • DEVICE_HARDWARE_VENDOR - The vendor of the device.
  • DEVICE_HARDWARE_MODEL - The model of the device.
  • DEVICE_HARDWARE_CPU - The CPU available on the device.
  • DEVICE_HARDWARE_CPU_COUNT - The number of logical CPU’s on the device.
  • DEVICE_HARDWARE_CPU_SPEED - The speed of the CPU available on the device.
  • DEVICE_HARDWARE_SYSTEMMEMORY - The total size of memory in MB.
  • DEVICE_HARDWARE_BIOS_SERIAL - The serial number of the BIOS of the device.
  • DEVICE_HARDWARE_BIOS_VERSION - The version number of the BIOS.
  • DEVICE_HARDWARE_VIRTUALIZATION - The type of virtualization used to host the device.
  • DEVICE_HARDWARE_ROLE - The role of the device, such as Laptop, Tablet or Desktop.
  • DEVICE_HARDWARE_LID - Set to Open or Closed, depending upon the state of the lid.

Input Properties

The INPUT category of properties determines the input devices available on the remote device.

  • DEVICE_INPUT_KEYBOARD - Set to true when the remote device has a keyboard available.
  • DEVICE_INPUT_MOUSE - Set to true when the remote device has a mouse.
  • DEVICE_INPUT_PEN - Set to true when the remote device has a pen.
  • DEVICE_INPUT_TOUCH - Set to true when the remote device has a touchscreen.

Location Properties

The LOCATION category of properties determines the physical location of the remote device. This requires access to a WiFi adapter and is subject to third party terms and conditions.

  • DEVICE_LOCATION_LATITUDE - The geographical latitude of the device.
  • DEVICE_LOCATION_LONGITUDE - The geographical longitude of the device.
  • DEVICE_LOCATION_ACCURACY - The accuracy of the latitude and longitude values.
  • DEVICE_LOCATION_URL - A URL displaying the location of the device.
  • DEVICE_LOCATION_COUNTRY_CODE - The country code where the device is located.
  • DEVICE_LOCATION_COUNTRY - The country where the device is located.
  • DEVICE_LOCATION_POSTCODE - The postcode where the device is located.
  • DEVICE_LOCATION_STATE - The state where the device is located.
  • DEVICE_LOCATION_STATE_DISTRICT - The district where the device is located.
  • DEVICE_LOCATION_COUNTY - The country where the device is located.
  • DEVICE_LOCATION_TOWN - The town where the device is located.
  • DEVICE_LOCATION_STREET - The name of the street where the device is located.
  • DEVICE_LOCATION_BUILDING - The name of the building where the device is located.
  • DEVICE_LOCATION_NUMBER - The house number where the device is located.

Logical Disk Properties

The LOGICALDISK category of properties provide real-time properties identifying the logical disks connected to the remote device. This includes support for the following properties:

  • DEVICE_LOGICALDISK_COUNT - The number of available logical disks.
  • DEVICE_LOGICALDISK_X_TYPE - The type of the logical disk, such as Fixed or Removable.
  • DEVICE_LOGICALDISK_X_LABEL - The volume label.
  • DEVICE_LOGICALDISK_X_FILESYSTEM - The underlying filesystem.
  • DEVICE_LOGICALDISK_X_PATH - The path where the disk is mounted.
  • DEVICE_LOGICALDISK_X_TOTALMB - The total size in MB of the logical disk. This is only available on mounted volumes.
  • DEVICE_LOGICALDISK_X_FREEMB - The free / available size in MB. This is only available on mounted volumes.
  • DEVICE_LOGICALDISK_X_NAME - The vendor and model of the logical disk.
  • DEVICE_LOGICALDISK_X_VENDOR_ID - The vendor id of the logical disk for USB or PCI connected disks.
  • DEVICE_LOGICALDISK_X_PRODUCT_ID - For USB connected disks, this is the USB product id. For PCI connected disks, this is the device id.
  • DEVICE_LOGICALDISK_X_SERIALNUMBER - The serial number of the physical disk.
  • DEVICE_LOGICALDISK_X_BUSTYPE - Set to the name of the bus that the device is connected, e.g. SATA, SCSI, USB, NVme, etc.

macOS Properties

The MACOS category of properties provides properties specific to the macOS operating system.

  • DEVICE_MACOS_ICLOUD_ACCOUNT - The iCloud account associated with the logged in user.
  • DEVICE_MACOS_SYSTEMINTEGRITYPROTECTION - Determines whether System Integrity Protection is enabled, which helps protect Mac users from malicious software.
  • DEVICE_MACOS_SECUREVIRTUALMEMORY - Determines whether the swap file is encrypted.
  • DEVICE_MACOS_GATEKEEPER - Determines the Gatekeeper setting which defines the trust level of software that can run on the Mac.

macOS Firewall Properties

The MACOSFIREWALL category of properties provides real-time properties describing the state of the macOS Application Firewall.

  • DEVICE_MACOSFIREWALL_ENABLED - Determines whether the firewall is enabled.
  • DEVICE_MACOSFIREWALL_VERSION - The version number of the firewall.
  • DEVICE_MACOSFIREWALL_STEALTHMODE - Determines whether the firewall is configured to ignore ICMP packets.
  • DEVICE_MACOSFIREWALL_BLOCKALLINBOUND - Determines whether the firewall is configured to block all inbound connection.
  • DEVICE_MACOSFIREWALL_ALLOWSIGNEDINBOUND - Determines whether the firewall is configured to allow built in software to receive inbound connections.
  • DEVICE_MACOSFIREWALL_ALLOWSIGNEDDOWNLOADINBOUND - Determines whether the firewall is configured to allow signed downloaded software to receive inbound connections.
  • DEVICE_MACOSFIREWALL_INBOUNDRULES_PROGRAMS - The firewall rules configured to allow programs to receive inbound connections.
  • DEVICE_MACOSFIREWALL_INBOUNDRULES_SERVICES - The firewall rules configured to allow services to receive inbound connections.
  • DEVICE_MACOSFIREWALL_INBOUNDRULES_EXCEPTIONS - The exceptions to the firewall rules.

Name Properties

The NAME category of properties determines the name of the device.

  • DEVICE_NAME - The name of the device.
  • DEVICE_NAME_DN - The Distinguished Name of the device within Active Directory.
  • DEVICE_NAME_DNS - The DNS name of the device.
  • DEVICE_NAME_SID - The SID of the device within Active Directory.
  • DEVICE_ID - A unique identifier of the device.

Network Properties

The NETWORK category of properties determines the connected network adapters of the remote device.

  • DEVICE_NETWORK_COUNT - The number of network adapters.
  • DEVICE_NETWORK_X_STATUS - The status of the network adapter.
  • DEVICE_NETWORK_X_NAME - The name of the network adapter.
  • DEVICE_NETWORK_X_DESCRIPTION - The description of the network adapter.
  • DEVICE_NETWORK_X_TYPE - The type of network adapter, such as Ethernet or WiFi.
  • DEVICE_NETWORK_X_MAC - The physical MAC address of the network adapter.
  • DEVICE_NETWORK_X_IP - The IP address of the network adapter.
  • DEVICE_NETWORK_X_IPV4_ENABLED - Set to true when IPv4 is enabled.
  • DEVICE_NETWORK_X_IPV6_ENABLED - Set to true when IPv6 is enabled.
  • DEVICE_NETWORK_X_DNS - The IP address of the DNS server.
  • DEVICE_NETWORK_X_DNS_SUFFIX - The DNS suffixes.
  • DEVICE_NETWORK_X_GATEWAY - The IP address of the gateway.
  • DEVICE_NETWORK_X_GATEWAY_MAC - The MAC address of the gateway.
  • DEVICE_NETWORK_X_DHCP_ENABLED - Set to true when the network adapter is configured to use DHCP.
  • DEVICE_NETWORK_X_DHCP_SERVER - The IP address of the DHCP server.
  • DEVICE_NETWORK_X_WIFI_SSID - For WiFi network adapters, the SSID of any connected networks.
  • DEVICE_NETWORK_X_WIFI_BSSID - For WiFi network adapters, the BSSID of the connected access point.
  • DEVICE_NETWORK_X_WIFI_STRENGTH - The signal strength of the WiFi network adapter.
  • DEVICE_NETWORK_X_WIFI_SECURITY - The security used to authenticate and encrypt the data over the WiFi network adapter.

OS Properties

The OS category of properties determines information about the OS on the remote device.

  • DEVICE_OS_NAME - The name of the OS. This is set to macOS.
  • DEVICE_OS_VERSION - The version number of the OS.
  • DEVICE_OS_PLATFORM - The platform of the OS, such as x64.
  • DEVICE_OS_ID - An arbitrary identifier that uniquely identifies the OS.

Power Properties

The POWER category of properties determines information about the power source used by the remote device.

  • DEVICE_POWER_AC - Set to Online whenever the remote device is plugged in, otherwise Offline.
  • DEVICE_POWER_BATTERY - Set to High, Medium, Low or Critical depending upon the available battery.

Region Properties

  • DEVICE_REGION_TIMEZONE_OFFSET - The offset in minutes relative to UTC.
  • DEVICE_REGION_LANGUAGE - The language configured by the OS.
  • DEVICE_REGION_LOCALE - The locale configured by the OS.
  • DEVICE_REGION_KEYBOARD_LANGUAGE - The language configured by the keyboard.
  • DEVICE_REGION_KEYBOARD_LOCALE - The locale configured by the keyboard.

Screensaver Properties

The SCREENSAVER category of properties defines the screensaver configured on the remote device.

  • DEVICE_SCREENSAVER_ENABLED - Determines if the screensaver is enabled.
  • DEVICE_SCREENSAVER_TIMEOUT - Determines the amount of user idle time in seconds before the screensaver is shown.
  • DEVICE_SCREENSAVER_FILENAME - The filename of the screensaver that is shown to the user.

Security Product Properties

The SECURITYPRODUCT category of properties determines the security products available on the remote device. For macOS, the deviceTRUST Client currently detects the macOS Application Firewall.

  • DEVICE_SECURITYPRODUCT_FIREWALL - Set to Active when the macOS Application Firewall is active, otherwise Inactive.
  • DEVICE_SECURITYPRODUCT_FIREWALL_NAME - Set to macOS Application Firewall when available.

User Properties

The USER category of properties determines information about the user logged into the remote device.

  • DEVICE_USER_NAME - The name of the user.
  • DEVICE_USER_NAME_DOMAIN - The domain of the user.
  • DEVICE_USER_NAME_DOMAIN_DNS - The domain dns of the user.
  • DEVICE_USER_LOCALADMIN - Set to true whenever the user has admin rights.
  • DEVICE_USER_DOMAINLOGON - Set to true whenever the user belongs to a domain.

Whois Properties

The WHOIS category of properties determines the results of a WHOIS lookup of the remote device.

  • DEVICE_WHOIS_IP - The ip address of the remote device.
  • DEVICE_WHOIS_DNS - The DNS address of the remote device.
  • DEVICE_WHOIS_ISP - The ISP of the remote device.
  • DEVICE_WHOIS_COUNTRY - The country where the remote device is located.