Add and Configure the Entries in an IP Whitelist Table
This topic only applies to SCADAPack x70 devices on which the Enable IP Whitelist check box is selected (see Enable or Disable the IP Whitelist).
Ensure that the check box is clear if you do not intend using the IP Whitelist. By design, the Download Configuration pick action is not available on outstations on which the IP Whitelist is enabled, but the IP Whitelist Table is empty. This is to help prevent loss of communications between Geo SCADA Expert and the SCADAPack x70 device.
You use a SCADAPack x70 IP Whitelist Table to specify the addresses and services from which a particular SCADAPack x70 device is to accept inward network traffic. When the IP Whitelist is enabled (see above), only network traffic that is transmitted from addresses and services that are included in the IP Whitelist Table is accepted; network traffic that is transmitted from addresses and services that are not included in the IP Whitelist Table is ignored.
You use the table to specify the IP addresses and other parameters of permitted IP network traffic. You need to add an entry for each non-local IP address from which the SCADAPack x70 device is permitted to accept data.
communication loss
The entries that you specify in an IP Whitelist Table are persistent (that is, they are retained when the SCADAPack x70 device restarts).
In the Geo SCADA Expert database, the table is built into the SCADAPack x70 Device Configuration item to which it relates. Changes made to the whitelist configuration are downloaded to the SCADAPack x70 device when that device's Download Configuration pick action is next executed.
You specify these properties for each entry in a SCADAPack x70 IP Whitelist Table:
The IP address of the source of permitted network traffic. This could be the IP address of a device, a monitor PC, or another address. Use the IP Address in conjunction with the Subnet Mask to identify either a single source address, or a range of source IP addresses.
The valid format is nnn.nnn.nnn.nnn
. Omit any leading zeros from the address.
192.168.0.1
Used in conjunction with the IP Address to identify either a single source address, or one of a range of source addresses (a subnet) to which the SCADAPack x70 device is permitted to receive TCP/IP packets.
The valid format is nnn.nnn.nnn.nnn
. Omit any leading zeros from the address.
255.255.255.255
Short descriptive text used to identify the entry. The maximum length is 64 characters.
The direction(s) in which traffic is permitted for this IP address.
When adding or editing an entry in the table, you use a combo box to select the required direction. The options are Inbound and Outbound, Inbound, and Outbound. The default is Inbound and Outbound.
This property only applies when the Permitted Services (see below) is set to 'Custom Service'. The property is used to specify a custom Port Number via which IP traffic is permitted. The Port Number has to be in the range 0 to 65535 inclusive.
This property only applies when the Permitted Services (see below) is set to 'Custom Service'. The property is used to specify the data transmission protocol via which network traffic is permitted.
When adding or editing an entry in the table, you use a combo box to select the required protocol. The options are TCP, UDP, and TCP and UDP. The default is TCP.
Used to specify the service(s) for which traffic is permitted for this particular IP address. At least one option has to be selected. The options are:
- DNP3 over TCP
- DNP3 over UDP
- Modbus/TCP
- Modbus RTU over TCP
- Modbus RTU over UDP
- Logic Debug Service
- Telnet
- FTP
- HART Pass Through
- Terminal Server for Serial Port 1
- Terminal Server for Serial Port 2
- Terminal Server for Serial Port 3
- Terminal Server for Serial Port 4
- ICMP Ping Traffic
- All ICMP Traffic
- Custom Service.
The options that are available for selection vary, depending on the model of SCADAPack x70 device and the configuration of its ports (see Device Configuration Serial Port Tabs and see Device Configuration IP Communications Tab). Options that are not applicable are 'grayed out' and unavailable for use.
With the ICMP options, 'ICMP Ping Traffic' only permits ping traffic via the specified IP address, whereas 'All ICMP Traffic' permits all ICMP traffic via that IP address, including ping traffic.
Use the 'Custom Service' option if you want to specify a custom Port Number and transmission Protocol for which network traffic is to be permitted from a particular IP address.

- Display the Table for the relevant SCADAPack x70 Device Configuration item.
- Select the IP Whitelist Table tab to display the IP Whitelist Table.
- Select the Add IP Address button.
The Add IP Whitelist Entry dialog box is displayed. - Populate the fields as required (see above).
A diagnostic message indicates the fields that need populating with values that have to take a specific format, or for which at least one option needs selecting. The diagnostic message is removed once the fields are populated with values that have the required format, and when at least one Permitted Services option is selected.
- Select the OK button to close the dialog box and add the entry to the table.

- Display the Table for the relevant SCADAPack x70 Device Configuration item.
- Select the IP Whitelist Table tab to display the IP Whitelist Table.
- Either:
- Double-click on the entry that you want to edit.
Or:
- Click on the address that you want to edit.
- Select the Edit IP Address button.
The Edit IP Whitelist Entry dialog box is displayed.
- Change the address's configuration as required.
- Select the OK button to confirm the changes, close the dialog box, and update the Table.

- Display the Table for the relevant SCADAPack x70 Device Configuration item.
- Select the IP Whitelist Table tab to display the IP Whitelist Table.
- Select the entry for the address that is no longer required.
- Select the Remove IP Address button. (The button is only available for use when an entry is selected in the table.)
The address that was highlighted is removed from the table.

- Click on the column heading by which you want to sort the entries in the table. (To reverse the sorting order, click on the same column heading again.) The order in which the entries are sorted does not impact on the whitelist's functionality.
When you redisplay the table, the entries are listed in the order in which they were added to the table.