Chapter 7. Users Management and ACLs

Table of Contents

Users
Groups
Root ACL
ACL

searchbox has as default a basic user and groups management capability and can assign to every object it manage (Sources, Archives, etc.) an ACL list. Every user or group has can have its own private data and can share it with other users or groups defined into the system through the ACL mechanism.

The user management section is accessible by any user who has administration privileges from the User and security menu item.

Figure 7.1. The User and Security menu item

The User and Security menu item

The popup window shows the following tabs:

Figure 7.2. Available tabs of the security window

Available tabs of the security window

Users

From this tab new users can be added to searchbox. With the Administration privileges checkbox checked the user can modify every object of the current searchbox Engine instance.

Figure 7.3. New user window

New user window

Any user can be optionally joined to an existing group (testgroup in the above example). In this case such user inherit all privileges granted for that group.

Groups

From this tab new groups can be added to searchbox.

Figure 7.4. New group window

New group window

Root ACL

Root ACL are basic permissions that are given to users and groups about the creation and configuration of searchbox objects. These ACLs can be of three types:

  • Browsing ACL - Specifies the Browsing root ACL. This ACL controls the rights to enumerate users and groups, and create new collections and watches.

  • Gathering ACL - Specifies the Crawling root ACL. This ACL controls the rights to create new sources and archives.

  • Processing ACL - Specifies the Processing root ACL. This ACL controls the rights to create new metadata templates.

In the following table for all possible status of Read/Write flags of each ACL type the list of involved objects and the related types of actions are shown.

Table 7.1. Root ACL schema

 ACLSourcesArchivesCollectionsWatchesTemplates
RWadd/del/editviewadd/del/editviewadd/del/editviewadd/del/editviewadd/del/editview
GatheringDenyDenynononono------
AllowAllowyesyesyesyes------
AllowDenynoyesnoyes------
BrowsingDenyDeny----nononono--
AllowAllow----yesyesyesyes--
AllowDeny----noyesnoyes--
ProcessingDenyDeny--------nono
AllowAllow--------yesyes
AllowDeny--------noyes

Note

The above root ACLs does not take into account the dependences between objects because the actual possibility to view/edit behaviours of an object depends also from the ACLs of other object from wich it is connected to (i.e. It is not possible to create an Archive associated to a Source if we does not have read permissions on it).

Selecting one of the Root ACL tabs the following configuration window will be shown.

Figure 7.5. The Root ACL access window

The Root ACL access window

The accessing rules for each user or group added to Users or Groups list are configured checking the corresponding checkboxes in the Access section.

Once a searchbox object is created the owner can assign to it a specific ACL to let other users to operate on it.

ACL

Each searchbox object has its own ACL list that can be configured through the ACL tab of the configuration panel.

Figure 7.6. The ACL Tab

The ACL Tab

As shown in the above picture all objects have associated their own list of users and/or groups with the corresponding access permission (read/write). The configuration panel is the same of Root ACL.