X-Git-Url: https://git.mdrn.pl/django-cas-provider.git/blobdiff_plain/4d4d94153a9cc19185b843502bfa76d990f1c426..087a24803f4e6749a5c32a88c62fcb922290635d:/README.rst diff --git a/README.rst b/README.rst index 0ef1742..9e922c6 100644 --- a/README.rst +++ b/README.rst @@ -5,26 +5,21 @@ django-cas-provider OVERVIEW ========= -django-cas-provider is a provider for the `Central Authentication -Service `_. It supports CAS version 1.0. It allows -remote services to authenticate users for the purposes of -Single Sign-On (SSO). For example, a user logs into a CAS server -(provided by django-cas-provider) and can then access other services -(such as email, calendar, etc) without re-entering her password for -each service. For more details, see the `CAS wiki `_ -and `Single Sign-On on Wikipedia `_. +django-cas-provider is a provider for the `Central Authentication Service `_. It supports CAS version 1.0 and parts of CAS version 2.0 protocol. It allows remote services to authenticate users for the purposes of Single Sign-On (SSO). For example, a user logs into a CAS server +(provided by django-cas-provider) and can then access other services (such as email, calendar, etc) without re-entering her password for each service. For more details, see the `CAS wiki `_ and `Single Sign-On on Wikipedia `_. INSTALLATION ============= -To install, run the following command from this directory: +To install, run the following command from this directory:: - ``python setup.py install`` + python setup.py install -Or, put cas_provider somewhere on your Python path. +Or, put `cas_provider` somewhere on your Python path. If you want use CAS v.2 protocol or above, you must install `lxml` package to correct work. + USAGE ====== @@ -120,7 +115,7 @@ Attribute formatter callback takes two arguments: * `attrs` - dictionary with user attributes received from callback specified in CAS_CUSTOM_ATTRIBUTES_CALLBACK in project settings. -Example of generated XML below: +Example of generated XML below:: @@ -133,7 +128,7 @@ Example of generated XML below: -* Name-Value style (provided in `cas_provider.attribute_formatters.name_value`): +* Name-Value style (provided in `cas_provider.attribute_formatters.name_value`):: @@ -142,7 +137,7 @@ Example of generated XML below: -* Jasig Style attributes (provided in `cas_provider.attribute_formatters.jasig`): +* Jasig Style attributes (provided in `cas_provider.attribute_formatters.jasig`):: Jasig @@ -153,7 +148,7 @@ Example of generated XML below: -* RubyCAS style (provided in `cas_provider.attribute_formatters.ruby_cas`): +* RubyCAS style (provided in `cas_provider.attribute_formatters.ruby_cas`):: RubyCAS Smith