Metadata-Version: 1.0
Name: django-auth-pubtkt
Version: 1.0.0
Summary: Implementation of mod_auth_pubtkt as Django middleware
Home-page: https://github.com/Baguage/django-auth-pubtkt
Author: Alexander Vyushkov
Author-email: alex.vyushkov@gmail.com
License: BSD
Description: ==================================================
        django-auth-pubtkt
        ==================================================
        Author: Alexander Vyushkov
        
        Implementation of mod_auth_pubtkt: a pragmatic Web Single Sign-On (SSO) solution as Django middleware.
        This version was tested on Python == 2.7, Django == 1.5
        
        Please refer to https://neon1.net/mod_auth_pubtkt/index.html for additional details.
         
        ==================================================
        Installation:
        ==================================================
        django-auth-pubtkt uses M2Crypto library. Installation instructions for
        different platforms are below.
        When M2Crypto is installed, django-auth-pubtkt can be installed using pip
        pip install django-auth-pubtkt
        or using setuptools
        ./setup.py install
        
        Windows
        ==================================================
        Use binary package available on http://chandlerproject.org/Projects/MeTooCrypto#Downloads
        
        CentOS/RedHat/Fedora
        ==================================================
        Fedora Core (and RedHat, CentOS etc.) have made changes to OpenSSL
        configuration compared to many other Linux distributions. If you can not
        build M2Crypto normally, try the fedora_setup.sh script included with
        M2Crypto sources.
        
        pip install --download=/tmp M2Crypto
        cd /tmp
        tar -zxf /tmp/M2Crypto-0.21.1.tar.gz
        cd M2Crypto-0.21.1
        ./fedora_setup.sh install
        
        ==================================================
        Configuration
        ==================================================
        Add 'django_auth_pubtkt.DjangoAuthPubtkt' to MIDDLEWARE_CLASSES
        Change LOGIN_URL to "/sso/"
        Set TKT_AUTH_LOGIN_URL to the address of SSO login page
        Add piece of code below to urls.py
        from django_auth_pubtkt.views import redirect_to_sso
        url('^sso/', redirect_to_sso),
        
        OR
        Change LOGIN_URL to the address of SSO login page
        Configure your SSO to use 'next' as redirect field name
        or
        use @method_decorator(login_required(redirect_field_name="back"))
        
        Configuration variables (settings.py)
        
        TKT_AUTH_PUBLIC_KEY
        Default: None
        Filename of DSA public key in .pem format. It is used to verify ticket signature.
        
        TKT_AUTH_COOKIE_NAME
        Default: "auth_pubtkt"
        Name of the authentication cookie to use.
        
        TKT_AUTH_USE_GROUPS
        Default: False
        Treat tokens as group names. Create groups if they don't exist yet.
        
        TKT_AUTH_LOGIN_URL
        Default: None
        URL that users without a valid ticket will be redirected to
        
        TKT_AUTH_BACK_ARG_NAME
        Default: "back"
        Name of the GET argument with the originally requested URL (when redirecting to the login page)
        
Keywords: django auth mod_auth_pubtkt
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python
Classifier: Framework :: Django
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: Apache Software License
