Difference between revisions of "Hosts"

From UntangleWiki
Jump to: navigation, search
(Current Hosts)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
<span style="display:none" class="helpSource host_viewer">Host_Viewer</span>
+
<span style="display:none" class="helpSource hosts">Hosts</span>
<span style="display:none" class="helpSource host_viewer_current_hosts">Host_Viewer#Current_Hosts</span>
+
<span style="display:none" class="helpSource host_viewer">Hosts</span>
<span style="display:none" class="helpSource host_viewer_penalty_box_hosts">Host_Viewer#Penalty_Box_Hosts</span>
+
<span style="display:none" class="helpSource host_viewer_current_hosts">Hosts</span>
<span style="display:none" class="helpSource host_viewer_penalty_box_event_log">Host_Viewer#Penalty_Box_Event_Log</span>
+
<span style="display:none" class="helpSource host_viewer_penalty_box_hosts">Hosts</span>
<span style="display:none" class="helpSource host_viewer_current_quotas">Host_Viewer#Current_Quotas</span>
+
<span style="display:none" class="helpSource host_viewer_penalty_box_event_log">Hosts</span>
<span style="display:none" class="helpSource host_viewer_quota_event_log">Host_Viewer#Quota_Event_Log</span>
+
<span style="display:none" class="helpSource host_viewer_current_quotas">Hosts</span>
 +
<span style="display:none" class="helpSource host_viewer_quota_event_log">Hosts</span>
  
= Host Viewer =
+
Hosts provides a view of all current "hosts" or unique IP address on the local network(s).
  
The Host Viewer is viewable by selecting "Show Hosts" at the dropdown at the top of the rack. The Host Viewer shows the information stored in the ''host table'' which is a global table that tracks local hosts and the various information about them.
+
Each row represents a single a host (unique IP address) that has been seen on any LAN interface.
  
== Current Hosts ==
+
As Untangle scans and processes network traffic, the platform and many of the apps will save information about a host on the network.
 +
This information is stored in the "Host Table" and the Hosts view provides a view into the host table.
  
The ''Current Hosts'' tab shows all the currently known (local) hosts and all the information about them.
+
= Controls =
  
Many applications store information about the various hosts on the network. For example, If a user logs into Captive Portal, the Captive Portal will store the associated username in the host table so other applications know this information about this hosts. Each row show a given host and all the information currently stored for that host (IP).
+
The host view by default shows all hosts and some basic information about each session.
 +
To view all the information for a session click on the session and all attributes are displayed in the property grid on the right side.
  
The viewable information about a host is listed below
+
# '''Refresh''' refreshes the grid with the current active sessions.
 +
# '''Auto Refresh''' toggles automatic refreshing of the grid.
 +
# '''Reset View''' resets the view to the default view. Any changes to the default view are saved in your local browser session.
 +
# '''Filter''' provides the ability to quickly filter all sessions my many key attributes.
  
