Child pages
  • Orgs
Skip to end of metadata
Go to start of metadata


This new access method replaces the old admin_org controller and functions.

How Does it Work?

Orgs (organisations) in Open-AudIT are a key item. A user has a primary Org as well as a list of Orgs they can access. A user combines this with a list of assigned 'Roles' that define what actions they can take on items assigned to the Orgs they have access to. The combination of a users 'orgs' and 'roles' define what they can and cannot do within Open-AudIT.

Most items in Open-AudIT are assigned to an Org. Devices, Locations, Networks, etc, etc.

Orgs can have child Orgs. Think of an organisational chart (tree) structure. If a user has access to a specific Org, they also have access to that Orgs descendants.

Creating an Organisation

Join Paul McClendon, an Opmantek Support Engineer, as he demonstrates how to create organizations to be used in Open-AudIT.

To make another organisation go to menu: Manage -> Orgs -> Create Orgs.

View Organisation Details

Go to menu: Manage -> Orgs -> List Orgs.

You will see a list of organisations. You can view an organisation by clicking on the blue view button. You can also edit or delete your organisations.

Database Schema

The schema for the database is below. It can also be found in the application if the user has database::read permission by going to menu: Admin -> Database -> List Tables, then clicking on the "orgs" table.

  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(200) NOT NULL DEFAULT '',
  `parent_id` int(10) unsigned DEFAULT '1',
  `description` text NOT NULL,
  `ad_group` varchar(100) NOT NULL DEFAULT '',
  `edited_by` varchar(200) NOT NULL DEFAULT '',
  `edited_date` datetime NOT NULL DEFAULT '2000-01-01 00:00:00',
  PRIMARY KEY (`id`)

Example Database Entry

Orgs are stored in the database in the "orgs" table. A typical entry will look as below.

         id: 2
       name: Sea View Office
  parent_id: 1
description: Awesome view
  edited_by: Administrator
edited_date: 2017-05-17 16:31:44

API / Web Access

You can access the /orgs 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
Resulting Function
URL Example
Example Response
collection/orgsReturns a list of organisations.orgs_collection.json
read/orgs/{id}Returns an organisation's details.orgs_read.json
update/orgs/{id}Update an attribute of an organisations entry.orgs_patch.json
create/orgsInsert a new organisations entry.orgs_create.json
delete/orgs/{id}Delete an organisations entry.orgs_delete.json

Web Application Routes

Request Method
Resulting Function
URL Example
GETncreatecreate_form/orgs/createDisplays a standard web form for submission to POST /orgs.
GETyupdateupdate_form/orgs/{id}/updateShow the networks details with the option to update attributes using PATCH to /orgs/{id}