Django users authentication through SMS code
Project description
Django rest sms auth
- Authentication users in Django through SMS code
- Change user phone number with confirmation
Requirements
- Python >= 3.0
- Django >= 2.0
- Celery
- Djangorestframework
- Django-phonenumber-field
Concept
- Client side send phone number (web/ios/android)
smsauth
validate phone number and createsms code
with life timesmsauth
sendsms code
(throughsms provider
)- User got
sms code
. Send it smsauth
validate{sms code + phone number}
- Send to client info (
jwt token
)
Notes
- Library use
celery
. Instruction - To use
twilio
install extra library - You may add your own provider inherit from
SMSProvider
Installation
pip install django-rest-sms-auth
If you want to use twilio
:
pip install twilio
settings.py
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
...
'sms_auth', # you have to add this
'sms_auth.providers.twilio' # if twilio provider
'sms_auth.providers.megafon' # if megafon provider
]
SMS_AUTH_SETTINGS = {
"SMS_CELERY_FILE_NAME": "run_celery", # your system celery file,
"SMS_AUTH_SUCCESS_KEY": "jwt_token", # property from user model
"SMS_AUTH_PROVIDER_FROM": "ex: +7542222222", # sms signature
# If twilio
"SMS_AUTH_ACCOUNT_SID": "Twilio SID"
"SMS_AUTH_AUTH_TOKEN": "Twilio token"
# If another provider
"SMS_AUTH_PROVIDER_LOGIN":"SMS provider login"
"SMS_AUTH_PROVIDER_PASSWORD": "SMS provider password"
}
Add celery
configuration file: Instruction
run migrations:
python manage.py makemigrations sms_auth && python manage.py migrate
urls.py
path('auth/', include('sms_auth.api.urls'))
Library is ready to use.
Usage
- Sign-in / sign-up:
POST /auth/sign-in/
body: {
"phone_number":"user phone number"
}
result: 200/400 response
- Code validation and get token:
POST /auth/auth/
body: {
"phone_number":"user phone number",
"code":sms_code
}
result: 200/400 response (with token)
- Change phone number:
POST /auth/change-phonenumber/
body: {
"new_phone_number":"user new phone number"
}
result: 200/400 response
After your call previous endpoint: /auth/auth
and send new phone number with code.
Extra
To clear all expired sms codes
python manage.py clear_expired
Additional settings:
"SMS_AUTH_CODE_LEN": int (default: 4)
"SMS_DEBUG": bool (default: False)
"SMS_DEBUG_CODE": int (when debug, default 1111)
"SMS_USER_FIELD": "username"
"SMS_TIMELIFE": 60 # life time of each sms code
"SMS_CODE_NOT_FOUND": "Some text when code not found"
"SMS_WAIT_TIME": "Some text when sms was sended"
"SMS_REQUEST_SUCCESS": "Some text when success phone validatioin and sms sended to user"
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for django-rest-sms-auth-0.1.19.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 85b5317f49f606faa43475e81f18fc6af086f5dd96ea17fe9af9a472417ec2f1 |
|
MD5 | dbdfcd119fb1beae2bc50fbfbca5712d |
|
BLAKE2b-256 | ac26ad43be62524c194ca0a200204580a9f5742c566fd60f0b0bc4dfd666b92c |
Close
Hashes for django_rest_sms_auth-0.1.19-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 84ab82411479eae1d1979064db22fd7555e49e505a3c0b30854c01c037fc5954 |
|
MD5 | f20b61d5d65fb52f6e62a359f2c12ae2 |
|
BLAKE2b-256 | f2c2cd34933004548124757f9950b2c8356f16c7cef8093dae99e2026d58d085 |