{| border="1" cellpadding="2" width="85%" align="center"
+
More controls can be access by mousing over any column head and using the drowdown menu on the column header.
 +
 
 +
# '''Sort Ascending''' sorts the selected column in ascending order.
 +
# '''Sort Descending''' sorts the selected column in descending order.
 +
# '''Columns''' allows the removal or addition of columns to the current view.
 +
# '''Filter''' provides a way to filter current data on this column with the provided value.
 +
 
 +
= Columns =
 +
 
 +
= Columns =
 +
 
 +
<blockquote style="background: white; border: 1px solid black; padding: 1em;">
 +
{| border="1" cellpadding="2"
 +
|+
 +
! Property !! Description
 +
|-
 +
| Address
 +
| The IP address of this Host
 +
|-
 +
| MAC Address
 +
| The MAC address of this Host if it is known
 
|-
 
|-
|width="30%"|'''Column Header'''
+
| MAC Vendor
|width="70%"| Property Description
+
| The Vendor of the MAC address of this Host if known
 
|-
 
|-
 +
| Interface
 +
| The interface on which this Host was last seen
 
|-
 
|-
|'''IP'''
+
| Creation Time
|The IP address of the host (the primary key)
+
| The creation time of this Host entry
|-
 
|'''MAC Address'''
 
|MAC address the network interface (wireless, ethernet) used by the host.
 
|-
 
|'''MAC Vendor'''
 
|Vendor of the network interface (wireless, ethernet) used by the host.
 
|-
 
|'''Last Accessed Time'''
 
|Last time information about this host was updated
 
|-
 
|'''Last Session Time'''
 
|Last time a non-bypassed session was initiated by this host
 
|-
 
|'''Last Complete TCP Session Time'''
 
|Last time a non-bypassed TCP session was successfully initiated from this host
 
 
|-
 
|-
|'''Entitled'''
+
| Last Access Time
|True if "entitled" to paid applications, false otherwise
+
| The last time an app or the platform accessed this Host entry
 
|-
 
|-
|'''Active'''
+
| Last Session Time
|True if considered "active" for licensing purposes, false otherwise
+
| The last time this host attempted to create a session
 
|-
 
|-
|'''Hostname'''
+
| Last Completed TCP Session Time
|The hostname of this IP (if known)
+
| The last time this host successfuly completed a TCP session to a WAN address
 
|-
 
|-
|'''Username'''
+
| Entitled Status
|The username of this IP (if known)
+
| False if this host is not entitled to premium functionality because the limit is exceeded True otherwise
 
|-
 
|-
|'''Penalty Boxed'''
+
| Active
|Is this host in the Penalty Box (true is yes)
+
| True if this host is considered "active," False otherwise
 
|-
 
|-
|'''Penalty Box Entry Time'''
+
| HTTP User Agent
|Time the host entered the penalty box
+
| The HTTP User Agent of this host (according to a recent HTTP request)
 
|-
 
|-
|'''Penalty Box Exit Time'''
+
| Captive Portal Authenticated
|Time the host will exit the penalty box
+
| True if this Host is authenticated with [[Captive Portal]] (at least one)
 
|-
 
|-
|'''Quota Size'''
+
| Tags
|The Quota size in bytes granted to this host (if it has a quota)
+
| The tags of this Host
 
|-
 
|-
|'''Quota Remaining'''
+
| Tags String
|The Quota remaining size in bytes for this host (if it has a quota)
+
| The tags of this Host
 
|-
 
|-
|'''Quota Issue Time'''
+
| Hostname
|The time the quota was issued
+
| The official ''Hostname'' of this host
 
|-
 
|-
|'''Quota Expiration Time'''
+
| Hostname Source
|The time the quota will expire
+
| The source of the official ''Hostname'' of this host
 
|-
 
|-
|'''HTTP - User Agent'''
+
| Hostname (DHCP)
|The host's browser reported User Agent string
+
| The hostname of this host according to DHCP (Hosts often specify their hostname when retrieving a DHCP lease)
 
|-
 
|-
|'''Captive Portal - Authenticated'''
+
| Hostname (DNS)
|Stores the authentication state of this host through [[Captive Portal]] (true/false)
+
| The hostname of this host according to reverse DNS
 
|-
 
|-
|'''Captive Portal - Username'''
+
| Hostname (Device)
|The username of this host according to [[Captive Portal]]
+
| The hostname of this host's MAC address according to [[Devices]]
 
|-
 
|-
|'''Directory Connector - Username'''
+
| Hostname (Device Last Known)
|The username of this host according to [[Directory Connector]]
+
| The last known hostname of this host's MAC address according to [[Devices]]
 
|-
 
|-
|'''L2TP - Username'''
+
| Hostname (OpenVPN)
|The username of this host according to L2TP in [[IPsec VPN]]
+
| The hostname according to [[OpenVPN]]
 
|-
 
|-
|'''Xauth - Username'''
+
| Hostname (Reports)
|The username of this host according to Xauth in [[IPsec VPN]]
+
| The hostname according to the Name Map in [[Reports]]
 
|-
 
|-
|'''Device Username'''
+
| Hostname (Directory Connector)
|The username of this host according to the ''Device Username'' in the [[Device List]]
+
| The hostname according to [[Directory Connector]]
|}
+
|-
 
+
| Username
Clicking on the dropdown on the column header provides several features to help view large data sets:
+
| The official ''Username'' associated with this host
* Sort values by that row.
+
|-
* Hide/Unhide certain columns
+
| Username Source
* Group by that column (all shared values will be grouped together)
+
| The source of the official ''Username''
* Filter data (only show data that matches the provided filter on that row)
+
|-
 
+
| Username (Directory Connector)
== Penalty Box Hosts ==
+
| The username according to [[Directory Connector]]
 
+
|-
This tab shows all the host currently in the [[Penalty Box]]. This is just a different view of the same information shown in the ''Current Hosts'' tab. It only shows hosts where ''Penalty Boxed'' is true.
+
| Username (Captive Portal)
 
+
| The username according to [[Captive Portal]]
== Penalty Box Event Log ==
 
 
 
This event log shows penalty box enter and exit events.
 
 
 
The columns of the event log:
 
 
 
{| border="1" cellpadding="2" width="85%" align="center"
 
|+
 
! Name !! Description
 
 
|-
 
|-
|width="15%"|'''Start Time'''
+
| Username (Device)
|width="70%"|The time the host was put in the penalty box.
+
| The username of this host's MAC address according to [[Devices]]
 
|-
 
|-
|'''End Time'''
+
| Username (OpenVPN)
|The time the host is planned to be or was released from the penalty box.
+
| The username according to [[OpenVPN]]
 
|-
 
|-
|'''Address'''
+
| Username (IPsec VPN)
|The host/IP placed in the penalty box
+
| The username according to [[IPsec VPN]]
 
|-
 
|-
|'''Reason'''
+
| Quota Size
|The text string explaining the reason the host was placed in the penalty box.
+
| The size of this host's quota (in bytes)
|}
 
 
 
== Current Quotas ==
 
 
 
This tab shows all the hosts currently with a quota. This is just a different view of the same information shown in the ''Current Hosts'' tab, except only showing hosts with a quota.
 
 
 
== Quota Event Log ==
 
 
 
This event log shows all quota events.
 
 
 
The columns of the event log:
 
 
 
{| border="1" cellpadding="2" width="85%" align="center"
 
|+
 
! Name !! Description
 
 
|-
 
|-
|width="15%"|'''Timestamp'''
+
| Quota Remaining
|width="70%"|The time of the event
+
| The amount of quota remaining (in bytes)
 
|-
 
|-
|'''Address'''
+
| Quota Issue Time
|The host/IP placed in the penalty box
+
| The original issue time of this host's quota
 
|-
 
|-
|'''Action'''
+
| Quota Expiration Time
|The action of the event.
+
| The expiration time of this host's quota
 
|-
 
|-
|'''Quota Size'''
+
| Refill Quota
|The size of the quota.
+
| '''Refill Quota''' action will refill this Host's quota
 
|-
 
|-
|'''Reason'''
+
| Drop Quota
|The text string explaining the reason the action was taken.
+
| '''Drop Quota''' action will remove this Host's quota
 
|}
 
|}
 +
 +
