privileges.html 9.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8" />
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  6. <title>User management &#8212; phpMyAdmin 4.9.10 documentation</title>
  7. <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
  8. <link rel="stylesheet" href="_static/classic.css" type="text/css" />
  9. <script id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
  10. <script src="_static/jquery.js"></script>
  11. <script src="_static/underscore.js"></script>
  12. <script src="_static/doctools.js"></script>
  13. <link rel="index" title="Index" href="genindex.html" />
  14. <link rel="search" title="Search" href="search.html" />
  15. <link rel="copyright" title="Copyright" href="copyright.html" />
  16. <link rel="next" title="Relations" href="relations.html" />
  17. <link rel="prev" title="Bookmarks" href="bookmarks.html" />
  18. </head><body>
  19. <div class="related" role="navigation" aria-label="related navigation">
  20. <h3>Navigation</h3>
  21. <ul>
  22. <li class="right" style="margin-right: 10px">
  23. <a href="genindex.html" title="General Index"
  24. accesskey="I">index</a></li>
  25. <li class="right" >
  26. <a href="relations.html" title="Relations"
  27. accesskey="N">next</a> |</li>
  28. <li class="right" >
  29. <a href="bookmarks.html" title="Bookmarks"
  30. accesskey="P">previous</a> |</li>
  31. <li class="nav-item nav-item-0"><a href="index.html">phpMyAdmin 4.9.10 documentation</a> &#187;</li>
  32. <li class="nav-item nav-item-1"><a href="user.html" accesskey="U">User Guide</a> &#187;</li>
  33. <li class="nav-item nav-item-this"><a href="">User management</a></li>
  34. </ul>
  35. </div>
  36. <div class="document">
  37. <div class="documentwrapper">
  38. <div class="bodywrapper">
  39. <div class="body" role="main">
  40. <div class="section" id="user-management">
  41. <h1>User management<a class="headerlink" href="#user-management" title="Permalink to this headline">¶</a></h1>
  42. <p>User management is the process of controlling which users are allowed to
  43. connect to the MySQL server and what permissions they have on each database.
  44. phpMyAdmin does not handle user management, rather it passes the username and
  45. password on to MySQL, which then determines whether a user is permitted to
  46. perform a particular action. Within phpMyAdmin, administrators have full
  47. control over creating users, viewing and editing privileges for existing users,
  48. and removing users.</p>
  49. <p>Within phpMyAdmin, user management is controlled via the <span class="guilabel">Users</span> link
  50. from the main page. Users can be created, edited, and removed.</p>
  51. <div class="section" id="creating-a-new-user">
  52. <h2>Creating a new user<a class="headerlink" href="#creating-a-new-user" title="Permalink to this headline">¶</a></h2>
  53. <p>To create a new user, click the <span class="guilabel">Add a new user</span> link near the bottom
  54. of the <span class="guilabel">Users</span> page (you must be a “superuser”, e.g., user “root”).
  55. Use the textboxes and drop-downs to configure the user to your particular
  56. needs. You can then select whether to create a database for that user and grant
  57. specific global privileges. Once you’ve created the user (by clicking Go), you
  58. can define that user’s permissions on a specific database (don’t grant global
  59. privileges in that case). In general, users do not need any global privileges
  60. (other than USAGE), only permissions for their specific database.</p>
  61. </div>
  62. <div class="section" id="editing-an-existing-user">
  63. <h2>Editing an existing user<a class="headerlink" href="#editing-an-existing-user" title="Permalink to this headline">¶</a></h2>
  64. <p>To edit an existing user, simply click the pencil icon to the right of that
  65. user in the <span class="guilabel">Users</span> page. You can then edit their global- and
  66. database-specific privileges, change their password, or even copy those
  67. privileges to a new user.</p>
  68. </div>
  69. <div class="section" id="deleting-a-user">
  70. <h2>Deleting a user<a class="headerlink" href="#deleting-a-user" title="Permalink to this headline">¶</a></h2>
  71. <p>From the <span class="guilabel">Users</span> page, check the checkbox for the user you wish to
  72. remove, select whether or not to also remove any databases of the same name (if
  73. they exist), and click Go.</p>
  74. </div>
  75. <div class="section" id="assigning-privileges-to-user-for-a-specific-database">
  76. <h2>Assigning privileges to user for a specific database<a class="headerlink" href="#assigning-privileges-to-user-for-a-specific-database" title="Permalink to this headline">¶</a></h2>
  77. <p>Users are assigned to databases by editing the user record (from the
  78. <span class="guilabel">User accounts</span> link on the home page).
  79. If you are creating a user specifically for a given table
  80. you will have to create the user first (with no global privileges) and then go
  81. back and edit that user to add the table and privileges for the individual
  82. table.</p>
  83. </div>
  84. <div class="section" id="configurable-menus-and-user-groups">
  85. <span id="configurablemenus"></span><h2>Configurable menus and user groups<a class="headerlink" href="#configurable-menus-and-user-groups" title="Permalink to this headline">¶</a></h2>
  86. <p>By enabling <span class="target" id="index-0"></span><a class="reference internal" href="config.html#cfg_Servers_usergroups"><code class="xref config config-option docutils literal notranslate"><span class="pre">$cfg['Servers'][$i]['usergroups']</span></code></a> and
  87. <span class="target" id="index-1"></span><a class="reference internal" href="config.html#cfg_Servers_usergroups"><code class="xref config config-option docutils literal notranslate"><span class="pre">$cfg['Servers'][$i]['usergroups']</span></code></a> you can customize what users
  88. will see in the phpMyAdmin navigation.</p>
  89. <div class="admonition warning">
  90. <p class="admonition-title">Warning</p>
  91. <p>This feature only limits what a user sees, he is still able to use all the
  92. functions. So this can not be considered as a security limitation. Should
  93. you want to limit what users can do, use MySQL privileges to achieve that.</p>
  94. </div>
  95. <p>With this feature enabled, the <span class="guilabel">User accounts</span> management interface gains
  96. a second tab for managing <span class="guilabel">User groups</span>, where you can define what each
  97. group will view (see image below) and you can then assign each user to one of
  98. these groups. Users will be presented with a simplified user interface, which might be
  99. useful for inexperienced users who could be overwhelmed by all the features
  100. phpMyAdmin provides.</p>
  101. <img alt="_images/usergroups.png" src="_images/usergroups.png" />
  102. </div>
  103. </div>
  104. <div class="clearer"></div>
  105. </div>
  106. </div>
  107. </div>
  108. <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
  109. <div class="sphinxsidebarwrapper">
  110. <h3><a href="index.html">Table of Contents</a></h3>
  111. <ul>
  112. <li><a class="reference internal" href="#">User management</a><ul>
  113. <li><a class="reference internal" href="#creating-a-new-user">Creating a new user</a></li>
  114. <li><a class="reference internal" href="#editing-an-existing-user">Editing an existing user</a></li>
  115. <li><a class="reference internal" href="#deleting-a-user">Deleting a user</a></li>
  116. <li><a class="reference internal" href="#assigning-privileges-to-user-for-a-specific-database">Assigning privileges to user for a specific database</a></li>
  117. <li><a class="reference internal" href="#configurable-menus-and-user-groups">Configurable menus and user groups</a></li>
  118. </ul>
  119. </li>
  120. </ul>
  121. <h4>Previous topic</h4>
  122. <p class="topless"><a href="bookmarks.html"
  123. title="previous chapter">Bookmarks</a></p>
  124. <h4>Next topic</h4>
  125. <p class="topless"><a href="relations.html"
  126. title="next chapter">Relations</a></p>
  127. <div role="note" aria-label="source link">
  128. <h3>This Page</h3>
  129. <ul class="this-page-menu">
  130. <li><a href="_sources/privileges.rst.txt"
  131. rel="nofollow">Show Source</a></li>
  132. </ul>
  133. </div>
  134. <div id="searchbox" style="display: none" role="search">
  135. <h3 id="searchlabel">Quick search</h3>
  136. <div class="searchformwrapper">
  137. <form class="search" action="search.html" method="get">
  138. <input type="text" name="q" aria-labelledby="searchlabel" />
  139. <input type="submit" value="Go" />
  140. </form>
  141. </div>
  142. </div>
  143. <script>$('#searchbox').show(0);</script>
  144. </div>
  145. </div>
  146. <div class="clearer"></div>
  147. </div>
  148. <div class="related" role="navigation" aria-label="related navigation">
  149. <h3>Navigation</h3>
  150. <ul>
  151. <li class="right" style="margin-right: 10px">
  152. <a href="genindex.html" title="General Index"
  153. >index</a></li>
  154. <li class="right" >
  155. <a href="relations.html" title="Relations"
  156. >next</a> |</li>
  157. <li class="right" >
  158. <a href="bookmarks.html" title="Bookmarks"
  159. >previous</a> |</li>
  160. <li class="nav-item nav-item-0"><a href="index.html">phpMyAdmin 4.9.10 documentation</a> &#187;</li>
  161. <li class="nav-item nav-item-1"><a href="user.html" >User Guide</a> &#187;</li>
  162. <li class="nav-item nav-item-this"><a href="">User management</a></li>
  163. </ul>
  164. </div>
  165. <div class="footer" role="contentinfo">
  166. &#169; <a href="copyright.html">Copyright</a> 2012 - 2018, The phpMyAdmin devel team.
  167. Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.4.3.
  168. </div>
  169. </body>
  170. </html>