SOX Light
Service Inheritance

Service Oriented eXtension - A revolutionary approach to API inheritance and compliance.

Fork, derive, and extend services while maintaining full compliance and audit trails. The Git for APIs.

100%

Audit Coverage

3 Levels

Compliance Tiers

Unlimited

Inheritance Depth

Auto

Proxy Injection

What is SOX Light?

A revolutionary approach to service management inspired by software version control

🔌

Service Forking

Create derivative services that inherit capabilities from parent services. Like Git branches, but for APIs.

🌳

Inheritance Trees

Visualize and manage complex service hierarchies. Track lineage from root to leaf across unlimited depth.

🔍

Full Traceability

Every change, every call, every derivative is logged. Complete audit trail for compliance requirements.

🔗

Automatic Proxy

Sidecar proxies automatically forward calls to parent services based on declarative JSON rules.

🔒

Compliance Levels

Three tiers of SOX compliance (1-3) with configurable data classification and encryption requirements.

🚀

Zero-Code Setup

Define inheritance and forwarding rules in JSON. No code changes needed to inherit parent functionality.

🚫

Circular Call Protection

Automatic detection and prevention of infinite loops in inheritance chains. No more stack overflows.

Inheritance in Action

See how a regional service inherits from its parent

sox-manifest.json
{
  "version": "1.0.0",
  "complianceLevel": 2,
  "dataClassification": "confidential",
  "auditRequired": true,
  "retentionDays": 365,
  "encryptionLevel": "AES-256",
  "proxy": {
    "enabled": true,
    "parent_sku": "FR-001",
    "default_target": "parent",
    "rules": [
      {
        "method": "analyze_*",
        "target": "local",
        "timeout_ms": 60000
      },
      {
        "method": "get_base_config",
        "target": "root"
      },
      {
        "method": "*",
        "target": "parent"
      }
    ]
  }
}

Proxy Forwarding Rules

Declarative routing without writing code

Target Description Use Case
local Execute on current service Custom regional logic, overrides
parent Forward to direct parent Inherit base functionality
root Forward to original ancestor Global config, shared state
ancestor:N Forward to Nth ancestor Skip intermediate services

Inheritance Tree Example

A concrete example of a 3-level service hierarchy

Use Case: Global Analytics Platform

A multinational company deploys an analytics service across regions. The root service GLOBAL-ANALYTICS provides core functionality. Regional services inherit and customize for local regulations and languages.

+
Inheritance Principle: Each child service automatically inherits all parent capabilities, plus adds its own new features or overrides specific parent methods. A country service like FR-ANALYTICS has the full power of GLOBAL-ANALYTICS + EMEA-ANALYTICS + its own French-specific logic.
GLOBAL-ANALYTICS
Root Service
Core analytics engine, ML models, base API
~45 MB | 120 endpoints
EMEA-ANALYTICS
Europe Region
+ GDPR compliance, EU data residency
~52 MB | 135 endpoints
4 derivatives
APAC-ANALYTICS
Asia-Pacific
+ Multi-language, local cloud
~50 MB | 130 endpoints
3 derivatives
LATAM-ANALYTICS
Latin America
+ Spanish/Portuguese, LGPD
~48 MB | 125 endpoints
No derivatives
FR-ANALYTICS
France
~55 MB | 142 ep
DE-ANALYTICS
Germany
~54 MB | 140 ep
UK-ANALYTICS
United Kingdom
~56 MB | 145 ep
IT-ANALYTICS
Italy
~53 MB | 138 ep
JP-ANALYTICS
Japan
~54 MB | 140 ep
AU-ANALYTICS
Australia
~52 MB | 135 ep
SG-ANALYTICS
Singapore
~53 MB | 137 ep
Direct deployment
No regional customization needed
1 Root Service
3 Regional Services
7 Country Services
11 Total Services

FR-ANALYTICS sox-manifest.json

{
  "version": "1.0.0",
  "complianceLevel": 2,
  "dataClassification": "confidential",
  "proxy": {
    "enabled": true,
    "parent_sku": "EMEA-ANALYTICS",
    "rules": [
      { "method": "analyze_french_market", "target": "local" },
      { "method": "get_global_config", "target": "root" },
      { "method": "*", "target": "parent" }
    ]
  }
}

Compliance Levels

Choose the right level of compliance for your needs

Level 1

Basic
  • Basic audit logging
  • Standard encryption (AES-128)
  • 30-day retention
  • Public data classification
  • Email notifications

Level 3

