= `CoSign` single sign-on integration for Trac =

== Description ==

This plugin is inspired from TracCasPlugin.  Adapt to use `CoSign single sign-on`__ as the authentication back-end.

__ http://weblogin.org/


== Bugs/Feature Requests == 

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TracCoSignPlugin&owner=jiangxin new ticket].

== Download ==

Download the zipped source from [download:traccosignplugin here].

== Source ==

You can check out TracCoSignPlugin from [http://trac-hacks.org/svn/traccosignplugin here] using Subversion, or [source:traccosignplugin browse the source] with Trac.


== Usage ==
=== The [components] section ===
To enable the plugin:
{{{
[components]
traccosign.* = enabled
trac.web.auth.LoginModule = disabled
}}}

'''note''': Even if installing locally, you must disable the default `LoginModule`.

=== The [cosign] section ===
Options in the ``[cosign]`` section:
 * '''server''': **required**
    The base URL of the `CoSign` server.
 * '''service''':
    **Requried** if do not use `CoSign` filter doing redirect.
 * '''login_path''':
    Relative path to the login service. Defaults to ``/cgi-bin/login``.
 * '''logout_path''':
    Relative path to the logout service. Defaults to ``/cgi-bin/logout``.

=== Example ===
An example configuration:
{{{
[components]
traccosign.* = enabled
trac.web.auth.LoginModule = disabled

[cosign]
server = https://weblogin.localdomain/
service = trac
login_path = /cgi-bin/login
logout_path = /cgi-bin/logout
}}}

== Recent Changes ==

[[ChangeLog(traccosignplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:jiangxin] [[BR]]
'''Contributors:'''