Everybody asks about security even though not all of people who asks seems to know difference between application security & network security; and act as if they are expecting to be under attack...no matter who & why asks about security issues it's still going to be a major concern when any application is considered. As of Odoo, security is an important factor and it is easy to provide security in modular basis.
Group-based Access Control
Groups can be created as normal records and menu access may be granted via menu definitions. However, even without a menu, objects may be accessible indirectly. In order to prevent this, object level permissions must be defined for groups. These permissions are usually inserted via CSV files in the security folder inside modules. The example below provide a basic view of providing group based access rights.
<record id="group_seat_management_user" model="res.groups"> <field name="name">Seat Administration / Manager </field> </record> <record model='ir.ui.menu' id='menu_seat_management'> <field name="groups_id" eval="[(6,0,[ref('group_seat_management_user')])]" /> </record>
Defining Access Rights ( ir.model.access.csv )
- id = unique identity for the permission (Example: MY_MODULE_res_partner_manager)
- name = unique name for the permission (Example: res_partner manager)
- model_id/id = the model unique name of the class you want apply permission on (Example model_res_partner)
- group_id/id = group permission apply on (yopu can define it in xml group file or call an existing group with syntax module.group_id)
- perm_read,perm_write,perm_create,perm_unlink = the 4 values for the relative permission to read, write,create,unlink record on defined class. 1 is True (you can do this action) and 0 is Faslse (you can’t)
A simple way to understand this file is to read an existing csv in some OpenERP base module like sale, account, product, etc…
Menu Access definition
<menuitem "submenu_seat_management" name="Seat Administration" action="action_seat_management" parent="file_menu_config" groups="group_seat_management_user" />
Also, don’t forget to include the xml files in the OpenERP Descriptor File.
Access Right This is how you can give read/write/create/delete rights in group on particular object by creating
ir.model.access.csv file. See line number 1 & 2.
Access Rules This is how you can create access rules for particular object and groups by creating xml file.
<record model="ir.rule" id="ir_values_my_costume_rule"> <field name="name">My Rule Name</field> <field name="model_id" ref="model_your_model_name"/> <field name="domain_force">[('field','operator','value'),('user_id','=',user.id)]</field> <field name="perm_read" eval="True"/> <field name="perm_write" eval="True"/> <field name="perm_unlink" eval="True"/> <field name="perm_create" eval="True"/> </record>
You must pass
model_ before model name in
<field name="model_id" ref="model_your_model_name"/> like this:
eval you can either pass
False as per you need.
Record Rules can be defined from the menu also without creating any file : Settings->Technical->Security->Record Rules.
There are three main fields that you need to configure carefully in order to define “Record Rule”
- Object: On which you want to apply record rule. (in this example it is “Task” object).
- Domain: Setup domain for filtering the data.
- Groups: Add group for which you want to apply this record rule. If nothing to add then this rule is apply globally which is usually used to configuring multi-company record rule.
I am going to explain such access rule by taking the example of “Task” object of OpenERP.
In my example, suppose my requirement is like this:
The user ‘rch’ can access only list of tasks of following kind…
- list of all tasks which is not assigned to any user. i.e.(‘user_id’,’=’,False)
- list of all tasks Which is assigned to user ‘rch’. i.e.(‘user_id’,’=’,user.id)
- list of all tasks of all the project’s for which he is a member of. i.e.(‘project_id.members’,’in’, [user.id])
- list of all tasks of the project for which he is a project manager. i.e.(‘project_id.user_id’,’=’,user.id)
Configure your record rule as follow:
- Name: Tasks According to User and Project.
- Object: Task.
- Domain: ['|','|','|',('user_id','=',False),('user_id','=',user.id),('project_id.members','in', [user.id]),(‘project_id.user_id’,’=’,user.id)].
- Groups: project/User.
Now add this group (project/User) to user ‘rch’.