Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

URL - If you leave the URL option as set, Open-AudIT will inject the config value for default_network_address into the URL option. With the default scripts, if left as set, Open-AudIT will inject the default network address when the script is downloaded.

 


Image RemovedImage Added
.
Image RemovedImage Added

Viewing Script Details

...

You will see a list of scripts. You can view a script by clicking on the blue view icon. You can also edit or delete your script.


 Image Added

Image Removed

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: Manage Admin -> Database -> List Tables, then clicking on the "scripts" table.

Code Block
languagetext
themeEclipse
languagetext
CREATE TABLE `scripts` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(200) NOT NULL DEFAULT '',
  `org_id` int(10) unsigned NOT NULL DEFAULT '1',
  `options` text NOT NULL,
  `description` text NOT NULL,
  `based_on` varchar(200) NOT NULL DEFAULT '',
  `hash` varchar(250) 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`)
) ENGINE=InnoDB AUTO_INCREMENT=8 DEFAULT CHARSET=utf8;

...

Scripts are stored in the database in the "scripts" table. A typical entry will look as below.

Code Block
language
languagetext
themeEclipsetext
         id: 1
       name: audit_aix.sh
     org_id: 1
    options: {"submit_online":"y","create_file":"n","url":"http:\/\/localhost\/open-audit\/index.php\/input\/devices","debugging":1}
description: The default audit AIX config.
   based_on: audit_aix.sh
       hash: 
  edited_by: system
edited_date: 2000-01-01 00:00:00

...

You can access the /scripts 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 MethodIDActionResulting FunctionURL ExampleNotesExample Response
GETn
 

collection/scriptsReturns a list of scripts.script_collection.json
GETy
 

read/scripts/{id}Returns a scripts details.script_read.json
PATCHy
 

update/scripts/{id}Update an attribute of a scripts entry.script_patch.json
POSTn
 

create/scriptsInsert a new scripts entry.scripts_create.json
DELETEy
 

delete/scripts/{id}Delete a script entry.scripts_delete.json

Web Application Routes

Request MethodIDActionResulting FunctionURL ExampleNotes
GETncreatecreate_form/scripts/createDisplays a standard web form for submission to POST /scripts.
GETyupdateupdate_form/scripts/{id}/updateShow the script details with the option to update attributes using PATCH to /scripts/{id}
GETydownloaddownload/scripts/{id}/downloadDownload a complete audit script based on the script entry.

 

...