3.2.0

## Enhancements
  - Updated demo with new UI and features.
  - Unit tests.
  - Bug fixes.
  - Updated some existing API's:
      Get Roles by UID: moved to role class
      Assign Roles by UID: moved role class
      One Touch Login: moved to authentication.login class
      Get Backup Code by Access Token: moved to authentication.TwoFactor class
      Reset Backup Code by Access Token: moved to authentication.TwoFactor class
      Get Backup Code by UID: moved to account.TwoFactor class
      Reset Backup Code by UID: moved to account.TwoFactor class
  - New V2 API's:
      Auth Privacy Policy Accept
      Auth Send Welcome Email
      Auth Verify Email by OTP
      Auth Delete Account
      Account Email Delete
      Phone Login Using OTP
      Phone Send OTP
      Remove Phone ID by Access Token
      2FA Validate Google Auth Code
      2FA Validate OTP
      Validate Backup Code
      Update MFA by Access Token
      Update MFA Setting
      One Touch Verify OTP by Email
      Get Active Session Details
      Access Token via Vkontakte Token
      Access Token via Google Token
      Refresh User Profile
      Refresh Token
      Delete All Records by Datasource

Author: Agarwal-Sudhanshu

CHANGELOG.txt

@@ -1,5 +1,39 @@
 # LoginRadius Python SDK Change Log
 
+# Version 3.2.0
+## Enhancements
+  - Updated demo with new UI and features.
+  - Unit tests.
+  - Bug fixes.
+  - Updated some existing API's:
+      Get Roles by UID: moved to role class
+      Assign Roles by UID: moved role class
+      One Touch Login: moved to authentication.login class
+      Get Backup Code by Access Token: moved to authentication.TwoFactor class
+      Reset Backup Code by Access Token: moved to authentication.TwoFactor class
+      Get Backup Code by UID: moved to account.TwoFactor class
+      Reset Backup Code by UID: moved to account.TwoFactor class
+  - New V2 API's:
+      Auth Privacy Policy Accept
+      Auth Send Welcome Email
+      Auth Verify Email by OTP
+      Auth Delete Account
+      Account Email Delete
+      Phone Login Using OTP
+      Phone Send OTP
+      Remove Phone ID by Access Token
+      2FA Validate Google Auth Code
+      2FA Validate OTP
+      Validate Backup Code
+      Update MFA by Access Token
+      Update MFA Setting
+      One Touch Verify OTP by Email
+      Get Active Session Details
+      Access Token via Vkontakte Token
+      Access Token via Google Token
+      Refresh User Profile
+      Refresh Token
+      Delete All Records by Datasource
 
 # Version 3.1.1
 ## Bug Fixed

example/cgi/LoginRadius/Exceptions.py renamed to demo/LoginRadius/Exceptions.py

@@ -20,7 +20,7 @@
 __copyright__ = "Copyright 2017-2018, LoginRadius"
 __email__ = "[email protected]"
 __status__ = "Production"
-__version__ = "3.1.0"
+__version__ = "3.2.0"
 
 
 tokenEndpoint = "/api/v2/access_token"
@@ -34,39 +34,57 @@ def __init__(self, lr_object):
         self._lr_object = lr_object
 
     def exchange(self, token):
-        """The Access Token API is used to get the LoginRadius access token after authentication. It will be valid for the specific duration of time specified in the response"""
+        # Access Token (GET)
         payload = {'token': token, 'secret': self._lr_object._get_api_secret()}
         url = self._lr_object.SECURE_API_URL + tokenEndpoint
         return self._lr_object._get_json(url, payload)
 
     def validate(self, access_token):
-        """Token Validate( GET )"""
+        # Token Validate (GET)
         payload = {'key': self._lr_object._get_api_key(), 'secret': self._lr_object._get_api_secret(),'access_token':access_token}
         url = self._lr_object.SECURE_API_URL + tokenEndpoint + "/Validate"
         return self._lr_object._get_json(url, payload)
 
     def invalidate(self, access_token):
-        """Token Validate( GET )"""
+        # Access Token Invalidate (GET)
         payload = {'key': self._lr_object._get_api_key(), 'secret': self._lr_object._get_api_secret(),'access_token':access_token}
         url = self._lr_object.SECURE_API_URL + tokenEndpoint + "/invalidate"
         return self._lr_object._get_json(url, payload)
 
