Administrators

This module lets you limit the sections of freePBX to certain users.

Configuration

This module may not be active by default, and will say 'NOTE - AUTHTYPE is not set to 'database' in /etc/amportal.conf - Module crippled'. To enable it, you need to change AUTHTYPE in /etc/amportal.conf to 'database'. If you have already tried to add users before changing AUTHTYPE to 'database', delete them now and read the "important warning" below.

Trixbox or Asterisk@Home users have some extra work due to the Apache level authentication with the "maint" user. You will have to comment out or delete the following lines in /etc/trixbox/httpdconf/trixbox.conf for Trixbox or /etc/httpd/conf/httpd.conf for A@H for this to work:

Password protect /var/www/html/admin
<Directory /var/www/html/admin>
AuthType Basic
AuthName "Restricted Area"
AuthUserFile /usr/local/apache/passwd/wwwpasswd
Require user wwwadmin maint
</Directory>

Then you have to restart httpd (/etc/init.d/httpd restart) and possibly amportal (amportal restart) too. You should now be able to login with admin/admin and create/change users in the Administrators module. Be sure to change the admin password straight away!

Important Warning! Read before using this module
It is quite easy to lock yourself out of freePBX if you enable AUTHTYPE after you have added users. Don't do it. If you want to use this, then you must have NO USERS CREATED before you turn it on. If you don't heed this advice, and turn it on with an existing user there, then nothing you type in will let you access freePBX. You'll have to turn it back off, and then delete any existing users.

Adding a User

Enter a username and password in the General section. If this is the first user, make sure that you select 'ALL SECTIONS' in the 'Admin Access' list so you can get back in there. As soon as you add the first user, you will then be prompted for a username and password. Log in as the user you've just created.

Limiting User Access

• Department Name
  • Have been unable to find any documentation on this . Help?
• Extension Range
  • When this user is logged in, they will only see the range specified here. This is useful if you're setting up multiple tenants on the one system.
• Admin Access
  • This is a multiple-selection box. You can select a range of areas they're allowed to access by either holding down Control (or 'apple' on Mac's) and selecting individual ones, or dragging the mouse over the list of ones you want to give them access to.