DSS 12 S4 03 User Manual

School of Computer Science & Software Engineering
Bachelor of Computer Science (Digital Systems Security)
CSCI321- Project User Manual 27 Feburary 2013
Group: SS12/4B Khoo Jun Xiang Ang Wencan Stephen Goh Kheng Siang Joel Lim Sing Hui Low Jia Hui 4000766 4194032 4187490 4185948 4186448
Jxkhoo001@mymail.sim.edu.sg Wsang003@mymail.sim.edu.sg Ksgoh007@mymail.sim.edu.sg Shlim035@mymail.sim.edu.sg Jhlow010@mymail.sim.edu.sg
Supervisor: Mr Sionggo Jappit Assessor: Mr Tan Kheng Teck
User Manual
[SS12/4B]
About this manual:

DB-Wrapper provides protection against Inference Attack on Statistical Database. This user manual is specially designed to explain DB-Wrapper's function and features.

Please read this manual before using to ensure safe and proper use. Images and screen-shots may differ in appearance from actual product. DB-Wrapper is not liable for performance issues or incompatibilities caused by editing registry settings or modified operating system software. Attempting to customize the operating system may cause the program to work improperly. Software, images, and other media provided with this device are licensed for limited use. Extracting and using these materials for commercial or other purposes is an infringement of copyright laws. Users are entirely responsible for illegal use of media.
Page 2 of 48
User Manual
[SS12/4B]
Table of Contents
Download
Downloading DB-Wrapper.................................................................................4
Installation
Installing DB-Wrapper.......................................................................................5
Uninstallation
Uninstalling DB-Wrapper..................................................................................8
Login
Logging in............................................................................................................9
Administrator
View Log............................................................................................................10 Range.................................................................................................................13 Application........................................................................................................15 User....................................................................................................................18 Role....................................................................................................................24 Constraint.........................................................................................................33
User
Create Report...................................................................................................39 View Report......................................................................................................45
Page 3 of 48
User Manual
[SS12/4B]
Download Downloading DB-Wrapper

Detailed walk-through on downloading DB-Wrapper
Go to http://db-engine.blogspot.sg/ Select Download tab Click on Download Here
Wait for download to finish Double click on setup file Or Type java jar DB-Wrapperv1.0.1.jar on terminal
Page 4 of 48
User Manual
[SS12/4B]
Installation Installing DB-Wrapper

Detailed walk-through on installing DB-Wrapper
Select Language and click OK
Click Next to proceed
Page 5 of 48
User Manual
[SS12/4B]
Read the following information and click Next to proceed
Choose the package to install and click Next to proceed
Page 6 of 48
User Manual
[SS12/4B]
Click Next to finish install
Wait for the installation to finish and click on Done
Page 7 of 48
User Manual
[SS12/4B]
Uninstallation Uninstalling DB-Wrapper

Detailed walk-through on uninstalling DB-Wrapper
Double click on the Uninstaller.jar
Check the box and click on Uninstall
Wait for the Uninstallation process to complete
Page 8 of 48
User Manual
[SS12/4B]
Login Logging in
This is the startup page of DB-Wrapper
Enter Username and Password to login. Depending on the roles granted, different users will be directed to different pages. For administrators, guide will begin in page 3. For normal users, guide will begin in page 4.
Normal Users' homepage
Administrators' homepage
Page 9 of 48
User Manual
[SS12/4B]
Administrator View Log

