django-nopassword - GitLite

KO | EN

gitlite — search

#golang #bash #generative-ai #agents #automation #ai-agents #framework #python #linux #typescript

django-nopassword

(★ 179)

Authentication backend for django that uses a one time code instead of passwords

File Explorer

ZIP Download

- config.yml
- changelog.rst
- conf.py
- index.rst
- Makefile
- rest.rst
- settings.rst
- usage.rst
- - __init__.py
  - base.py
  - email.py
  - sms.py
- - 0001_initial.py
  - 0002_auto_20190406_1322.py
  - __init__.py
- - __init__.py
  - serializers.py
  - urls.py
  - views.py
- __init__.py
- admin.py
- forms.py
- models.py
- urls.py
- views.py
- - 404.html
- __init__.py
- models.py
- settings.py
- test_backends.py
- test_forms.py
- test_models.py
- test_rest_views.py
- test_views.py
- tests.py
- urls.py
.coveragerc
.gitignore
LICENSE
manage.py
MANIFEST.in
README.md
requirements.txt
runtests.py
setup.cfg
setup.py
tox.ini

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`next`

View Details ▼

React framework that uses server-side rendering for building optimized web applications.

next dev

Start the current application in development mode:

next dev {{[-p|--port]}} {{port}}

Start the current application and listen on a specific port:

next build

Build the current application optimized for production:

🔍

`pip install`

View Details ▼

Install Python packages.

pip install {{package1 package2 ...}}

Install one or more packages:

pip install {{package1 package2 ...}} {{[-U|--upgrade]}}

Upgrade all specified packages to the latest version, installing any that are not already present:

pip install {{package}}=={{version}}

Install a specific version of a package:

🔍

`python`

View Details ▼

Python language interpreter.

python

Start a REPL (interactive shell):

python {{path/to/file.py}}

Execute a specific Python file:

python -i {{path/to/file.py}}

Execute a specific Python file and start a REPL:

# Project Badges

CircleCI Visit

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

_Authentication backend for django that uses a one time code instead of passwords._

This project was originally inspired by [Is it time for password-less login?](http://notes.xoxco.com/post/27999787765/is-it-time-for-password-less-login) by [Ben Brown](http://twitter.com/benbrown)

## Installation
Run this command to install django-nopassword

pip install django-nopassword

### Requirements
Django >= 1.11 (custom user is supported)

## Usage
Add the app to installed apps

```python
INSTALLED_APPS = (
    ...
    'nopassword',
    ...
)
```

Add the authentication backend *EmailBackend*

```python
AUTHENTICATION_BACKENDS = (
    # Needed to login by username in Django admin, regardless of `nopassword`
    'django.contrib.auth.backends.ModelBackend',

# Send login codes via email
    'nopassword.backends.email.EmailBackend',
)
```

Add urls to your *urls.py*

```python
urlpatterns = patterns('',
    ...
    url(r'^accounts/', include('nopassword.urls')),
    ...
)
```

### REST API

To use the REST API, *djangorestframework* must be installed

pip install djangorestframework

Add rest framework to installed apps

```python
INSTALLED_APPS = (
    ...
    'rest_framework',
    'rest_framework.authtoken',
    'nopassword',
    ...
)
```

Add *TokenAuthentication* to default authentication classes

```python
REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'rest_framework.authentication.TokenAuthentication',
    )
}
```

Add urls to your *urls.py*

```python
urlpatterns = patterns('',
    ...
    url(r'^api/accounts/', include('nopassword.rest.urls')),
    ...
)
```

You will have the following endpoints available:

- `/api/accounts/login/` (POST)
  - username
  - next (optional, will be returned in `/api/accounts/login/code/` to be handled by the frontend)
  - Sends a login code to the user
- `/api/accounts/login/code/` (POST)
  - code
  - Returns `key` (authentication token) and `next` (provided by `/api/accounts/login/`)
- `/api/accounts/logout/` (POST)
  - Performs logout

### Settings
Information about the available settings can be found in the [docs](http://django-nopassword.readthedocs.org/en/latest/#settings)

## Tests
Run with `python setup.py test`.

--------
MIT © Rolf Erik Lekang