doc/privileges.rst

   1 User management
   2 ===============
   3
   4 User management is the process of controlling which users are allowed to
   5 connect to the MySQL server and what permissions they have on each database.
   6 phpMyAdmin does not handle user management, rather it passes the username and
   7 password on to MySQL, which then determines whether a user is permitted to
   8 perform a particular action. Within phpMyAdmin, administrators have full
   9 control over creating users, viewing and editing privileges for existing users,
  10 and removing users.
  11
  12 Within phpMyAdmin, user management is controlled via the :guilabel:`Users` link
  13 from the main page. Users can be created, edited, and removed.
  14
  15 Creating a new user
  16 -------------------
  17
  18 To create a new user, click the :guilabel:`Add a new user` link near the bottom
  19 of the :guilabel:`Users` page (you must be a "superuser", e.g., user "root").
  20 Use the textboxes and drop-downs to configure the user to your particular
  21 needs. You can then select whether to create a database for that user and grant
  22 specific global privileges. Once you've created the user (by clicking Go), you
  23 can define that user's permissions on a specific database (don't grant global
  24 privileges in that case). In general, users do not need any global privileges
  25 (other than USAGE), only permissions for their specific database.
  26
  27 Editing an existing user
  28 ------------------------
  29
  30 To edit an existing user, simply click the pencil icon to the right of that
  31 user in the :guilabel:`Users` page. You can then edit their global- and
  32 database-specific privileges, change their password, or even copy those
  33 privileges to a new user.
  34
  35 Deleting a user
  36 ---------------
  37
  38 From the :guilabel:`Users` page, check the checkbox for the user you wish to
  39 remove, select whether or not to also remove any databases of the same name (if
  40 they exist), and click Go.
  41
  42 Assigning privileges to user for a specific database
  43 ----------------------------------------------------
  44
  45 Users are assigned to databases by editing the user record (from the
  46 :guilabel:`Users` link on the home page) not from within the :guilabel:`Users`
  47 link under the table. If you are creating a user specifically for a given table
  48 you will have to create the user first (with no global privileges) and then go
  49 back and edit that user to add the table and privileges for the individual
  50 table.
  51
  52 .. _configurablemenus:
  53
  54 Configurable menus and user groups
  55 ----------------------------------
  56
  57 By enabling :config:option:`$cfg['Servers'][$i]['usergroups']` and
  58 :config:option:`$cfg['Servers'][$i]['usergroups']` you can customize what users
  59 will see in the phpMyAdmin navigation.
  60
  61 .. warning::
  62
  63     This feature only limits what a user sees, he is still able to use all the
  64     functions. So this can not be considered as a security limitation. Should
  65     you want to limit what users can do, use MySQL privileges to achieve that.
  66
  67 With this feature enabled, the :guilabel:`User accounts` management interface gains
  68 a second tab for managing :guilabel:`User groups`, where you can define what each
  69 group will view (see image below) and you can then assign each user to one of
  70 these groups. Users will be presented with a simplified user interface, which might be
  71 useful for inexperienced users who could be overwhelmed by all the features
  72 phpMyAdmin provides.
  73
  74 .. image:: images/usergroups.png