Introduction

As at 1.12.6 we have introduced the concept of Networks. The Blessed Subnets feature uses the data available in Networks.

How Does it Work?

As we run Discoveries and collect device results we populate the list of networks. The blessed Subnets feature uses this list of networks to only accept data from devices on those networks.

Creating a Network

To make another network go to menu -> Admin -> Networks -> Create Network. Provide a name and an optional description.

IMPORTANT - The network name should be a slash subnet address like 192.168.1.0/24. No spaces between the slash and numbers. It should be a valid subnet address. This string is what is tested against when using Blessed Subnets.

View Network Details

Go to menu -> Admin -> Networks -> List Networks.

You will see a list of available networks. You can view a network by clicking on the it's ID (in green). You can also edit or delete the network.

You will also see a list of the devices in that particular network.

Networks are stored in the database in the "networks" table. A typical entry will look as below.

         id: 5

       name: 192.168.1.0/24

description:

  edited_by: auto-generated by process_component

edited_date: 2016-07-29 13:51:03

API / Web Access?

You can access the /networks collection using the normal Open-AudIT JSON based API. Just like any other collection. Please see the API documentation for further details.

API Routes

Request Method	ID	Resulting Function	URL Example	Notes	Example Response
GET	n	collection	/networks	Returns a list of networks.	networks_collection.json
GET	y	read	/networks/{id}	Returns a network's details.	networks_read.json
PATCH	y	update	/networks/{id}	Update an attribute of a networks entry.	networks_patch.json
POST	n	create	/networks	Insert a new networks entry.	networks_create.json
DELETE	y	delete	/networks/{id}	Delete a networks entry.	networks_delete.json

Web Application Routes

Request Method	ID	Action	Resulting Function	URL Example	Notes
GET	n	create	create_form	/networks/create	Displays a standard web form for submission to POST /networks.
GET	y	update	update_form	/networks/{id}/update	Show the networks details with the option to update attributes using PATCH to /networks/{id}

Networks (pre v2)