Enterprise
  • Immutable audit logs
  • HSM encryption keys
  • 7-year retention
  • Restricted classification
  • SOC 2 Type II
  • Custom compliance

Real-World Use Cases

How enterprises use SOX Light

🌎

Regional Derivatives

EU-001 (Europe) derives to FR-001 (France) derives to QC-001 (Quebec). Each region inherits base functionality while adding local customizations.

💰

White-Label Services

Create branded versions of your API for resellers. Each derivative maintains its own pricing, branding, and custom endpoints.

📊

A/B Testing

Fork a service to test new algorithms. Route traffic between parent and derivative, compare results, merge or discard.

💻

Version Migration

Create v2 as a derivative of v1. Gradually move methods to local while falling back to parent for unchanged endpoints.

🏭

Multi-Tenant SaaS

Base service handles core logic. Each tenant gets a derivative with custom configurations, integrations, and branding.

📜

Compliance Isolation

Create derivatives with higher compliance levels for regulated industries. Same API, stronger guarantees.

Multi-Parent Inheritance (V2)

Inherit from multiple parents with full audit control

WHITEBOX
EMEA-ANALYTICS
Regional analytics (overridable)
BLACKBOX
PAYMENT-GW
Payment API (fixed contract)
BLACKBOX
GLOBAL-AUTH
Authentication (fixed contract)
chain
direct!
direct!
FR-CHECKOUT
French checkout service with 3 parents

Two Forward Modes

Chain Mode (Default)

SOX Compliant - Full audit trail

  • Routes through all intermediaries
  • Each hop logs the request
  • Supports transformations
  • Complete traceability
target: "parent:EMEA"

Direct Mode (!)

Performance - Minimal latency

  • Bypasses intermediaries
  • Direct call to target
  • Use for blackbox APIs
  • audit_broken flag set
target: "parent:PAYMENT!"

Parent Types

Type Override Transform Use Case
whitebox Yes Yes Internal services, same domain
blackbox No No Payment, Auth, external APIs

Multi-Parent sox-manifest.json (V2)

{
  "version": "2.0.0",
  "complianceLevel": 2,
  "proxy": {
    "enabled": true,
    "parents": [
      { "sku": "EMEA-ANALYTICS", "type": "whitebox", "endpoint": "https://emea.panglot.com" },
      { "sku": "PAYMENT-GW", "type": "blackbox", "endpoint": "https://pay.panglot.com" },
      { "sku": "GLOBAL-AUTH", "type": "blackbox", "endpoint": "https://auth.panglot.com" }
    ],
    "default_mode": "chain",
    "rules": [
      { "method": "EMEA-ANALYTICS.get_data", "target": "parent:EMEA-ANALYTICS", "mode": "chain" },
      { "method": "PAYMENT-GW.process!", "target": "parent:PAYMENT-GW", "mode": "direct" },
      { "method": "validate_token", "target": "parent:GLOBAL-AUTH", "mode": "direct" }
    ]
  }
}

Circular Call Protection

Automatic detection and prevention of infinite loops in service chains

SKU1
.method()
SKU2
.method()
SKU3
.method() BLOCKED
SKU1 508

How It Works

1

Call Chain Tracking

Each request carries an X-Sox-Call-Chain header with the complete call path

2

Pre-Forward Validation

Before forwarding, the proxy checks if the target SKU is already in the chain

3

Depth Limit (50 max)

Maximum inheritance depth to prevent stack overflow and DoS attacks

4

Audit Logging

All cycle attempts are logged with circular_call: true for security analysis

HTTP 508 Loop Detected Response

{
  "error": "circular_call_detected",
  "message": "circular call detected: SKU1 -> SKU2 -> SKU3 -> SKU1",
  "chain": ["SKU1", "SKU2", "SKU3"],
  "target": "SKU1",
  "method": "process_data",
  "request_id": "1737500000-456"
}

Built-in Observability

Full visibility into your service inheritance

📈

Inheritance Tree Visualization

Interactive tree view showing all services and their relationships. See the full lineage from any node. Switch between tree and linear views.

📊

Prometheus Metrics

Built-in metrics for proxy requests, cache hits, forward latency, and error rates. Integrate with Grafana dashboards.

🗒

JSON Structured Logs

Every forwarded request is logged with method, target, duration, and status. Full request tracing across the inheritance chain.

🔔

Real-time Alerts

Get notified when parent services fail, when compliance violations occur, or when derivatives drift from their parents.

Ready for Enterprise Compliance?

Start with SOX Light and gain full control over your service architecture.