No description
Find a file
2015-12-12 13:53:21 +01:00
cas_server Django 1.9 compatibility 2015-12-12 13:53:21 +01:00
tests Correct some tests 2015-11-20 17:38:03 +01:00
.gitignore prune .tox in manifest and gitignore dist/ 2015-12-12 13:26:08 +01:00
.travis.yml Django 1.9 compatibility 2015-12-12 13:53:21 +01:00
LICENSE Licence, readme and cie 2015-05-22 21:14:33 +02:00
MANIFEST.in prune .tox in manifest and gitignore dist/ 2015-12-12 13:26:08 +01:00
README.rst Django 1.9 compatibility 2015-12-12 13:53:21 +01:00
requirements-dev.txt Add some tests using tox 2015-06-13 00:03:06 +02:00
requirements.txt Add some tests using tox 2015-06-13 00:03:06 +02:00
setup.cfg typo in setup.cfg 2015-12-12 13:29:41 +01:00
setup.py Django 1.9 compatibility 2015-12-12 13:53:21 +01:00
tox.ini Django 1.9 compatibility 2015-12-12 13:53:21 +01:00

=====
CAS Server
=====

CAS Server is a Django app implementing the `CAS Protocol 3.0 Specification
<https://jasig.github.io/cas/development/protocol/CAS-Protocol-Specification.html>`_.

By defaut, the authentication process use django internal users but you can easily
use any sources (see auth classes in the auth.py file)

The differents parametters you can use in settings.py to tweak the application
are listed in default_settings.py

The defaut login/logout template use `django-bootstrap3 <https://github.com/dyve/django-bootstrap3>`_
but you can use your own templates using the CAS_LOGIN_TEMPLATE,
CAS_LOGGED_TEMPLATE, CAS_WARN_TEMPLATE and CAS_LOGOUT_TEMPLATEsetting variables.

Quick start
-----------

1. Add "cas_server" to your INSTALLED_APPS setting like this::

    INSTALLED_APPS = (
        ...
        'bootstrap3',
        'cas_server',
    )

   For internatinalization support, add "django.middleware.locale.LocaleMiddleware"
   to your MIDDLEWARE_CLASSES setting like this::

    MIDDLEWARE_CLASSES = (
        ...
        'django.middleware.locale.LocaleMiddleware',
        ...
    )

2. Include the polls URLconf in your project urls.py like this::

    url(r'^cas/', include('cas_server.urls', namespace="cas_server")),

3. Run `python manage.py migrate` to create the cas_server models.

4. Start the development server and visit http://127.0.0.1:8000/admin/
   to add a first service allowed to authenticate user agains the CAS
   (you'll need the Admin app enabled).

5. Visit http://127.0.0.1:8000/cas/ to login with your django users.