Funnelback logo

Documentation

Administration users

Introduction

Funnelback provides the ability to partition a Funnelback installation to allow individual people to manage their own collections.

Special Note for IIS users: When using IIS, the Funnelback user system interacts with the Windows user system. See the section below on creating users for more details.

Upon installation, an administrator user is created to manage all collections, and this user has the ability to create other system users and allocate security permissions (or actions) that they can perform on all, or a sub-set of the collections.

Although this may not be necessary in most installations, there may be opportunities to use this feature to:

  • Create a user for a web-designer to upload and download search forms; or
  • Allow managers to view query reports (and nothing else).

User types

Administrator users
can create and manage collections and create or modify users of Funnelback.
Normal users
may be permitted to edit, update and/or view reports for some of all collections.

User permissions

What a user can (and can't do) is determined by the settings in their configuration files (though they would not normally be edited directly): the system-wide defaults and and the settings in the user's own configuration file that override the system default file.

Managing users

User list

The control-panel link Manage users lists the current system users:

Admin-users-list.png

You can:

Creating and editing users

The only mandatory field for a user is their ID.

Special Note for IIS users: To work correctly under the Internet Information Services (IIS) web server, each Funnelback user that is created must have a corresponding Windows user of the same name. To ensure this, please create a windows user with the same name (as the User ID field on this page) using the standard tools available with Windows. One way to do this is to go to the Control Panel -> Administrative Tools -> Computer Management window, and add a user to the 'Local Users and Groups -> Users' folder that will be visible there. This can be done either before or after completing the form on this page, but must be performed before logging in under the new account. Please note that if you are creating an account for a Windows domain user then the User ID field on this page must contain the domain identifier (e.g. MYDOMAIN\myuser) and that if this is a new Windows account, it must be created on the relevant domain controller and not the local machine.

Admin-users-create.png

  • Username (valid characters are alphanumerics, plus underscores and dashes, a backslash is allowed to seperate a windows domain and username. e.g. MYDOMAIN\myuser);
  • Full name (informational only);
  • Email (informational only);
  • Organisation (informational only);
  • Contact info (informational only);

Allowed collections

Check the collections you want this user to manage, or select the 'All collections' radio button to allow all collections.

User type

The user type specifies what actions the user can perform within Funnelback.

Administrator users are allowed to perform any possible action, including changing user permissions and creating new collections.

Normal users have three available roles which may be granted :

  • "Edit search interface" allows the user to manage collection form files and best bets.
  • "Manage collections" allows the user to adjust Funnelback's update schedule and initiate manual collection updates.
  • "View collection reports" allows the user to view collection query and data reports.

Advanced configuration users are those which have been customised by directly editing the user's configuration file. This feature allows for fine grained control over the users individual permissions.

Example User - Web Designer

For example, you might wish to create an administrator user for a web designer who will be working with the web forms for your Funnelback installation. In this case you would:

  1. From the administration home page click on the "Manage users" link
  2. Click on "Create a new user" to go to the user creation page
  3. Fill in the users details
  4. In the "Permissions" section select which collections they can access
  5. Make them a "Normal user" and then select only the "Edit search interface" role
  6. Save the user and enter a password for them
  7. Shut down your web browser and login to the Funnelback administration interface as the new user to confirm that they can only access the relevant collections and can only edit forms

A similar approach could be used to create an administrator user who could only view reports.

See also

top ⇑