User Guide Appendix
APconnections, Inc. // 303.997.1300 // www.netequalizer.com
Page 94 of 96
All rights reserved
Copyright © 2014, 2015 APconnections, Inc.
rev. 20150309
2.
On the NetEqualizer
You will need to create a text file containing a list of IP subnets to search, as show below.
You can name this file anything. In our example below, we show this as directory_ip_list
(ARG2 in the NDI generic API). This file should be stored in /etc/ on your NetEqualizer.
10.1.2.16/24
10.2.1.1/16
Note: This file ONLY contains the IP subnets that should be searched. This is important, as
we do not want to be looking up usernames for public IP addresses or for non-user devices
on a network.
Now you are ready to start the NDI API (usernames2). From the Maintenance and
Reference Menu,
Click on ->
Maintenance
->
[
Run a Command
]. In the text box, type in
the following command, using your actual values for ARG1 and ARG2:
/art/usernames2 ARG1 ARG2
ARG1
(URL in the following form):
http://server/script=
Where URL is a protected server open to the NetEqualizer only.
Script is the local cgi or php function that you wrote in #1 above that takes an argument of
an IP address and then returns one parameter, username. Return value should be either a
clean username or “unknown” if the IP address cannot be found.
ARG2
(text file):
directory_ip_list
directory_ip_list is the text file that you created above, which contains the IP subnets to use
when looking up usernames.
The fully-qualified command:
/art/usernames2 http://server/script= directory_ip_list
NDI Command Example
We have set up an example of the NDI Command using a publicly accessible server that
takes an IP and returns a random user name, to serve as an example of the format of the
NDI API. You can run this on your NetEqualizer box, as long as you have Software Update
7.0 loaded. From the Maintenance and Reference Menu,
Click on ->
Maintenance
->
[
Run
a Command
]
. In the text box, type in the following command:
/art/usernames2 http://www.airequalizer.com/ad/adpull.php?ip= /etc/directory_ip_list
Viewing Username data in Active Connections Report
We have modified our Active Connections Report to display usernames when they exist.
From the Management
and Reporting Menu,
Click on ->
View
Current Activity
->
[
View Active
Connections
]
. You will
see username in the last
field (ADUsername).
