Contact UsContact Us

Objects and Object Pools

This article is for IT support.

What are Objects?

Objects are variables that you can use to manage and fine-tune your School Manager configuration.


What are Object Pools?

Object Pools are tools that help you block or allow certain types of Objects in bulk.  Object Pools allow you to define lists of commonly used keywords and addresses for filtering, network configuration and authentication. 

You can create a few different types of Object Pools:

Object Pool

Description

Example

IP Range List

Create a list of individual IP addresses or a list of IP address ranges.

192.168.1.1-192.168.1.50 (for IP address ranges)

192.168.1.1 (for individual IP address)

192.168.1.1-192.168.1.1 (for individual IP address)

IP Subnet List

Create a list of network subnet ranges.  This can be entered in decimal notation or CIDR notation.

192.168.1.0/255.255.255.0

192.168.1.0/24

Website List

Create a list of website domains. The websites can be specific URLs. The protocol identifier http:// or https:// is not required.

www.google.com/search?q=stuff

www.youtube.com/watch?v=dQw4w9WgXcQ

www.google.com

MAC Address List

Create a list of device MAC addresses.

10:13:C1:22:F5:79

37:08:B1:43:FB:56

08:89:B7:89:BC:6C

Search Keywords

Create a list of search term keywords

Search keyword inspection is dependent on:

  • MITM (Man In The Middle) must is enabled in Mobile Agent for Windows, macOS, and iOS/iPadOS
  • Connect for Chrome installed in the browser for Chromebook, Windows or macOS
  • HTTPS (SSL) Inspection is enabled for a School Manager physical appliance

guns

porn

nudity

Domains

Add a list of root level "bypass domains" and/or subdomains to be excluded from filtering in Mobile Agent when filtering blocks an allowed service.

collegetest.edu

ldap.school.edu

Add a list of Top-Level Domain Extensions  to be used in an allow or block Rule.

xin

gdn

.xin

.gdn

Creating new Object Pools

  1. On School Manager, go to Configuration > Objects > Pools.
  2. Select Add Pool.
  3. Give your Pool a Name and a Description.
  4. Select the Type of Pool from the drop-down list, then select Save.

Note

Make sure that the name of your Pool is memorable and clear about its function.  You'll need to know the name of a Pool in order to use it.

Editing Object Pools

  1. Select the Pool in Configuration > Objects > Pools.
  2. To add an Object:
  1. Select Add Entry.
  2. Add the Entry - the address, range or keyword that you want to enter.

    Note

    Entries for IP Ranges, IP Addresses and MAC addresses are validated. A message will appear for invalid entries.

  3. Give the entry a Name (Optional)
  4. Give the entry a Description (Optional)
  5. Select Save.

Editing or deleting an Object Pool entry

  1. Select the Edit icon (pencil icon) for an object. The Add Entry dialogue will appear. 
  2. Edit the object by updating its Entry field, name and description, and select Save 
  3. To delete the object, select the Delete icon (bin icon). 
  4. Confirm you're ready to delete the entry by selecting Delete.

Note

While naming and describing your Entries is optional, it is best practice, especially if you have more than one admin in your environment.

Bulk importing Objects

School Manager allows you to import certain kinds of Objects in bulk into an Object Pool from a .csv file.

Important

Bulk importing into an existing Object Pool will overwrite any Objects already in that Pool.

  1. Prepare the .csv file. A tooltip similar to the image on the right will appear when you mouse over the IMPORT CSV button, showing the expected format for the specific type of object you wish to import, but the following guidelines always apply:

  • All values should be in Column A, starting in cell A1;
  • Only one value (or one IP range) per cell;
  • Headers are not included in your data; and
  • IP Range lists can contain individual IP addresses, but other Pool list types cannot contain ranges.
  1. Create a new Pool or open an existing one by selecting the Name.

  2. Select Import CSV.

  3. Select the .csv file that you are importing and select Open. The importer will run. A notification will appear if there are errors in the .csv file.

Where can I use Object Pools?

Before your start, note the name of the Object Pool you created.

Filtering

Configuration Item

Fields

Available Object Pool Types

Content Filtering > Add/Edit Rule

Search for Website/Category

Keyword* Website*

Select Criteria

IP Range

IP Subnet

MAC Address

Filtering > Safe Search > Add/Edit Rule

Select Criteria

IP Range

IP Subnet

MAC Address

Edge Networking

Warning

Changing some configurations for Edge Networking may disrupt or cut off connection for some users. Contact Linewize Support for assistance.

Configuration ItemFieldsAvailable Object Pool Types

Edge Networking > Firewall > Add/Edit Rule

Source

IP Range

IP Subnet

MAC Address

Destination

IP Range

IP Subnet

Edge Networking > WAN > Configuration > Edit Uplink Rule

Sources

Destination

IP Range

IP Subnet

MAC Address

Edge Networking > WAN > Port Forwarding > Edit Rule

Allowed Sources

Destination

IP Range

IP Subnet

Edge Networking > WAN > Many-1 NAT > Edit Rule

Allowed Sources

IP Range

IP Subnet

MAC Address

Destination

IP Range

IP Subnet

Edge Networking > WAN > NAT Exceptions > Edit Rule

Sources

IP Range

IP Subnet

MAC Address

Destination

IP Range

IP Subnet

Edge Networking > QoS > Rate Limiting > Edit Rule

Sources

IP Range

IP Subnet

MAC Address

Destination

IP Range

IP Subnet

Website

Edge Networking > QoS > Priority  > Edit Rule

Sources

IP Range

IP Subnet

MAC Address

Destination

IP Range

IP Su

bnet

Website

Configuration

Configuration ItemFields

Available Object Pool Types

Configuration > Authentication > Captive Portal

Networks

IP Range

IP Subnet

Configuration > Authentication > Captive Portal  > Add/Edit Exception

Select Criteria

IP Range

IP Subnet

Mac Address

Website

Configuration > Authentication > Timeouts > Edit Rule

Networks

IP Range

IP Subnet

Configuration > Walled Garden

Inclusions

IP Range

IP Subnet

Exceptions

IP Range

IP Subnet

Configuration > Mobile Agent > DNS Filtering

Exceptions

Domains List