Detailed walk-through of the function View Log View Log enables to Administrators to view the records of queries made by Normal Users. Successful and unsuccessful queries are separated, eliminating the administrators the need to differentiate them. By examining the logs, administrators are able to monitor user's activities.
Start Page of View Log function
Page 10 of 48
User Manual
[SS12/4B]
Enter a Valid Username
Unsuccessful queries made by user, user001, will be shown SQL statements are noted to enable Administrators to study if user is trying to perform an Inference Attack
Page 11 of 48
User Manual
[SS12/4B]
Successful queries made by user, user001, will be shown SQL statements are noted to enable Administrators to study if user is trying to perform an Inference Attack
Page 12 of 48
User Manual
[SS12/4B]
Administrator Range
Detailed walk-through of the function Range Range will tabulate the result to show in Ranges. For example, 1000 3500, 3501 5000
Start Page of Range function
Enter values required by the program
Page 13 of 48
User Manual
[SS12/4B]
Once finalized, click on Ok
Message will be shown if the entry is accepted by the program
Page 14 of 48
User Manual
[SS12/4B]
Administrator Application
Detailed walk-through of Application function Application function allows the program to read-in a valid database present in the system. Administrators are able to select the tables and their attributes to be read-in. Note that administrators are not able to view the exact values of each attributes. This feature prevents administrators themselves from going rogue.
Start page of Application function
Page 15 of 48
User Manual
[SS12/4B]
Enter values accordingly
Upon selecting a table, its attribute will be shown on the screen
Page 16 of 48
User Manual
[SS12/4B]
Select attributes you wish to be read-in or click on * to select all attributes Once finalized, click on Submit
Message will be shown if application is read-in successfully
Page 17 of 48
User Manual
[SS12/4B]
Administrator User (Create)

Detailed walk-through of User function User function is sub-divided into 3 other parts Create, Update and Delete Create Allows administrators to create new users to access the program
Start page of User function (Create)
Page 18 of 48
User Manual
[SS12/4B]
Enter values required by the program. Once finalized, click on Ok Password must be 8 characters long and contains upper case, lower case and number.
Message will be shown to inform user if entry is accepted by program
Page 19 of 48
User Manual
[SS12/4B]
Administrator User (Update)

Update Allows administrators to modify existing users' details
Start page of User function (Update)
Enter values required by the program. Once finalized, click on Ok
Page 20 of 48
User Manual
[SS12/4B]
Message will be shown if entry is accepted by the program
Page 21 of 48
User Manual
[SS12/4B]
Administrator User (Delete)

Delete Allows administrators to delete existing users
Start page of User function (Delete)
Select user you wish to delete
Page 22 of 48
User Manual
[SS12/4B]
Once finalized, click on Ok
Page 23 of 48
User Manual
[SS12/4B]
Administrator Role (Create)

Detailed walk-through of User function User function is sub-divided into 3 other parts Create, Update and Delete Create Allows administrators to create new roles for the program
Start page of Role function (Create)
Page 24 of 48
User Manual
[SS12/4B]
Enter values required by program
Select Application and Tables for the new role to access. Once finalized, click on Create
Page 25 of 48
User Manual
[SS12/4B]
Message will be shown if entry is accepted by program
Page 26 of 48
User Manual
[SS12/4B]
Administrator Role (Update)

Update Allows administrators to update existing roles
Start page of Role function (Update)
Select values required by the program or click on * to select all tables
Page 27 of 48
User Manual
[SS12/4B]
Once finalized, click on Update
Page 28 of 48
User Manual
[SS12/4B]
Administrator Role (Delete)

Delete Allows administrators to delete existing roles
Start page of Role function (Delete)
Select existing role to delete
Page 29 of 48
User Manual
[SS12/4B]
If there are users tied to the role, it will show be reflected as shown in the diagram
Click on the user, and a pop up will appear to prompt you to change the role of the user. Before deleting the role
Page 30 of 48
User Manual
[SS12/4B]
Select a new role for the user
Once cleared, click Ok to delete
Page 31 of 48
User Manual
[SS12/4B]
Page 32 of 48
User Manual
[SS12/4B]
Administrator Constraint (Create)

Detailed walk-through of Constraint function User function is sub-divided into 3 other parts Create, Update and Delete
Create Allows administrators to create new constraints for the program
Start page of Constraint function (Create)
Page 33 of 48
User Manual
[SS12/4B]
Select values required by program
Once values are finalized, click on OK to create constraint Message will be shown if entry is accepted by program
Page 34 of 48
User Manual
[SS12/4B]
Administrator Constraint (Update)

Update Allows administrators to update existing constraints.
Start page of Constraint function (Update)
Page 35 of 48
User Manual
[SS12/4B]
Once finalized, click on OK
Page 36 of 48
User Manual
[SS12/4B]
Administrator Constraint (Delete)

Delete Allows administrators to delete existing constraints from the program
Start page of Constraint page (Delete)
Page 37 of 48
User Manual
[SS12/4B]
Page 38 of 48
User Manual
[SS12/4B]
User Create Report