</blockquote>

Latest revision as of 02:25, 19 May 2017

Hosts provides a view of all current "hosts" or unique IP address on the local network(s).

Each row represents a single a host (unique IP address) that has been seen on any LAN interface.

As Untangle scans and processes network traffic, the platform and many of the apps will save information about a host on the network. This information is stored in the "Host Table" and the Hosts view provides a view into the host table.

Controls

The host view by default shows all hosts and some basic information about each session. To view all the information for a session click on the session and all attributes are displayed in the property grid on the right side.

  1. Refresh refreshes the grid with the current active sessions.
  2. Auto Refresh toggles automatic refreshing of the grid.
  3. Reset View resets the view to the default view. Any changes to the default view are saved in your local browser session.
  4. Filter provides the ability to quickly filter all sessions my many key attributes.

More controls can be access by mousing over any column head and using the drowdown menu on the column header.

  1. Sort Ascending sorts the selected column in ascending order.
  2. Sort Descending sorts the selected column in descending order.
  3. Columns allows the removal or addition of columns to the current view.
  4. Filter provides a way to filter current data on this column with the provided value.

Columns

Columns

Property Description
Address The IP address of this Host
MAC Address The MAC address of this Host if it is known
MAC Vendor The Vendor of the MAC address of this Host if known
Interface The interface on which this Host was last seen
Creation Time The creation time of this Host entry
Last Access Time The last time an app or the platform accessed this Host entry
Last Session Time The last time this host attempted to create a session
Last Completed TCP Session Time The last time this host successfuly completed a TCP session to a WAN address
Entitled Status False if this host is not entitled to premium functionality because the limit is exceeded True otherwise
Active True if this host is considered "active," False otherwise
HTTP User Agent The HTTP User Agent of this host (according to a recent HTTP request)
Captive Portal Authenticated True if this Host is authenticated with Captive Portal (at least one)
Tags The tags of this Host
Tags String The tags of this Host
Hostname The official Hostname of this host
Hostname Source The source of the official Hostname of this host
Hostname (DHCP) The hostname of this host according to DHCP (Hosts often specify their hostname when retrieving a DHCP lease)
Hostname (DNS) The hostname of this host according to reverse DNS
Hostname (Device) The hostname of this host's MAC address according to Devices
Hostname (Device Last Known) The last known hostname of this host's MAC address according to Devices
Hostname (OpenVPN) The hostname according to OpenVPN
Hostname (Reports) The hostname according to the Name Map in Reports
Hostname (Directory Connector) The hostname according to Directory Connector
Username The official Username associated with this host
Username Source The source of the official Username
Username (Directory Connector) The username according to Directory Connector
Username (Captive Portal) The username according to Captive Portal
Username (Device) The username of this host's MAC address according to Devices
Username (OpenVPN) The username according to OpenVPN
Username (IPsec VPN) The username according to IPsec VPN
Quota Size The size of this host's quota (in bytes)
Quota Remaining The amount of quota remaining (in bytes)
Quota Issue Time The original issue time of this host's quota
Quota Expiration Time The expiration time of this host's quota
Refill Quota Refill Quota action will refill this Host's quota
Drop Quota Drop Quota action will remove this Host's quota