nexgensis-auth-client 0.1.0

Python SDK for Nexgensis CentralAuth — JWT validation, auth API client, admin client, webhooks, Django integration

nexgensis-auth-client

Official Python SDK for CentralAuth — Nexgensis' shared identity provider.

Products use it to:

• Validate Django-issued JWTs against the published JWKS (RS256, audience-bound).
• Call /oauth/* and /api/auth/* (AuthClient) on behalf of a human user.
• Mint M2M tokens (M2MClient) for service-to-service calls, with audience+scope-keyed in-process caching.
• Drive admin operations (AdminClient) — users, groups, products, entitlements, audit — for backend sync jobs.
• Receive webhooks safely — HMAC-SHA256 signature, timestamp replay-guard, idempotent dedupe (WebhookVerifier + Django @webhook_view).
• Plug into Django/DRF with one settings dict — JWTAuthentication, AuthMiddleware, HasGroup / HasEntitlement / HasScope.

Install

pip install nexgensis-auth-client            # core: validation + clients + webhooks
pip install 'nexgensis-auth-client[django]'  # adds Django + DRF integration

60-second Django integration

# settings.py
CENTRALAUTH = {
    "BASE_URL": "https://auth.nexgensis.com",
    "AUDIENCE": "qms",   # this product's client_id
}

REST_FRAMEWORK = {
    "DEFAULT_AUTHENTICATION_CLASSES": [
        "nexgensis_auth_client.django.authentication.JWTAuthentication",
    ],
}

# views.py
from rest_framework.decorators import api_view, permission_classes
from rest_framework.permissions import IsAuthenticated
from nexgensis_auth_client.django.permissions import HasGroup

@api_view(["POST"])
@permission_classes([IsAuthenticated, HasGroup("QA_LEAD")])
def close_issue(request, issue_id):
    ...

After auth: request.user.id / request.auth.has_group(...) / request.auth.email.

Webhook receiver

# settings.py
QMS_USER_SYNC_SECRET = os.environ["QMS_USER_SYNC_SECRET"]

# urls.py
path("webhooks/centralauth/", on_user_event),

# views.py
from nexgensis_auth_client.django.webhooks import webhook_view

@webhook_view(secret_setting="QMS_USER_SYNC_SECRET")
def on_user_event(request, event):
    if event.event_type == "user.disabled":
        ...
    return HttpResponse(status=200)

Test helpers

from nexgensis_auth_client.testing import build_auth_context, override_auth

def test_qa_lead_can_close(api_client):
    ctx = build_auth_context(user_id="u-1", groups=["QA_LEAD"])
    with override_auth(api_client, ctx):
        response = api_client.post("/issues/I-1/close/")
    assert response.status_code == 200

Stable surface

These are the public, semver-protected names:

Module	Purpose
AuthClient	OAuth user flows (login/refresh/etc.)
AdminClient	/api/v1/* admin REST
M2MClient	client_credentials with token caching
JWTValidator / JWKSCache	Token validation
AuthContext	Claim accessor (groups, scopes, etc.)
WebhookVerifier / VerifiedEvent	Webhook HMAC + dedupe
nexgensis_auth_client.django.*	Django/DRF integration
nexgensis_auth_client.testing.*	Test fixtures

See docs/PRODUCT_INTEGRATION_GUIDE.md in the CentralAuth repo for the full guide.