Detailed walk-through of Create Report function Query function allows users to make query based on Application, Table and Attributes while providing protecting against inference protection Users' actions are automatically logged for administrators to view in the case where the user misuse their rights
Start page of Create Report function
Page 39 of 48
User Manual
[SS12/4B]
User can click on the ? button for help
Page 40 of 48
User Manual
[SS12/4B]
Once finalized, click on the + button Selected value will appear on the right hand side of the screen More than 1 value can be added
Page 41 of 48
User Manual
[SS12/4B]
Click on the values shown on the right and select Add button to construct and add the queries Depending on the report user wants, more than 1 query can be added
If multiple tables were selected, User will be prompt to select Join option in a new pop up window
Page 42 of 48
User Manual
[SS12/4B]
Join option for Inner / Outer Join
Join option for Cross / Natural Join
Page 43 of 48
User Manual
[SS12/4B]
SQL statement for the query will be generated below. Click on it and select Ok to execute the queries and create the report
Report is displayed in a pop up window and user can choose to generate the report
Enter report name and click OK Click Exit to return to make query page
Page 44 of 48
User Manual
[SS12/4B]
User View Report

Detailed walk-through of View Report function A list of reports previously created by user will be displayed to the user. User can choose a report to view it. User can export the report if needed.
Start page of View Report Report previously generated is displayed with tits created date and time Click on the report name to view the report
Page 45 of 48
User Manual
[SS12/4B]
Report will be displayed in a pop up window
Click on Export to save the report in text or excel form Textbox will be displayed for user to enter the report name
Page 46 of 48
User Manual
[SS12/4B]
Report exported to .txt
Report exported to Excel
Page 47 of 48
User Manual
[SS12/4B]
To delete the report, just click on the delete button beside the report name Only the owner can delete the report
Page 48 of 48

DSS 12 S4 03 User Manual

Încărcat de

Informații document

Descriere originală:

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

DSS 12 S4 03 User Manual

Încărcat de

Drepturi de autor:

Formate disponibile

School of Computer Science & Software Engineering

Bachelor of Computer Science (Digital Systems Security)

CSCI321- Project User Manual 27 Feburary 2013

Supervisor: Mr Sionggo Jappit Assessor: Mr Tan Kheng Teck

About this manual:

Download Downloading DB-Wrapper

Go to http://db-engine.blogspot.sg/ Select Download tab Click on Download Here

Installation Installing DB-Wrapper

Select Language and click OK

Click Next to proceed

Read the following information and click Next to proceed

Choose the package to install and click Next to proceed

Click Next to finish install

Wait for the installation to finish and click on Done

Uninstallation Uninstalling DB-Wrapper

Double click on the Uninstaller.jar

Check the box and click on Uninstall

Wait for the Uninstallation process to complete

Normal Users' homepage

Administrator View Log

Enter a Valid Username

Start Page of Range function

Enter values required by the program

Once finalized, click on Ok

Message will be shown if the entry is accepted by the program

Start page of Application function

Enter values accordingly

Upon selecting a table, its attribute will be shown on the screen

Message will be shown if application is read-in successfully

Administrator User (Create)

Start page of User function (Create)

Message will be shown to inform user if entry is accepted by program

Administrator User (Update)

Start page of User function (Update)

Enter values required by the program. Once finalized, click on Ok

Message will be shown if entry is accepted by the program

Administrator User (Delete)

Start page of User function (Delete)

Select user you wish to delete

Once finalized, click on Ok

Message will be shown if entry is accepted by the program

Administrator Role (Create)

Start page of Role function (Create)

Enter values required by program

Message will be shown if entry is accepted by program

Administrator Role (Update)

Start page of Role function (Update)

Select values required by the program or click on * to select all tables

Once finalized, click on Update

Message will be shown if entry is accepted by program

Administrator Role (Delete)

Start page of Role function (Delete)

Select existing role to delete

Select a new role for the user

Once cleared, click Ok to delete

Message will be shown if entry is accepted by program

Administrator Constraint (Create)

Start page of Constraint function (Create)

Select values required by program

Administrator Constraint (Update)

Start page of Constraint function (Update)

Select values required by program

Once finalized, click on OK