tokenix-auth-component 0.1.4

Componente de autenticación reutilizable para lambdas de RapidCredit que requieran autenticarse en Tokenix

Tokenix Auth Component

Componente de autenticación reutilizable para lambdas de RapidCredit que requieran autenticarse en Tokenix.

Instalación

pip install tokenix-auth-component

Dependencias

El paquete requiere las siguientes dependencias (se instalan automáticamente):

• requests>=2.25.0 - Para peticiones HTTP
• python-dotenv>=0.19.0 - Para variables de entorno (opcional)

Uso

Importar el cliente

from auth_component import create_auth_client

Obtener accessToken

# Crear cliente
auth_client = create_auth_client()

# Obtener accessToken
access_token = auth_client.get_access_token(
    api_key="tu-api-key",
    email_auth="email-para-primer-endpoint",
    password_auth="password-para-primer-endpoint", 
    email_user="email-para-segundo-endpoint",
    password_user="password-para-segundo-endpoint"
)

Realizar peticiones autenticadas

# Realizar petición HTTP autenticada
response = auth_client.make_request(
    method="GET",  # o "POST", "PUT", "DELETE"
    endpoint="/v2/user/profile",
    api_key="tu-api-key",
    email_auth="email-para-primer-endpoint",
    password_auth="password-para-primer-endpoint",
    email_user="email-para-segundo-endpoint", 
    password_user="password-para-segundo-endpoint",
    data={"key": "value"},  # opcional para POST/PUT
    params={"param": "value"}  # opcional para query parameters
)

Uso con context manager

with create_auth_client() as auth_client:
    access_token = auth_client.get_access_token(**credentials)
    response = auth_client.make_request("GET", "/v2/endpoint", **credentials)

Variables de Entrada

Variable	Descripción	Ejemplo
api_key	Clave API de Tokenix	"xxx-xxx-xxxx"
email_auth	Email para primer endpoint de autenticación	"[e-mail]"
password_auth	Password para primer endpoint de autenticación	"password123"
email_user	Email para segundo endpoint de autenticación	"[e-mail]"
password_user	Password para segundo endpoint de autenticación	"managerPassword123"

Manejo de Errores

El paquete incluye manejo de errores específicos:

from auth_component import AuthError, InvalidCredentialsError, ServiceUnavailableError

try:
    access_token = auth_client.get_access_token(**credentials)
except InvalidCredentialsError:
    print("Credenciales inválidas")
except ServiceUnavailableError:
    print("Servicio no disponible")
except AuthError:
    print("Error de autenticación general")

Ejemplo Completo

from auth_component import create_auth_client

# Credenciales
credentials = {
    "api_key": "tu-api-key",
    "email_auth": "[e-mail]",
    "password_auth": "password-auth",
    "email_user": "[e-mail]", 
    "password_user": "password-user"
}

# Usar cliente
with create_auth_client() as auth_client:
    # Obtener token
    token = auth_client.get_access_token(**credentials)
    print(f"Token: {token}")
    
    # Hacer petición
    response = auth_client.make_request("GET", "/v2/user/profile", **credentials)
    print(f"Status: {response.status_code}")
    print(f"Data: {response.json()}")

Pruebas

Para probar el paquete localmente:

1. Copia el archivo de ejemplo:

   cp test_auth.py.example test_auth.py
   

2. Edita las credenciales en test_auth.py:

   • Reemplaza las credenciales de ejemplo con las reales
   • NO subas test_auth.py con credenciales reales a PyPI

3. Ejecuta las pruebas:

   python3 test_auth.py
   

⚠️ Importante: El archivo test_auth.py con credenciales reales debe mantenerse local y no subirse a repositorios públicos.