Metadata-Version: 2.0
Name: django-rest-knox
Version: 2.3.0
Summary: Authentication for django rest framework
Home-page: https://github.com/James1345/django-rest-knox
Author: James McMahon
Author-email: james1345@googlemail.com
License: MIT
Keywords: django rest authentication login
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Session
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: django
Requires-Dist: djangorestframework
Requires-Dist: pyOpenSSL
Provides-Extra: dev
Provides-Extra: test

django-rest-knox
================

.. image:: https://travis-ci.org/James1345/django-rest-knox.svg?branch=develop
   :target: https://travis-ci.org/James1345/django-rest-knox

Authentication Module for django rest auth

Knox provides easy to use authentication for `Django REST
Framework <http://www.django-rest-framework.org/>`__ The aim is to allow
for common patterns in applications that are REST based, with little
extra effort; and to ensure that connections remain secure.

Knox authentication is token based, similar to the
``TokenAuthentication`` built in to DRF. However, it overcomes some
problems present in the default implementation:

-  DRF Tokens are generated with ``os.urandom``, which is not
   cryptographically secure.

   Knox uses OpenSSL to provide tokens.

-  DRF tokens are limited to one per user. This does not facilitate
   securely signing in from multiple devices, as the token is shared. It
   also requires *all* devices to be logged out if a server-side logout
   is required (i.e. the token is deleted).

   Knox provides one token per call to the login view - allowing each
   client to have its own token which is deleted on the server side when
   the client logs out.

   Knox also provides an option for a logged in client to remove *all*
   tokens that the server has - forcing all clients to re-authenticate.

-  DRF tokens are stored unencrypted in the database. This would allow
   an attacker unrestricted access to an account with a token if the
   database were compromised.

   Knox tokens are only stored in an encrypted form. Even if the
   database were somehow stolen, an attacker would not be able to log in
   with the stolen credentials.

-  DRF tokens track their creation time, but have no inbuilt mechanism for tokens
   expiring. Knox tokens can have an expiry configured in the app settings (default is
   10 hours.)

More information can be found in the
`Documentation <http://james1345.github.io/django-rest-knox/>`__


