Edgewall Software

Changes between Version 51 and Version 52 of TracPermissions


Ignore:
Timestamp:
Dec 6, 2007, 2:00:08 PM (16 years ago)
Author:
Christian Boos
Comment:

Update with 0.11/TracPermissions@10

Legend:

Unmodified
Added
Removed
Modified

  • TracPermissions

    v51 v52  
    22[[TracGuideToc]]
    33
    4 Trac uses a simple permission system to control what users can and can't access.
     4Trac uses a simple, case sensitive, permission system to control what users can and can't access.
    55
    6 Permission privileges are managed using either the [wiki:TracAdmin trac-admin] tool from the command line or the new (in version 0.11) ''Admin'' tab.
     6Permission privileges are managed using the [wiki:TracAdmin trac-admin] tool.
    77
    88Non-authenticated users accessing the system are assigned the name "anonymous". Assign permissions to the "anonymous" user to set privileges for anonymous/guest users. The parts of Trac that a user does not have the privileges for will not be displayed in the navigation.
    99In addition to these privileges, users can be granted additional individual rights in effect when authenticated and logged into the system. All logged in users belong to the virtual group "authenticated", which inherits permissions from "anonymous".
    1010
    11 == Graphical Admin Tab ==
    12 ''This feature is new in version 0.11.''
    13 
    14 To access this tab, a user must have `TRAC_ADMIN privileges`. This can be performed as follows (more on the trac-admin script below):
    15 {{{
    16   $ trac-admin /path/to/projenv permission add bob TRAC_ADMIN
    17 }}}
    18 
    19 Then, the user will be able to see the Admin tab, and can then access the permissions menu. This menu will allow you to perform all the following actions, but from the browser without requiring root access to the server (just the correct permissions for your user account).
    20 
    21  1. [[Image(admin.png)]]
    22  1. [[Image(permissions.png)]]
    23  1. [[Image(ticket_admin.png)]]
    24 
    25 
    2611== Available Privileges ==
    2712
    28 To enable all privileges for a user, use the `TRAC_ADMIN` permission. This will also give them access to the ''Admin'' tab on the browser view. Having `TRAC_ADMIN` is like being `root` on a *NIX system: it will allow you to perform any operation.
     13To enable all privileges for a user, use the `TRAC_ADMIN` permission. Having `TRAC_ADMIN` is like being `root` on a *NIX system: it will allow you to perform any operation.
    2914
    3015Otherwise, individual privileges can be assigned to users for the various different functional areas of Trac ('''note that the privilege names are case-sensitive'''):
    … …  
    4631|| `TICKET_ADMIN` || All `TICKET_*` permissions, plus the deletion of ticket attachments and modification of the description field ||
    4732
    48 Attention: the `REPORT_VIEW` permission is necessary to show the "view tickets" link.
     33Attention: the "view tickets" button appears with the `REPORT_VIEW` permission.
    4934
    5035=== Roadmap ===
    … …  
    5540|| `MILESTONE_DELETE` || Delete milestones ||
    5641|| `MILESTONE_ADMIN` || All `MILESTONE_*` permissions ||
    57 || `ROADMAP_VIEW` || View the [wiki:TracRoadmap roadmap] page ||
     42|| `ROADMAP_VIEW` || View the [wiki:TracRoadmap roadmap] page, is not (yet) the same as MILESTONE_VIEW, see #4292 ||
     43|| `ROADMAP_ADMIN` || to be removed with #3022, replaced by MILESTONE_ADMIN ||
    5844
    5945=== Reports ===
    6046
    61 || `REPORT_VIEW` || View [wiki:TracReports reports], i.e. the "view tickets" link ||
     47|| `REPORT_VIEW` || View [wiki:TracReports reports], i.e. the "view tickets" link. ||
    6248|| `REPORT_SQL_VIEW` || View the underlying SQL query of a [wiki:TracReports report] ||
    63 || `REPORT_CREATE` || Create new [wiki:TracReports reports] (Create report & save query buttons not shown)||
     49|| `REPORT_CREATE` || Create new [wiki:TracReports reports] ||
    6450|| `REPORT_MODIFY` || Modify existing [wiki:TracReports reports] ||
    6551|| `REPORT_DELETE` || Delete [wiki:TracReports reports] ||
    … …  
    7460|| `WIKI_ADMIN` || All `WIKI_*` permissions, plus the management of ''readonly'' pages. ||
    7561
     62=== Permissions ===
     63
     64|| `PERMISSION_GRANT` || add/grant a permission ||
     65|| `PERMISSION_REVOKE` || remove/revoke a permission ||
     66|| `PERMISSION_ADMIN` || All `PERMISSION_*` permissions ||
     67
     68
    7669=== Others ===
    7770
    … …  
    7972|| `SEARCH_VIEW` || View and execute [wiki:TracSearch search] queries ||
    8073|| `CONFIG_VIEW` || Enables additional pages on ''About Trac'' that show the current configuration or the list of installed plugins ||
    81 || `EMAIL_VIEW` || ??? ||
     74|| `EMAIL_VIEW` || Shows email addresses even if [wiki:0.11/TracIni `trac show_email_addresses` configuration optoin is `false`] ||
    8275
    8376== Granting Privileges ==
    … …  
    159152By default on a new Trac installation, the {{{anonymous}}} user will have ''view'' access to everything in Trac, and will also have permissions to ''create and modify tickets and wiki pages''.
    160153
     154 '''anonymous'''::
     155 BROWSER_VIEW
     156 CHANGESET_VIEW
     157 FILE_VIEW
     158 LOG_VIEW
     159 MILESTONE_VIEW
     160 REPORT_SQL_VIEW
     161 REPORT_VIEW
     162 ROADMAP_VIEW
     163 SEARCH_VIEW
     164 TICKET_VIEW
     165 TIMELINE_VIEW
     166 WIKI_VIEW
     167
     168 '''authenticated'''::
     169   TICKET_CREATE
     170 TICKET_MODIFY
     171 WIKI_CREATE
     172 WIKI_MODIFY 
     173
    161174----
    162175See also: TracAdmin, TracGuide and [http://trac.edgewall.org/wiki/FineGrainedPermissions FineGrainedPermissions]