-    def refresh(self, access_token):
-        """Token Validate( GET )"""
-        payload = {'key': self._lr_object._get_api_key(), 'secret': self._lr_object._get_api_secret(),'access_token':access_token}
+    def activeSessionDetails(self, access_token):
+        # Get Active Session Details (GET)
+        payload = {'key': self._lr_object._get_api_key(), 'secret': self._lr_object._get_api_secret(),'token':access_token}
+        url = self._lr_object.SECURE_API_URL + tokenEndpoint + "/activesession"
+        return self._lr_object._get_json(url, payload)
+
+    def refresh(self, access_token, expiresIn=''):
+        # Refresh Token (GET)
+        payload = {'key': self._lr_object._get_api_key(), 'secret': self._lr_object._get_api_secret(),'access_token':access_token, 'expiresIn':expiresIn}
         url = self._lr_object.SECURE_API_URL + tokenEndpoint + "/refresh"
         return self._lr_object._get_json(url, payload)
 
     def getFacebookToken(self, fb_access_token):
-        """Token Validate( GET )"""
+        # Access Token via Facebook Token (GET)
         payload = {'key': self._lr_object._get_api_key(),'fb_access_token':fb_access_token}
         url = self._lr_object.SECURE_API_URL + tokenEndpoint + "/facebook"
         return self._lr_object._get_json(url, payload)
 
     def getTwitterToken(self, tw_access_token, tw_token_secret):
-        """Token Validate( GET )"""
+        # Access Token via Twitter Token (GET)
         payload = {'key': self._lr_object._get_api_key(),'tw_access_token':tw_access_token, 'tw_token_secret':tw_token_secret}
         url = self._lr_object.SECURE_API_URL + tokenEndpoint + "/twitter"
         return self._lr_object._get_json(url, payload)
+
+    def getVkontakteToken(self, vk_access_token):
+        # Access Token via Vkontakte Token (GET)
+        payload = {'key': self._lr_object._get_api_key(),'vk_access_token':vk_access_token}
+        url = self._lr_object.SECURE_API_URL + tokenEndpoint + "/vkontakte"
+        return self._lr_object._get_json(url, payload)
+
+    def getGoogleToken(self, id_token):
+        # Access Token via Google JWT (GET)
+        payload = {'key': self._lr_object._get_api_key(),'id_token':id_token}
+        url = self._lr_object.SECURE_API_URL + tokenEndpoint + "/googlejwt"
+        return self._lr_object._get_json(url, payload)
 
 

example/cgi/LoginRadius/__init__.py renamed to demo/LoginRadius/__init__.py

@@ -20,7 +20,7 @@
 __copyright__ = "Copyright 2017-2018, LoginRadius"
 __email__ = "[email protected]"
 __status__ = "Production"
-__version__ = "3.1.0"
+__version__ = "3.2.0"
 
 
 accountEndpoint = "identity/v2/manage/account/"
@@ -37,45 +37,47 @@ def __init__(self, lr_object):
         self._lr_object = lr_object
 
     def create(self, payload, fields = '*'):
-        """Create Account( POST )"""
+        # Account Create (POST)
         headers  = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         params = 'fields='+fields
         url = self._lr_object.SECURE_API_URL + accountEndpoint + "?" + params
         return self._lr_object._post_json(url, payload, headers)
 
     def update(self, uid, payload, isNullSupport = False, fields = '*'):
-        """Update Account( POST )"""
+        # Account Update (PUT)
         headers  = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
-        params = 'nullsupport=' + isNullSupport + "&fields=" +fields
+        params = 'nullsupport=' + str(isNullSupport) + "&fields=" +fields
         url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + "?" + params
         return self._lr_object._put_json(url, payload, headers)
 
     def remove(self, uid):
-        """Account Delete( DELETE )"""
+        # Account Delete (DEL)
         headers  = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         url = self._lr_object.SECURE_API_URL + accountEndpoint + uid
         return self._lr_object._delete_json(url, {}, headers)
 
     def generateSott(self, timediff = '10'):
