Changes between Version 13 and Version 14 of SharedCookieAuthPlugin


Ignore:
Timestamp:
Nov 27, 2015, 3:41:26 PM (8 years ago)
Author:
Ryan J Ollos
Comment:

Adapt documentation to change in #12592.

Legend:

Unmodified
Added
Removed
Modified
  • SharedCookieAuthPlugin

    v13 v14  
    44
    55This plugin allows cookies to be shared among Trac environments that reside in the same directory, enabling Single-Sign-On to a collection of Trac sites.
    6 
    7 **Note**: This plugin inspired a native Single-Sign-On functionality in AccountManagerPlugin, which is available since acct_mgr-0.4 and even solves some of the shortcomings of this plugin. Most importantly login/logout works from any Trac environment sharing identical cookie path settings.
    86
    97== Bugs/Feature Requests
     
    3129== Configuration
    3230
    33 You will need to select one of the project to be the master, and thus responsible for authentication. The other (slave) projects should be configured to pass the authenticate request onto the master project. This is to avoid Trac expiring the `auth_cookie` when the login is made in another project. Unfortunately this means that login and logout can only be made in the master project.
    34 
    35 The slave project will have `LoginModule` disabled and `sharedcookieauth` enabled:
     31Enable `sharedcookieauth` and set the `auth_cookie_path` in every environment that you wish to share authentication. This can be done using a [TracIni#GlobalConfiguration shared configuration].
    3632{{{#!ini
    3733[components]
    3834sharedcookieauth.* = enabled
    39 trac.web.auth.LoginModule = disabled
    4035
    4136[trac]
    4237auth_cookie_path = /
    4338}}}
    44 
    45 The master project will have both `LoginModule` and `sharedcookieauth` enabled:
    46 {{{#!ini
    47 [components]
    48 sharedcookieauth.* = enabled
    49 trac.web.auth.LoginModule = enabled
    50 
    51 [trac]
    52 auth_cookie_path = /
    53 }}}
    54 
    55 In practice `sharedcookieauth` does not need to be enabled in the master project, but neither should it cause any harm. Also be aware that the server name must match for each project or the browser will not share the `auth_cookie` among projects.
    5639
    5740== Recent Changes