Metadata-Version: 2.1
Name: django-latch
Version: 0.2
Summary: Django latch module.
Home-page: https://github.com/javimoral/django-latch
Author: Javier Moral et al. (see README)
Author-email: moraljlara@gmail.com
License: Apache License 2.0
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Description-Content-Type: text/markdown
Requires-Dist: Django (>=2.0)

# django-latch

[![Build Status](https://travis-ci.com/javimoral/django-latch.svg?branch=master)](https://travis-ci.com/javimoral/django-latch)
[![codecov](https://codecov.io/gh/javimoral/django-latch/branch/master/graph/badge.svg)](https://codecov.io/gh/javimoral/django-latch)
[![Documentation Status](https://readthedocs.org/projects/django-latch/badge/?version=latest)](https://django-latch.readthedocs.io/en/latest/?badge=latest)

Django and Latch integration. Originaly developed by Javier Olascoaga and [RootedCON](http://rootedcon.com/).

# Requirements

- Python > 3.5
- Django >= 2.0

## Installation

To install it, simply run:

    $ pip install django-latch

Or, if you prefer installing from source:

    $ git clone https://github.com/javimoral/django-latch.git
    $ cd django-latch
    $ python setup.py install

# Configuration

In your `settings.py` file you need to add the following directives:

```python
   INSTALLED_APPS = (
       [...]
        'latch',
    )

    # Add auth profile
    AUTH_PROFILE_MODULE='latch.UserProfile'

    # Append Latch Auth Backend the first in list
    AUTHENTICATION_BACKENDS = [
        'latch.auth_backend.LatchAuthBackend',
        [...]
    ]

    LATCH_BYPASS_WHEN_UNREACHABLE = True # True is the default behaviour. Configure as you need.
```

Configure app urls

```python
    from django.urls import path, include

    urlpatterns = [
        [...]
        path('latch/', include('latch.urls'))
        [...]
    ]
```

Then apply migrations

    $ python manage.py makemigrations

For more information, please refer to [documentation](https://django-latch.readthedocs.io).

# TO-DO
* Configuring Latch API via environment variables.
* Run password hashing when Latch is locked to avoid timing attacks.


# Bugs and requests

Please report any bug/issue or feature request in GitHub issue tracker.

https://github.com/javimoral/django-latch/issues

# License

This module is published under Apache 2.0 license. See LICENSE file for details.

`latch-sdk-python` is published under GNU General Public License 2.0. Rights belongs to ElevenPaths, more information and the updated version at:
https://github.com/ElevenPaths/latch-sdk-python

# Authors

Originaly developed by Javier Olascoaga and [RootedCON](http://rootedcon.com/).


