maverick: An HTML repository from Visakh47

##How to Integrate SAWO SDK to Flask App

Requirements – Python, pip.

Steps:

Install the sawo package
```
pip install sawo
```
From Sawo import createTemplate, getContext and verifyToken methods The getContext method is used to create sawo dictionary object from data gain from DB in Django
```
from sawo import createTemplate, getContext, verifyToken
```
Login to sawo dev console sawo-dev-console
Create new project Set project name Set project host For dev: point to localhost For prod: point to your domain Copy the API key

Setup Getting started Creating template for sawo password less and OTP-less Authentication for your website.

Flask

#example
createTemplate("./templates/partials",flask=True)

#Sending data required by _sawo.html

The variable name used in _sawo.html template are sawo.auth_key, sawo.identifier and sawo.to so to send that data we create a json.

Note *The "to" route should be a post route which can receive posted data. *If you don’t know how data is passed to templates in Django or Flask, We will suggest looking into it first

Flask

METHOD 1. SENDING STATIC DATA

context = {
  "sawo":{
  "auth_key": "<api_key>",
  "identifier": "email | phone_number_sms"
  "to": <route> #the route where you will recieve
  the payload sent by sdk
  }
}

#example
context = {
  "sawo":{
  "auth_key": "785ha-hdjsdsd-799-ss345",
  "identifier": "email | phone_number_sms"
  "to": login
  }
}

METHOD 2. USING ADMIN AND DATABASE TO SAVE CONFIG FOR SAWO

Step 1. Creating fields for sawo api_key and identifier to set it from admin dashboard. copy this code in models of your app

class Config(models.Models):
api_key = models.CharField(max_length=200)
identifier = models.CharField(max_length=200)
choices = [("email","Email"),("phone_number_sms","Phone")]

Step 2. Setting up view.py of app. Note: Route should be the receiving end where you can handle post request

from models import Config
from sawo import getContext

def <your_function>(request):
config = Config.objects.order_by('-api_key')[:1]
context = {
"sawo" = getContext(config,<route>) #the route where you will recieve
the payload sent by sdk
}

#example

def index(request):
config = Config.objects.order_by('-api_key')[:1]
context = {
    "sawo" = getContext(config,"login")
}

Verifying Token

When the login is done on the webpage it sends the data to backend as payload to verify user, you can use verifyToken function, it returns a boolean.

BACKEND CODE IS SAME FOR DJANGO AND FLASK

from sawo import verifyToken

#use the method provided by flask and django to receive the
#data from post request the use this function it will return
#True or False depending on user status
verifyToken(payload)

//example
payload = <data from POST request>
if(verifyToken(payload)):
#do something
else:
#do something else

You are all set to use SAWO in your Flask Application

Visakh47/maverick