sendvrel-login 1.1.3__tar.gz

sendvrel_login-1.1.3/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: sendvrel-login
+Version: 1.1.3
+Summary: Official Python SDK for Sendvrel OAuth Login
+Author: Sendvrel
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.1
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# sendvrel-login-python
+
+> **Critical Update Added: Important PKCE Security Fix**. Please upgrade to the latest version immediately to maintain login functionality with Sendvrel.
+
+Official Python SDK for Sendvrel Authentication.
+
+🚀 Quick Start (Zero-Config)
+-----------------------------
+Easily integrate Sendvrel OAuth 2.0 into your Python backends (Django, Flask, FastAPI). 
+This package acts as a full **Confidential Client**, capable of handling authorization URLs, secure token exchanges, and token verification.
+
+### Installation
+```bash
+pip install sendvrel-login
+```
+
+🛠️ Usage
+---------
+### 1. Generating the Authorization URL
+Redirect your users to this URL so they can log in via Sendvrel.
+
+```python
+from sendvrel_login import TSPClient
+
+client = TSPClient(
+    client_id='YOUR_CLIENT_ID',
+    client_secret='YOUR_CLIENT_SECRET',
+    redirect_uri='http://localhost:8000/callback'
+)
+
+auth_url = client.get_authorization_url()
+# Redirect your user to `auth_url`
+```
+
+### 2. Exchanging the Code for a Token
+When the user returns to your `redirect_uri`, they will have a `code` in the URL parameters.
+
+```python
+# Assuming you extracted the `code` from the URL query string
+token_data = client.exchange_token(code)
+
+if 'error' in token_data:
+    print("Failed to login:", token_data['error'])
+else:
+    access_token = token_data['access_token']
+    print("Successfully retrieved access token!", access_token)
+```
+
+### 3. Verifying a Token / Getting the User Profile
+Once you have an access token (or if you are just verifying a token sent by a React frontend), use `verify_token`.
+
+```python
+from sendvrel_login import TSPAuthException
+
+try:
+    data = client.verify_token(access_token)
+    user_profile = data['user']
+    print(f"Logged in as: {user_profile['email']}")
+except TSPAuthException as error:
+    print(f"Authentication failed: {str(error)}")
+```
+

sendvrel_login-1.1.3/README.md

@@ -0,0 +1,62 @@
+# sendvrel-login-python
+
+> **Critical Update Added: Important PKCE Security Fix**. Please upgrade to the latest version immediately to maintain login functionality with Sendvrel.
+
+Official Python SDK for Sendvrel Authentication.
+
+🚀 Quick Start (Zero-Config)
+-----------------------------
+Easily integrate Sendvrel OAuth 2.0 into your Python backends (Django, Flask, FastAPI). 
+This package acts as a full **Confidential Client**, capable of handling authorization URLs, secure token exchanges, and token verification.
+
+### Installation
+```bash
+pip install sendvrel-login
+```
+
+🛠️ Usage
+---------
+### 1. Generating the Authorization URL
+Redirect your users to this URL so they can log in via Sendvrel.
+
+```python
+from sendvrel_login import TSPClient
+
+client = TSPClient(
+    client_id='YOUR_CLIENT_ID',
+    client_secret='YOUR_CLIENT_SECRET',
+    redirect_uri='http://localhost:8000/callback'
+)
+
+auth_url = client.get_authorization_url()
+# Redirect your user to `auth_url`
+```
+
+### 2. Exchanging the Code for a Token
+When the user returns to your `redirect_uri`, they will have a `code` in the URL parameters.
+
+```python
+# Assuming you extracted the `code` from the URL query string
+token_data = client.exchange_token(code)
+
+if 'error' in token_data:
+    print("Failed to login:", token_data['error'])
+else:
+    access_token = token_data['access_token']
+    print("Successfully retrieved access token!", access_token)
+```
+
+### 3. Verifying a Token / Getting the User Profile
+Once you have an access token (or if you are just verifying a token sent by a React frontend), use `verify_token`.
+
+```python
+from sendvrel_login import TSPAuthException
+
+try:
+    data = client.verify_token(access_token)
+    user_profile = data['user']
+    print(f"Logged in as: {user_profile['email']}")
+except TSPAuthException as error:
+    print(f"Authentication failed: {str(error)}")
+```
+

sendvrel_login-1.1.3/sendvrel_login/__init__.py

@@ -0,0 +1,3 @@
+from .client import TSPClient, TSPAuthException
+
+__all__ = ['TSPClient', 'TSPAuthException']

sendvrel_login-1.1.3/sendvrel_login/client.py