-        """Account generate sott( GET )"""
+        # Generate SOTT (GET)
         headers  = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         params = 'timedifference='+timediff
         url = self._lr_object.SECURE_API_URL + accountEndpoint + "sott"+"?" + params
         return self._lr_object._get_json(url, {}, headers)
 
     def setPassword(self, uid, password):
-        """Account Set Password( PUT )"""
+        # Account Set Password (PUT)
         headers  = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         payload = {"password": password}
-        url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + "/password"+"?" + params
+        url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + "/password"
         return self._lr_object._put_json(url, payload, headers)
 
     def getPassword(self, uid):
+        # Account Password (GET)
         headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + "/password"
         return self._lr_object._get_json(url, {}, headers)
 
     def invalidateVerificationEmail(self, uid, verificationUrl = '', emailTemplate = ''):
+        # Account Invalidate Verification Email (PUT)
         headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         params = 'verificationUrl=' + verificationUrl + "&emailTemplate=" +emailTemplate
         url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + "/invalidateemail"+"?" + params
@@ -99,62 +101,52 @@ def getDeletedAccountByUid(self, uid):
         url = self._lr_object.SECURE_API_URL + archivedEndpoint
         return self._lr_object._get_json(url, payload, headers)
 
-    def assignRole(self, uid, payload):
-        """Put Assign Role( PUT )"""
-        headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
-        url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + "/role"
-        return self._lr_object._put_json(url, payload, headers)
-    
-    def getRoleByUid(self, uid):
-        headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
-        url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + "/role"
-        return self._lr_object._get_json(url, {}, headers)
-    
     def updateSecurityQuestion(self, uid, payload):
+        # Account Update Security Question Configuration (PUT)
         headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         url = self._lr_object.SECURE_API_URL + accountEndpoint  + uid
         return self._lr_object._put_json(url, payload, headers)
 
     def getForgotPasswordToken(self, email):
+        # Forgot Password Token (POST)
         payload = {"email":email}
         headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         url = self._lr_object.SECURE_API_URL + accountEndpoint + "forgot/token"
         return self._lr_object._post_json(url, payload, headers)
 
     def getEmailVerificationToken(self, email):
+        # Email Verification Token (POST)
         payload = {"email":email}
         headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         url = self._lr_object.SECURE_API_URL + accountEndpoint + "verify/token"
         return self._lr_object._post_json(url, payload, headers)
 
     def getAccessToken(self, uid):
+        # Access Token based on UID or User impersonation API (GET)
         headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
-        payload = {"uid":uid}
-        url = self._lr_object.SECURE_API_URL + accountEndpoint + "access_token"
-        return self._lr_object._get_json(url, payload, headers)
+        params = 'uid=' + uid
+        url = self._lr_object.SECURE_API_URL + accountEndpoint + "access_token" + "?" + params
+        return self._lr_object._get_json(url, {}, headers)
 
     def getIdentities(self, email, fields= '*'):
+        # Account Identities by Email (GET)
         headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         params = 'email=' + email + "&fields=" +fields
         url = self._lr_object.SECURE_API_URL + accountEndpoint + "identities"  + "?" + params
         return self._lr_object._get_json(url, {}, headers)
 
     def resetPhoneIdVerification(self, uid):
+        # Reset phone ID verification (PUT)
         headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
         url = self._lr_object.SECURE_API_URL + accountEndpoint  + uid + "/invalidatephone"
         return self._lr_object._put_json(url, {}, headers)
 
-    def getBackupCodeByUid(self, uid):
-        headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
-        payload = {"uid":uid}
-        url = self._lr_object.SECURE_API_URL + accountEndpoint  + "2fa/backupcode"
-        return self._lr_object._get_json(url, payload, headers)
-
-    def resetBackupCodeByUid(self, uid):
-        headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
-        payload = {"uid":uid}
-        url = self._lr_object.SECURE_API_URL + accountEndpoint  + "2fa/backupcode/reset"
-        return self._lr_object._get_json(url, payload, headers)
+    def removeEmail(self, uid, email):
+        # Account Email Delete (DEL)
+        payload = {'email':email}
+        headers  = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
+        url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + '/email'
+        return self._lr_object._delete_json(url, payload, headers)
 
 
     class Profile:
@@ -163,24 +155,28 @@ def __init__(self, lr_object):
             self._lr_object = lr_object
 
         def getByEmail(self, email, fields = '*'):
+            # Account Profiles by Email (GET)
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             params = 'email=' + email + "&fields=" +fields
             url = self._lr_object.SECURE_API_URL + accountEndpoint + "?" + params
             return self._lr_object._get_json(url, {}, headers)
 
         def getByUsername(self, username, fields = '*'):
+            # Account Profiles by Username (GET)
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             params = 'username=' + username + "&fields=" +fields
             url = self._lr_object.SECURE_API_URL + accountEndpoint + "?" + params
             return self._lr_object._get_json(url, {}, headers)
 
         def getByPhone(self, phone, fields = '*'):
+            # Account Profile by Phone ID (GET)
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             params = 'phone=' + phone + "&fields=" +fields
             url = self._lr_object.SECURE_API_URL + accountEndpoint + "?" + params
             return self._lr_object._get_json(url, {}, headers)
 
         def getByUid(self, uid, fields = '*'):
+            # Account Profiles by UID (GET)
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             params = "fields=" +fields
             url = self._lr_object.SECURE_API_URL + accountEndpoint + uid + "?" + params
@@ -192,38 +188,61 @@ def __init__(self, lr_object):
             self._lr_object = lr_object
 
         def removeAuthByUid(self, uid, authenticator):
+            # MFA Reset Google Authenticator By UID (DEL) & MFA Reset SMS Authenticator By UID (DEL)
             payload = {}
             payload[authenticator] = True
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             params = 'uid='+uid
             url = self._lr_object.SECURE_API_URL + accountEndpoint  + "2FA/authenticator?" + params
             return self._lr_object._delete_json(url, payload, headers)
 
+        def getBackupCodeByUid(self, uid):
+            # MFA Backup Code by UID (GET)
+            headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
+            payload = {"uid":uid}
+            url = self._lr_object.SECURE_API_URL + accountEndpoint  + "2fa/backupcode"
+            return self._lr_object._get_json(url, payload, headers)
+
+        def resetBackupCodeByUid(self, uid):
+            # MFA Reset Backup Code by UID (GET)
+            headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
+            payload = {"uid":uid}
+            url = self._lr_object.SECURE_API_URL + accountEndpoint  + "2fa/backupcode/reset"
+            return self._lr_object._get_json(url, payload, headers)
+
     class RegistrationData:
 
         def __init__(self, lr_object):
             self._lr_object = lr_object
 
         def addRegistrationData(self, payload):
+            # Add Registration Data (POST)
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             url = self._lr_object.SECURE_API_URL + registrationDataEndpoint  + "registrationdata"
             return self._lr_object._post_json(url, payload, headers)
 
         def getRegistrationDataServer(self, datasourcetype, parentid='', skip = '', limit = ''):
+            # Get Registration Data (GET)
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             params = 'parentid='+ parentid+'&skip='+ skip+'&limit='+ limit
             url = self._lr_object.SECURE_API_URL + registrationDataEndpoint + "registrationdata/" + datasourcetype + "?" + params
             return self._lr_object._get_json(url, {}, headers)
 
         def updateRegistrationData(self, recordid, payload):
-            """Update Registration Data( PUT )"""
+            # Update Registration Data (PUT)
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             url = self._lr_object.SECURE_API_URL + registrationDataEndpoint + "registrationdata/" + recordid
             return self._lr_object._put_json(url, payload, headers)
 
         def deleteRegistrationData(self, recordid):
-            """Delete Registration Data( delete )"""
+            # Delete Registration Data (DEL)
             headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
             url = self._lr_object.SECURE_API_URL + registrationDataEndpoint + "registrationdata/" + recordid
             return self._lr_object._delete_json(url, {}, headers)
+
+        def deleteAllRecordsByDatasource(self, datasourcetype):
+            # Delete All Records by Datasource (DEL)
+            headers = {'apikey': self._lr_object._get_api_key(), 'apisecret': self._lr_object._get_api_secret()}
+            url = self._lr_object.SECURE_API_URL + registrationDataEndpoint + "registrationdata/type/" + datasourcetype
+            return self._lr_object._delete_json(url, {}, headers)