Update README and setup.py
This commit is contained in:
		
							
								
								
									
										37
									
								
								README.rst
									
									
									
									
									
								
							
							
						
						
									
										37
									
								
								README.rst
									
									
									
									
									
								
							@@ -7,18 +7,26 @@ CAS Server
 | 
				
			|||||||
.. image:: https://travis-ci.org/nitmir/django-cas-server.svg?branch=master
 | 
					.. image:: https://travis-ci.org/nitmir/django-cas-server.svg?branch=master
 | 
				
			||||||
    :target: https://travis-ci.org/nitmir/django-cas-server
 | 
					    :target: https://travis-ci.org/nitmir/django-cas-server
 | 
				
			||||||
 | 
					
 | 
				
			||||||
CAS Server is a Django app implementing the `CAS Protocol 3.0 Specification
 | 
					CAS Server is a Django application implementing the `CAS Protocol 3.0 Specification
 | 
				
			||||||
<https://jasig.github.io/cas/development/protocol/CAS-Protocol-Specification.html>`_.
 | 
					<https://jasig.github.io/cas/development/protocol/CAS-Protocol-Specification.html>`_.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
By defaut, the authentication process use django internal users but you can easily
 | 
					By defaut, the authentication process use django internal users but you can easily
 | 
				
			||||||
