====== KeexyBox - Manage profiles ======

Profiles are used to define the Internet connection settings for [[users_manage|users]] or [[devices_manage|devices]].

To manage profiles:

  - Use your browser and connect to the [[using_admin_access|KeexyBox Management Web interface]].
  - On left menu, go to ''Connection settings -> Profiles''.
  - You will be redirected to the ''Profiles'' page.

===== Create a new profile =====

  - Click on {{:keexybox_ico:plus.png?nolink}} at the top of the ''Profiles'' page.
  - Complete the form as follow:
    * ''Name'': Define the name for the profile.
    * ''Default connection type'': Set ''Direct'' to use your regular Internet connection or Tor to anonymize the connection.
    * ''Default Firewall rule'': Set ''Accept'' to allow by default all connections to the Internet otherwise set ''Drop''.
  - Click ''Save''.
  - You will be redirected to the  [[profiles_manage#Edit a profile|edit profile]] page that will allows you to customize it.
 
===== Modify a profile =====

  - On the ''Profiles'' page, identify in the list the profile you wish to edit.
  - Click on ''Edit'' {{:keexybox_ico:edit.png?nolink}} button. 
  - You will be redirected to the [[profiles_manage#Edit a profile|edit profile]] page.

===== Edit a profile =====

The edition of the profile is organized in sections explained below.

When you have finished configuring the profile, click on ''Save'' otherwise click on ''Cancel'' to not save the changes.

^Section^Field^Description|
^General|''Name''|The Name of the profile.|
^:::|''Statistics''|When this box is checked, visited domains/websites will be logged. Logs are used to generate statistics on Internet usage.|
^Search engine options and Blacklist categories|''Search engine options''|By checking these boxes, you will force search engines to filter the results even if users try to disable the option in their browser.|
^:::|''Categories to filter''|You have to select all [[blacklist_manage|Blacklist]] categories of Domains/Websites you wish to block.|
^Firewall and routing|''Manage domain routing''|This button will open a new window to [[profiles_manage_domain_routing|manage domain routing]].|
^:::|''Manage Firewall''|This button will open a new window to [[profiles_manage_firewall|manage firewall]] rules for outgoing traffic.|
^:::|''Redirect DNS queries to TOR''|When this box is checked, all DNS queries will be anonymized by redirecting them to the Tor network|
^Connection schedules|:!: If no schedules are defined, the Internet access is allowed at any time.||
^:::|''Add schedule''|Click on this button to add Internet access schedule. Check the boxes for the days for which you want to allow Internet access and then set the ''Start time'' and ''End time'' for the Internet access. Replay the steps as many times as you want to set Internet access schedules.| 
^:::|''Remove schedule''|Click on this button if you want to cancel the ''Add schedule'' you just have done.|
^:::|Delete ''Action'' {{:keexybox_ico:trash.png?nolink}}|Click on this button to delete schedules that already exists. You will get a message asking you to confirm the deletion. Answer ''yes''.|  




===== Delete a profile =====

  - On the ''Profiles'' page, identify in the list the profile you wish to delete.
  - Click on ''delete'' {{:keexybox_ico:trash.png?nolink}} button.
  - You will get a message asking you to confirm the deletion. Answer ''yes''.

:!: When you delete a profile assigned to users or devices, the default profile (1) will be automatically assigned to these users and devices. Then all current connections using the deleted profile will be automatically reconnected with the default profile.

(1) The default profile is the only profile you can't delete.



===== Export / import profile settings =====

KeexyBox allows you to export or import profile settings. Exporting or Importing a profile can be useful in the following cases:
  * To backup the profile settings
  * To copy the profile settings to another profile
  * To import the profile settings to another KeexyBox

=== Export profile settings ===

  - On the ''Profiles'' page, identify in the list the profile you wish to export.
  - On action column, click on the ''export'' {{:keexybox_ico:export.png?nolink}} button.
  - Select part of the profile you want to export:
    * ''Export settings'' (profile name, default routing, default firewall rule, statistics, DNS to Tor and safe search settings).
    * ''Export connection schedules''.
    * ''Export Blacklist categories''.
    * ''Export domain routing''.
    * ''Export firewall rules''.
  - Then click on ''Export''. 
  - Download the file on your computer.

=== Import profile settings ===

  - Click on {{:keexybox_ico:import.png?nolink}} at the top of ''Profiles'' page.
  - ''Select tar.gz file'': Click on ''Browse''.
  - Select the tar.gz file to import.
  - Click on ''Upload''.
  - You will be redirected to a page that look like [[#Edit a profile|edit profile]] page.
  - You can adjust the profile settings before importing it.
  - Click on ''Import'' to save the profile.