mirror of
https://github.com/Tivix/django-rest-auth.git
synced 2024-12-02 13:53:43 +03:00
62 lines
1.7 KiB
Markdown
62 lines
1.7 KiB
Markdown
# Dj-Rest-Auth
|
|
[](https://app.circleci.com/github/jazzband/dj-rest-auth/pipelines)
|
|
[](https://jazzband.co/)
|
|
[](https://coveralls.io/github/jazzband/dj-rest-auth?branch=master)
|
|
|
|
Drop-in API endpoints for handling authentication securely in Django Rest Framework. Works especially well
|
|
with SPAs (e.g React, Vue, Angular), and Mobile applications.
|
|
|
|
## Requirements
|
|
- Django 2 or 3.
|
|
- Python 3
|
|
|
|
## Quick Setup
|
|
|
|
Install package
|
|
|
|
pip install dj-rest-auth
|
|
|
|
Add `dj_rest_auth` app to INSTALLED_APPS in your django settings.py:
|
|
|
|
```python
|
|
INSTALLED_APPS = (
|
|
...,
|
|
'rest_framework',
|
|
'rest_framework.authtoken',
|
|
...,
|
|
'dj_rest_auth'
|
|
)
|
|
```
|
|
|
|
Add URL patterns
|
|
|
|
```python
|
|
urlpatterns = [
|
|
url(r'^dj-rest-auth/', include('dj_rest_auth.urls'))
|
|
]
|
|
```
|
|
|
|
|
|
(Optional) Use Http-Only cookies
|
|
|
|
```python
|
|
REST_USE_JWT = True
|
|
JWT_AUTH_COOKIE = 'jwt-auth'
|
|
```
|
|
|
|
### Testing
|
|
|
|
To run the tests within a virtualenv, run `python runtests.py` from the repository directory.
|
|
The easiest way to run test coverage is with [`coverage`](https://pypi.org/project/coverage/),
|
|
which runs the tests against all supported Django installs. To run the test coverage
|
|
within a virtualenv, run `coverage run ./runtests.py` from the repository directory then run `coverage report`.
|
|
|
|
|
|
### Documentation
|
|
|
|
View the full documentation here: https://dj-rest-auth.readthedocs.io/en/latest/index.html
|
|
|
|
|
|
### Acknowledgements
|
|
|
|
This project began as a fork of `django-rest-auth`. Big thanks to everyone who contributed to that repo! |