/django-freshdesk

Single Sign On compatibility between django and freshdesk

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Django Freshdesk

https://secure.travis-ci.org/ThatGreenSpace/django-freshdesk.png?branch=master https://coveralls.io/repos/ThatGreenSpace/django-freshdesk/badge.png?branch=master https://badge.fury.io/py/django-freshdesk.png https://pypip.in/d/django-freshdesk/badge.png

Single Sign-On functionallity between Django and Freshdesk.

The Freshdesk documentation for Single Sign-On is located at Freshdesk documentation

How to use

Get the code

Getting the code for the latest stable release using pip:

$ pip install django-freshdesk

You can also download the source and run:

$ python setup.py install

Add the application to the project settings

Make sure that .django.contrib.auth' is installed and then add register 'freshdesk' in the 'INSTALLED_APPS' section of your project's settings

INSTALLED_APPS = (
    ...
    'django.contrib.auth',
    'freshdesk',
)

Setup the settings variables

You must specify two settings variables in your settings module.

  • The URL of your support page, will either a subdomain in freshdesk.com or your own domain (using a CNAME record)
FRESHDESK_URL = 'http://yourcompany.freshdesk.com/'
  • The shared secret you get from Freshdesk when setting up Simple SSO
FRESHDESK_SECRET_KEY = '098f6bcd4621d373cade4e832627b4f6'

Register the urls

Add the application urls to your urlconf

urlpatterns = patterns('',
    ...
    url(r'^login/sso/', include('freshdesk.urls')),
)

Requirements

  • Python 2.7, 3.2, 3.3 or 3.4
  • Django >= 1.5

Bugs and requests

If you have found a bug or or you have a ny request, please use the issue tracker on GitHub.

https://github.com/ThatGreenSpace/django-freshdesk/issues

License

You can use this software under BSD License.