use any sources (see auth classes in the auth.py file)
 | 
					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>`_
 | 
					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,
 | 
					but you can use your own templates using settings variables.
 | 
				
			||||||
CAS_LOGGED_TEMPLATE, CAS_WARN_TEMPLATE and CAS_LOGOUT_TEMPLATE setting variables.
 | 
					
 | 
				
			||||||
 | 
					Features
 | 
				
			||||||
 | 
					--------
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					* Support CAS version 1.0, 2.0, 3.0
 | 
				
			||||||
 | 
					* Support Single Sign Out
 | 
				
			||||||
 | 
					* Configuration of services via the django Admin application
 | 
				
			||||||
 | 
					* Fine control on which user's attributes are passed to which service
 | 
				
			||||||
 | 
					* Possibility to rename/rewrite attributes per service
 | 
				
			||||||
 | 
					* Possibility to require some attribute values per service
 | 
				
			||||||
 | 
					* Supports Django 1.7, 1.8 and 1.9
 | 
				
			||||||
 | 
					* Supports Python 2.7, 3.x
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Quick start
 | 
					Quick start
 | 
				
			||||||
-----------
 | 
					-----------
 | 
				
			||||||
@@ -26,6 +34,7 @@ Quick start
 | 
				
			|||||||
1. Add "cas_server" to your INSTALLED_APPS setting like this::
 | 
					1. Add "cas_server" to your INSTALLED_APPS setting like this::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    INSTALLED_APPS = (
 | 
					    INSTALLED_APPS = (
 | 
				
			||||||
 | 
					        'django.contrib.admin',
 | 
				
			||||||
        ...
 | 
					        ...
 | 
				
			||||||
        'bootstrap3',
 | 
					        'bootstrap3',
 | 
				
			||||||
        'cas_server',
 | 
					        'cas_server',
 | 
				
			||||||
@@ -40,9 +49,13 @@ Quick start
 | 
				
			|||||||
        ...
 | 
					        ...
 | 
				
			||||||
    )
 | 
					    )
 | 
				
			||||||
 | 
					
 | 
				
			||||||
2. Include the polls URLconf in your project urls.py like this::
 | 
					2. Include the cas_server URLconf in your project urls.py like this::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    url(r'^cas/', include('cas_server.urls', namespace="cas_server")),
 | 
					    urlpatterns = [
 | 
				
			||||||
 | 
					        url(r'^admin/', admin.site.urls),
 | 
				
			||||||
 | 
					        ...
 | 
				
			||||||
 | 
					        url(r'^cas/', include('cas_server.urls', namespace="cas_server")),
 | 
				
			||||||
 | 
					    ]
 | 
				
			||||||
 | 
					
 | 
				
			||||||
3. Run `python manage.py migrate` to create the cas_server models.
 | 
					3. Run `python manage.py migrate` to create the cas_server models.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -130,7 +143,7 @@ Mysql backend settings. Only usefull is you use the mysql authentication backend
 | 
				
			|||||||
* ``CAS_SQL_DBCHARSET``: Database charset. The default is ``"utf8"``
 | 
					* ``CAS_SQL_DBCHARSET``: Database charset. The default is ``"utf8"``
 | 
				
			||||||
* ``CAS_SQL_USER_QUERY``: The query performed upon user authentication.
 | 
					* ``CAS_SQL_USER_QUERY``: The query performed upon user authentication.
 | 
				
			||||||
  The username must be in field ``username``, the password in ``password``,
 | 
					  The username must be in field ``username``, the password in ``password``,
 | 
				
			||||||
  additional fields are used as the user attributs.
 | 
					  additional fields are used as the user attributes.
 | 
				
			||||||
  The default is ``"SELECT user AS usersame, pass AS password, users.* FROM users WHERE user = %s"``
 | 
					  The default is ``"SELECT user AS usersame, pass AS password, users.* FROM users WHERE user = %s"``
 | 
				
			||||||
* ``CAS_SQL_PASSWORD_CHECK``: The method used to check the user password. Must be
 | 
					* ``CAS_SQL_PASSWORD_CHECK``: The method used to check the user password. Must be
 | 
				
			||||||
  ``"crypt"`` or ``"plain``". The default is ``"crypt"``.
 | 
					  ``"crypt"`` or ``"plain``". The default is ``"crypt"``.
 | 
				
			||||||
@@ -142,8 +155,8 @@ Authentication backend
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
* dummy backend ``cas_server.auth.DummyAuthUser``: all authentication attempt fails.
 | 
					* dummy backend ``cas_server.auth.DummyAuthUser``: all authentication attempt fails.
 | 
				
			||||||
* test backend ``cas_server.auth.TestAuthUser``: username is ``test`` and password is ``test``
 | 
					* test backend ``cas_server.auth.TestAuthUser``: username is ``test`` and password is ``test``
 | 
				
			||||||
  the returned attributs for the user are: ``{'nom': 'Nymous', 'prenom': 'Ano', 'email': 'anonymous@example.net'}``
 | 
					  the returned attributes for the user are: ``{'nom': 'Nymous', 'prenom': 'Ano', 'email': 'anonymous@example.net'}``
 | 
				
			||||||
* django backend ``cas_server.auth.DjangoAuthUser``: Users are anthenticated agains django users system.
 | 
					* django backend ``cas_server.auth.DjangoAuthUser``: Users are anthenticated agains django users system.
 | 
				
			||||||
  This is the default backend. The returned attributs are the fields available on the user model.
 | 
					  This is the default backend. The returned attributes are the fields available on the user model.
 | 
				
			||||||
* mysql backend ``cas_server.auth.MysqlAuthUser``: see the 'Mysql backend settings' section.
 | 
					* mysql backend ``cas_server.auth.MysqlAuthUser``: see the 'Mysql backend settings' section.
 | 
				
			||||||
  The returned attributs are those return by sql query ``CAS_SQL_USER_QUERY``.
 | 
					  The returned attributes are those return by sql query ``CAS_SQL_USER_QUERY``.
 | 
				
			||||||
 
 | 
				
			|||||||
							
								
								
									
										16
									
								
								setup.py
									
									
									
									
									
								
							
							
						
						
									
										16
									
								
								setup.py
									
									
									
									
									
								
							@@ -10,10 +10,16 @@ os.chdir(os.path.normpath(os.path.join(os.path.abspath(__file__), os.pardir)))
 | 
				
			|||||||
setup(
 | 
					setup(
 | 
				
			||||||
    name='django-cas-server',
 | 
					    name='django-cas-server',
 | 
				
			||||||
    version='0.3.4',
 | 
					    version='0.3.4',
 | 
				
			||||||
    packages=['cas_server', 'cas_server.migrations', 'cas_server.management', 'cas_server.management.commands'],
 | 
					    packages=[
 | 
				
			||||||
 | 
					        'cas_server', 'cas_server.migrations',
 | 
				
			||||||
 | 
					        'cas_server.management', 'cas_server.management.commands'
 | 
				
			||||||
 | 
					    ],
 | 
				
			||||||
    include_package_data=True,
 | 
					    include_package_data=True,
 | 
				
			||||||
    license='GPLv3',
 | 
					    license='GPLv3',
 | 
				
			||||||
    description='A Django app implementing the CAS Protocol 3.0 Specification',
 | 
					    description=(
 | 
				
			||||||
 | 
					        'A Django Central Authentication Service server '
 | 
				
			||||||
 | 
					       'implementing the CAS Protocol 3.0 Specification'
 | 
				
			||||||
 | 
					    ),
 | 
				
			||||||
    long_description=README,
 | 
					    long_description=README,
 | 
				
			||||||
    author='Valentin Samir',
 | 
					    author='Valentin Samir',
 | 
				
			||||||
    author_email='valentin.samir@crans.org',
 | 
					    author_email='valentin.samir@crans.org',
 | 
				
			||||||
@@ -37,8 +43,10 @@ setup(
 | 
				
			|||||||
        ]
 | 
					        ]
 | 
				
			||||||
    },
 | 
					    },
 | 
				
			||||||
    keywords=['django', 'cas', 'cas3', 'server', 'sso', 'single sign-on', 'authentication', 'auth'],
 | 
					    keywords=['django', 'cas', 'cas3', 'server', 'sso', 'single sign-on', 'authentication', 'auth'],
 | 
				
			||||||
    install_requires=['Django >= 1.7,<1.10', 'requests >= 2.4', 'requests_futures >= 0.9.5',
 | 
					    install_requires=[
 | 
				
			||||||
        'django-picklefield >= 0.3.1', 'django-bootstrap3 >= 5.4', 'lxml >= 3.4'],
 | 
					        'Django >= 1.7,<1.10', 'requests >= 2.4', 'requests_futures >= 0.9.5',
 | 
				
			||||||
 | 
					        'django-picklefield >= 0.3.1', 'django-bootstrap3 >= 5.4', 'lxml >= 3.4'
 | 
				
			||||||
 | 
					    ],
 | 
				
			||||||
    url="https://github.com/nitmir/django-cas-server",
 | 
					    url="https://github.com/nitmir/django-cas-server",
 | 
				
			||||||
    download_url="https://github.com/nitmir/django-cas-server/releases",
 | 
					    download_url="https://github.com/nitmir/django-cas-server/releases",
 | 
				
			||||||
    zip_safe=False
 | 
					    zip_safe=False
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user