Package: drfpasswordless-tst
drfpasswordless is a quick way to integrate ‘passwordless’ auth into
your Django Rest Framework project using a user’s email address or
mobile number only (herein referred to as an alias).Built to work with DRF’s own TokenAuthentication system, it sends the
user a 6-digit callback token to a given email address or a mobile
number. The user sends it back correctly and they’re given an
authentication token (again, provided by Django Rest Framework’s
TokenAuthentication system).Callback tokens by default expire after 15 minutes.Example Usage:curl-XPOST-d“email=aaron@email.com”localhost:8000/auth/email/Email toaaron@email.com:...
<h1>Your login token is 815381.</h1>
...Return Stagecurl-XPOST-d"email=aaron@example.com&token=815381"localhost:8000/auth/token/

>HTTP/1.0200OK
>{"token":"76be2d9ecfaf5fa4226d722bzdd8a4fff207ed0e”}RequirementsPython (3.7+)Django (2.2+)Django Rest Framework + AuthToken (3.10+)Python-Twilio (Optional, for mobile.)InstallInstall drfpasswordlesspipenv install drfpasswordlessAdd Django Rest Framework’s Token Authentication to your Django Rest
Framework project.REST_FRAMEWORK={'DEFAULT_AUTHENTICATION_CLASSES':('rest_framework.authentication.TokenAuthentication',)}INSTALLED_APPS=[...'rest_framework','rest_framework.authtoken','drfpasswordless',...]And runpythonmanage.pymigrateSet which types of contact points are allowed for auth in your
Settings.py. The available options areEMAILandMOBILE.PASSWORDLESS_AUTH={..'PASSWORDLESS_AUTH_TYPES':['EMAIL','MOBILE'],..}By default drfpasswordless looks for fields namedemailormobileon the User model. If an alias provided doesn’t belong to any given user,
a new user is created.3a. If you’re usingemail, see the Configuring Email section
below.3b. If you’re usingmobile, see the Configuring Mobile section
below.Adddrfpasswordless.urlsto your urls.pyfromdjango.urlsimportpath,includeurlpatterns=[..path('',include('drfpasswordless.urls')),..]You can now POST to either of the endpoints:curl-XPOST-d"email=aaron@email.com"localhost:8000/auth/email/

//OR

curl-XPOST-d"mobile=+15552143912"localhost:8000/auth/mobile/A 6 digit callback token will be sent to the contact point.The client has 15 minutes to use the 6 digit callback token
correctly. If successful, they get an authorization token in exchange
which the client can then use with Django Rest Framework’s
TokenAuthentication scheme.curl-XPOST-d"email=aaron@email.com&token=815381"localhost:8000/auth/token/

>HTTP/1.0200OK
>{"token":"76be2d9ecfaf5fa4226d722bzdd8a4fff207ed0e”}Configuring EmailsSpecify the email address you’d like to send the callback token from
with thePASSWORDLESS_EMAIL_NOREPLY_ADDRESSsetting.PASSWORDLESS_AUTH={..'PASSWORDLESS_AUTH_TYPES':['EMAIL',],'PASSWORDLESS_EMAIL_NOREPLY_ADDRESS':'noreply@example.com',..}You’ll also need to set up an SMTP server to send emails but for
development you can set up a dummy development smtp server to test
emails. Sent emails will print to the console.Read more here. <https://docs.djangoproject.com/en/3.0/topics/email/#console-backend>__# Settings.pyEMAIL_BACKEND='django.core.mail.backends.console.EmailBackend'Configuring MobileYou’ll need to have the python twilio module installedpipenvinstalltwilioand set theTWILIO_ACCOUNT_SIDandTWILIO_AUTH_TOKENenvironment
variables. These are read fromos.environ, so make sure you don't put
them in your settings file accidentally.You’ll also need to specify the number you send the token from with thePASSWORDLESS_MOBILE_NOREPLY_NUMBERsetting.TemplatesIf you’d like to use a custom email template for your email callback
token, specify your template name with this setting:PASSWORDLESS_AUTH={...'PASSWORDLESS_EMAIL_TOKEN_HTML_TEMPLATE_NAME':"mytemplate.html"}The template renders a single variable{{ callback_token }}which is
the 6 digit callback token being sent.Contact Point ValidationEndpoints can automatically mark themselves as validated when a user
logs in with a token sent to a specific endpoint. They can also
automatically mark themselves as invalid when a user changes a contact
point.This is off by default but can be turned on withPASSWORDLESS_USER_MARK_EMAIL_VERIFIEDorPASSWORDLESS_USER_MARK_MOBILE_VERIFIED. By default when these are
enabled they look for the User model fieldsemail_verifiedormobile_verified.You can also useauth/verify/email/or/auth/verify/mobile/which will
automatically send a token to the endpoint attached to the currentrequest.user's email or mobile if available.You can then send that token to/auth/verify/which will double-check
that the endpoint belongs to the request.user and mark the alias as verified.RegistrationAll unrecognized emails and mobile numbers create new accounts by
default. New accounts are automatically set withset_unusable_password()but it’s recommended that admins have some
type of password.This can be turned off with thePASSWORDLESS_REGISTER_NEW_USERSsetting.Other SettingsHere’s a full list of the configurable defaults.DEFAULTS={# Allowed to choose custom user model'PASSWORDLESS_USER_MODEL':None,# Allowed auth types, can be EMAIL, MOBILE, or both.'PASSWORDLESS_AUTH_TYPES':['EMAIL','MOBILE'],# URL Prefix for Authentication Endpoints'PASSWORDLESS_AUTH_PREFIX':'auth/',#  URL Prefix for Verification Endpoints'PASSWORDLESS_VERIFY_PREFIX':'auth/verify/',#  URL Prefix for Change Endpoints'PASSWORDLESS_CHANGE_PREFIX':'auth/change/',# Amount of time that tokens last, in seconds'PASSWORDLESS_TOKEN_EXPIRE_TIME':15*60,# The user's email field name'PASSWORDLESS_USER_EMAIL_FIELD_NAME':'email',# The user's mobile field name'PASSWORDLESS_USER_MOBILE_FIELD_NAME':'mobile',# Marks itself as verified the first time a user completes auth via token.# Automatically unmarks itself if email is changed.'PASSWORDLESS_USER_MARK_EMAIL_VERIFIED':False,'PASSWORDLESS_USER_EMAIL_VERIFIED_FIELD_NAME':'email_verified',# Marks itself as verified the first time a user completes auth via token.# Automatically unmarks itself if mobile number is changed.'PASSWORDLESS_USER_MARK_MOBILE_VERIFIED':False,'PASSWORDLESS_USER_MOBILE_VERIFIED_FIELD_NAME':'mobile_verified',# Configurable token length.'PASSWORDLESS_CALLBACK_TOKEN_LENGTH':6,# Token Generation Retry Count'PASSWORDLESS_TOKEN_GENERATION_ATTEMPTS':3,# Automatically send verification email or sms when a user changes their alias.'PASSWORDLESS_AUTO_SEND_VERIFICATION_TOKEN':False,# Registers previously unseen aliases as new users.'PASSWORDLESS_REGISTER_NEW_USERS':True,# Context Processors for Email Template'PASSWORDLESS_CONTEXT_PROCESSORS':[],# Standardise mobile number before validation'PASSWORDLESS_MOBILE_NUMBER_STANDARDISE':False,# --- MESSAGES SECTION --- ## LOGIN MESSAGES# The email the callback token is sent from'PASSWORDLESS_EMAIL_NOREPLY_ADDRESS':None,# The email subject'PASSWORDLESS_EMAIL_SUBJECT':"Your Login Token",# A plaintext email message overridden by the html message. Takes one string.'PASSWORDLESS_EMAIL_PLAINTEXT_MESSAGE':"Enter this token to sign in:%s",# The email template name.'PASSWORDLESS_EMAIL_TOKEN_HTML_TEMPLATE_NAME':"passwordless_default_token_email.html",# Your twilio number that sends the callback tokens.'PASSWORDLESS_MOBILE_NOREPLY_NUMBER':None,# The message sent to mobile users logging in. Takes one string.'PASSWORDLESS_MOBILE_MESSAGE':"Use this code to log in:%s",# Registers previously unseen aliases as new users.'PASSWORDLESS_REGISTER_NEW_USERS':True,# Suppresses actual SMS for testing'PASSWORDLESS_TEST_SUPPRESSION':False,# Context Processors for Email Template'PASSWORDLESS_CONTEXT_PROCESSORS':[],# The verification email subject'PASSWORDLESS_EMAIL_VERIFICATION_SUBJECT':"Your Verification Token",# A plaintext verification email message overridden by the html message. Takes one string.'PASSWORDLESS_EMAIL_VERIFICATION_PLAINTEXT_MESSAGE':"Enter this verification code:%s",# The verification email template name.'PASSWORDLESS_EMAIL_VERIFICATION_TOKEN_HTML_TEMPLATE_NAME':"passwordless_default_verification_token_email.html",# The message sent to mobile users logging in. Takes one string.'PASSWORDLESS_MOBILE_VERIFICATION_MESSAGE':"Enter this verification code:%s",# CHANGE MESSAGES# The change email subject'PASSWORDLESS_EMAIL_CHANGE_SUBJECT':"Your Verification Token",# A plaintext change email message overridden by the html message. Takes one string.'PASSWORDLESS_EMAIL_CHANGE_PLAINTEXT_MESSAGE':"Enter this verification code:%s",# The change email template name.'PASSWORDLESS_EMAIL_CHANGE_TOKEN_HTML_TEMPLATE_NAME':"passwordless_default_change_token_email.html",# The message sent to mobile users verification. Takes one string.'PASSWORDLESS_MOBILE_CHANGE_MESSAGE':"Enter this verification code:%s",# --- TESTING SETTINGS --- ## Suppresses actual SMS for testing'PASSWORDLESS_TEST_SUPPRESSION':False,# Testing mode (every token applicable)'PASSWORDLESS_TEST_MODE':False,# List with incorrect codes (integer, please) for the test mode.'PASSWORDLESS_TEST_CODE_INCORRECT':[],# A dictionary of demo user's primary key mapped to their static pin'PASSWORDLESS_DEMO_USERS':{},# --- ADVANCED SETTINGS --- ## Automatically send verification email or sms when a user changes their alias.'PASSWORDLESS_AUTO_SEND_VERIFICATION_TOKEN':False,# What function is called to construct an authentication tokens when# exchanging a passwordless token for a real user auth token. This function# should take a user and return a tuple of two values. The first value is# the token itself, the second is a boolean value representating whether# the token was newly created.'PASSWORDLESS_AUTH_TOKEN_CREATOR':'drfpasswordless.utils.create_authentication_token',# What function is called to construct a serializer for drf tokens when# exchanging a passwordless token for a real user auth token.'PASSWORDLESS_AUTH_TOKEN_SERIALIZER':'drfpasswordless.serializers.TokenResponseSerializer',# A dictionary of demo user's primary key mapped to their static pin'PASSWORDLESS_DEMO_USERS':{},# configurable function for sending email'PASSWORDLESS_EMAIL_CALLBACK':'drfpasswordless.utils.send_email_with_callback_token',# configurable function for sending sms'PASSWORDLESS_SMS_CALLBACK':'drfpasswordless.utils.send_sms_with_callback_token',# Token Generation Retry Count'PASSWORDLESS_TOKEN_GENERATION_ATTEMPTS':3}To Dogithub.io project pageAdd MkDocs -http://www.mkdocs.org/Support non-US mobile numbersCustom URLsChange bad settings to 500'sPull requests are encouraged!Donations & SupportIf you found drfpasswordless useful, consider giving me a follow@localghoston Twitter and@hi.aaronon Instagram.If you'd like to go a step further and are using drfpasswordless in your startup
or business, consider a donation:BTC:3FzSFeKVABL5Adh9Egoxh77gHbtg2kcTPkETH:0x13412a79F06A83B107A8833dB209BECbcb700f24Square Cash:$aaronLicenseThe MIT License (MIT)Copyright (c) 2020 Aaron NgPermission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.