Profile Editor
==================

.. sectionauthor:: Adriano Monteiro Marques

.. warning::

   This documentation is not finished! Part or all of it's content may be
   missing or inaccurate. As Umit is under constant development and
   improvement, expect changes in this documentation at upcoming releases.


Introduction
-------------------

What is the profile editor?
~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
Using **Umit** it's normal when you can use the same arguments or make some scans
and sometimes it's not easy to search for the same options of nmap again.
    
What do it does?
~~~~~~~~~~~~~~~~~~
  
Profile Editor is able to create, copy and delele profiles. With it 
you should be able to save the nmap arguments and run scans with some paramenters in the 
future.
    
The customization advantage: It's easy to call a Profile. 
In the tab scan you only choose the target, and select a Profile. It
will define automatically the Nmap parameters. 

The profile editor modes
    
New profile:
It's easy to create a new profile, you can define all **Nmap** parameters and 
save you a suggestive name.

Edit profile
If you sometimes want to change the paramenters of profile, you should be use
edit of profiles and add, or remove the parameters, checking it on the boxes.
    

Creating a simple scan profile
------------------------------------

   .. image:: static/profile_editor_1.png
      :align: center       
   
Screenshot above it's the Profile Editor.

Use the key-stroke
The key-stroke that creates a new Profile is CTRL + P
    
Acces from the Main Menu
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Go to the **Main Menu** (the one on the top of the application),
*Profile*  ; New Profile
    
The profile descriptions (name, hint, description, etc.)
There are some fields to fill about a Profile. It's mandatory fill the 
name. 

Name: It is the name that appears on combo box of **Scan Tab** 
Hint: it is a tooltip
Description: it's just to say what this profile does.
   
You can browse on the tabs and apply option that you wish to build
a profile that you intend.    
    
Just press Ok and you save the profile
How to use the recently created profile?
You can find recently profile created on Combo box in Scan tab. So just fill the target, select profile and press scan. The option of your new profile are running on the scan.     
    

Editing a profile
----------------------------

Use the key-stroke
The key-stroke Edit Profile is *CTRL + E* 
    
Acces from the Main Menu.
Go to the **Main Menu** (the one on the top of the application),
*Profile*; Edit Profile
    

Creating a new profile based on an old one
------------------------------------------------

This option is like copy a profile. If you have a Profile and you can create
 a similar Profile, use it.

Use the key-stroke
In combo Box of Scan Tab select a profile. The key-stroke create Profile is *CTRL + R*

Acces from the Main Menu.
Select Profile in combo box of Scan tab and go to the **Main Menu** (the one on the top of the application),
Profile; New Profile with Selected


Delete Profiles
-----------------------------
    
If you want delete a Profile by some reason it is possible. 
Only follow the one of the procedure
    
Use the key-stroke
In combo Box of Scan Tab select a profile. The key-stroke delete Profile is *CTRL + M* 
    
Acces from the Main Menu.
Select Profile in combo box of Scan tab and go to the **Main Menu** (the one on the top of the application),
Profile; Delete Profile


Using Profile Editor

Select Profile in combo box of Scan tab and go to **Main Menu** (the one on the top of the application),
Profile ; Edit Profile.
Press *Delete* button. 
    


The profile editor structure
---------------------------------------

Where is saved options? In options.xml, you can find in your 
*$HOME/.umit/* 
    

The profile_editor.xml can be found on the same place and it uses options 
from options.xml
    
The widgets available for options is combo box, checkbox and text
entry. We have the box with numbers (for example, number of ports) to
use as parameter.