Mikael Nordfeldth c00491cd7a Cosmetic changes to common_redirect, clientError, serverError 10 years ago
..
actions c00491cd7a Cosmetic changes to common_redirect, clientError, serverError 10 years ago
extlib 6b4607f073 Upgrade from CAS 1.1.0RC6 to 1.1.2 13 years ago
locale 51b28eda19 Localisation updates from http://translatewiki.net. 11 years ago
CasAuthenticationPlugin.php f110fc5c9a Using GNUSOCIAL_VERSION instead of STATUSNET_VERSION 10 years ago
README c0e4d7bfa2 Add 'takeOverLogin' parameter for a real SSO feel 14 years ago

README

The CAS Authentication plugin allows for StatusNet to handle authentication
through CAS (Central Authentication Service).

Installation
============
add "addPlugin('casAuthentication',
array('setting'=>'value', 'setting2'=>'value2', ...);"
to the bottom of your config.php

Settings
========
provider_name*: a unique name for this authentication provider.
authoritative (false): Set to true if CAS's responses are authoritative
(if authorative and CAS fails, no other password checking will be done).
autoregistration (false): Set to true if users should be automatically created
when they attempt to login.
email_changeable (true): Are users allowed to change their email address?
(true or false)
password_changeable*: must be set to false. This plugin does not support changing passwords.

server*: CAS server to authentication against
port (443): Port the CAS server listens on. Almost always 443
path (): Path on the server to CAS. Usually blank.
takeOverLogin (false): Take over the main login action. If takeOverLogin is
set, anytime the standard username/password login form would be shown,
a CAS login will be done instead.

* required
default values are in (parenthesis)

Example
=======
addPlugin('casAuthentication', array(
'provider_name'=>'Example',
'authoritative'=>true,
'autoregistration'=>true,
'server'=>'sso-cas.univ-rennes1.fr',
'port'=>443,
'path'=>'',
'takeOverLogin'=>true
));