[[PageOutline(2-5,Contents,pullout)]]

= Assign permissions and validate trac users with UNIX / Linux system groups

== Description

This is a permission system-group provider for Trac. It asks UNIX / Linux system to which groups a validated user belongs. If one of the user's groups matches a permission group name created with `TRAC_ADMIN` permission add command, these permissions are enabled for the logged-on user.

== Bugs/Feature Requests

Existing bugs and feature requests for TracSysgroupsPlugin are 
[report:9?COMPONENT=TracSysgroupsPlugin here].

If you have any issues, create a 
[/newticket?component=TracSysgroupsPlugin new ticket].

[[TicketQuery(component=TracSysgroupsPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:tracsysgroupsplugin here].

== Source

You can check out TracSysgroupsPlugin from [/svn/tracsysgroupsplugin here] using Subversion, or [source:tracsysgroupsplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Example

There is no configuration to do. After installing this plugin Trac is able to validate an authorized user 'auser' against the UNIX system group entries belonging to UNIX system user 'auser'. The benefit is that one can now create Trac groups named like system-groups and Trac will accept permissions attached to this group for a user, if the UNIX pendant of this username belongs to this group. 
This helps for example PAM users to avoid managing group permissions twice, here no autz file is needed anymore.

== Recent Changes

[[ChangeLog(tracsysgroupsplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:syspiet] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''