@@ -0,0 +1,101 @@
+import requests
+from urllib.parse import urlencode
+import os
+import base64
+import hashlib
+
+class TSPAuthException(Exception):
+    pass
+
+class TSPClient:
+    def __init__(self, client_id=None, client_secret=None, redirect_uri=None, api_url='https://api.sendvrel.kystron.com/api/v1', auth_url='https://accounts.kystron.com/oauth/authorize'):
+        self.api_url = api_url.rstrip('/')
+        self.auth_url = auth_url.rstrip('/')
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.redirect_uri = redirect_uri
+
+    def get_authorization_url(self, state='tsp_auth', scope='read', pkce_challenge=None):
+        """
+        Generates the OAuth 2.0 Authorization URL to redirect the user to.
+        """
+        if not self.client_id or not self.redirect_uri:
+            raise TSPAuthException('TSPClient requires client_id and redirect_uri to generate an authorization URL.')
+            
+        params = {
+            'client_id': self.client_id,
+            'redirect_uri': self.redirect_uri,
+            'response_type': 'code',
+            'scope': scope,
+            'state': state
+        }
+        
+        if pkce_challenge:
+            params['code_challenge'] = pkce_challenge
+            params['code_challenge_method'] = 'S256'
+            
+        return f"{self.auth_url}?{urlencode(params)}"
+
+    def exchange_token(self, code, code_verifier=None):
+        """
+        Securely exchanges an authorization code for an access token.
+        """
+        if not self.client_id or not self.client_secret or not self.redirect_uri:
+            raise TSPAuthException('TSPClient requires client_id, client_secret, and redirect_uri to exchange tokens.')
+            
+        payload = {
+            'grant_type': 'authorization_code',
+            'client_id': self.client_id,
+            'client_secret': self.client_secret,
+            'code': code,
+            'redirect_uri': self.redirect_uri
+        }
+        
+        if code_verifier:
+            payload['code_verifier'] = code_verifier
+        
+        try:
+            response = requests.post(f'{self.api_url}/oauth/token', json=payload)
+            data = response.json()
+            
+            if not response.ok:
+                return {'error': data.get('error', 'Failed to exchange token')}
+            
+            return {'access_token': data.get('access_token')}
+        except requests.RequestException as e:
+            return {'error': f'Network error exchanging token: {str(e)}'}
+
+    def verify_token(self, access_token):
+        """
+        Verifies an access token with the Sendvrel backend.
+        
+        :param access_token: The OAuth 2.0 Access Token
+        :return: A dictionary containing the user's profile
+        :raises TSPAuthException: If the token is invalid or expired
+        """
+        headers = {
+            'Authorization': f'Bearer {access_token}',
+            'Content-Type': 'application/json'
+        }
+        
+        try:
+            response = requests.get(f'{self.api_url}/oauth/userinfo', headers=headers)
+            data = response.json()
+            
+            if not response.ok:
+                raise TSPAuthException(data.get('error', 'Failed to verify token'))
+                
+            return {'user': data}
+        except requests.RequestException as e:
+            raise TSPAuthException(f'Network error verifying token: {str(e)}')
+
+def generate_pkce():
+    """
+    Utility to generate PKCE Verifier and Challenge pairs
+    """
+    verifier = base64.urlsafe_b64encode(os.urandom(32)).decode('utf-8').rstrip('=')
+    challenge = base64.urlsafe_b64encode(
+        hashlib.sha256(verifier.encode('utf-8')).digest()
+    ).decode('utf-8').rstrip('=')
+    return verifier, challenge
+

sendvrel_login-1.1.3/sendvrel_login.egg-info/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: sendvrel-login
+Version: 1.1.3
+Summary: Official Python SDK for Sendvrel OAuth Login
+Author: Sendvrel
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.1
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# sendvrel-login-python
+
+> **Critical Update Added: Important PKCE Security Fix**. Please upgrade to the latest version immediately to maintain login functionality with Sendvrel.
+
+Official Python SDK for Sendvrel Authentication.
+
+🚀 Quick Start (Zero-Config)
+-----------------------------
+Easily integrate Sendvrel OAuth 2.0 into your Python backends (Django, Flask, FastAPI). 
+This package acts as a full **Confidential Client**, capable of handling authorization URLs, secure token exchanges, and token verification.
+
+### Installation
+```bash
+pip install sendvrel-login
+```
+
+🛠️ Usage
+---------
+### 1. Generating the Authorization URL
+Redirect your users to this URL so they can log in via Sendvrel.
+
+```python
+from sendvrel_login import TSPClient
+
+client = TSPClient(
+    client_id='YOUR_CLIENT_ID',
+    client_secret='YOUR_CLIENT_SECRET',
+    redirect_uri='http://localhost:8000/callback'
+)
+
+auth_url = client.get_authorization_url()
+# Redirect your user to `auth_url`
+```
+
+### 2. Exchanging the Code for a Token
+When the user returns to your `redirect_uri`, they will have a `code` in the URL parameters.
+
+```python
+# Assuming you extracted the `code` from the URL query string
+token_data = client.exchange_token(code)
+
+if 'error' in token_data:
+    print("Failed to login:", token_data['error'])
+else:
+    access_token = token_data['access_token']
+    print("Successfully retrieved access token!", access_token)
+```
+
+### 3. Verifying a Token / Getting the User Profile
+Once you have an access token (or if you are just verifying a token sent by a React frontend), use `verify_token`.
+
+```python
+from sendvrel_login import TSPAuthException
+
+try:
+    data = client.verify_token(access_token)
+    user_profile = data['user']
+    print(f"Logged in as: {user_profile['email']}")
+except TSPAuthException as error:
+    print(f"Authentication failed: {str(error)}")
+```
+

sendvrel_login-1.1.3/sendvrel_login.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+setup.py
+sendvrel_login/__init__.py
+sendvrel_login/client.py
+sendvrel_login.egg-info/PKG-INFO
+sendvrel_login.egg-info/SOURCES.txt
+sendvrel_login.egg-info/dependency_links.txt
+sendvrel_login.egg-info/requires.txt
+sendvrel_login.egg-info/top_level.txt

sendvrel_login-1.1.3/sendvrel_login.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sendvrel_login-1.1.3/sendvrel_login.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.1

sendvrel_login-1.1.3/sendvrel_login.egg-info/top_level.txt

@@ -0,0 +1 @@
+sendvrel_login

sendvrel_login-1.1.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sendvrel_login-1.1.3/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+from pathlib import Path
+
+this_directory = Path(__file__).parent
+long_description = (this_directory / "README.md").read_text(encoding='utf-8')
+
+setup(
+    name='sendvrel-login',
+    version='1.1.3',
+    description='Official Python SDK for Sendvrel OAuth Login',
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    author='Sendvrel',
+    packages=find_packages(),
+    install_requires=[
+        'requests>=2.25.1'
+    ],
+    python_requires='>=3.6',
+)