Kebocoran data antar-tenant (cross-tenant data leakage) dan Insecure Direct Object Reference (IDOR) sering kali lolos dari pengujian unit konvensional. Unit test biasa umumnya hanya menguji jalur eksekusi yang diantisipasi pengembang dengan input statis. Terinspirasi dari pendekatan formal verification engine isolasi AWS EC2 yang membuktikan pemisahan virtual machine secara matematis, kita dapat menerapkan prinsip spesifikasi invarian dan property-based testing (PBT) langsung pada kontrak API autentikasi dan otorisasi.

Prinsip Isolasi Tenant Berbasis Model State Machine

Pondasi dari verifikasi formal adalah mendefinisikan sistem sebagai mesin status (state machine). Pada arsitektur multi-tenant, setiap request API dipandang sebagai transisi status S → S' melalui aksi A yang dieksekusi oleh subjek dalam konteks tenant tertentu.

Secara matematis, sistem memiliki invariant isolasi utama:

Tenant Isolation Invariant: Untuk setiap status S, aksi A(ctx, resource_id) hanya diizinkan menghasilkan transisi sukses jika dan hanya jika resource.tenant_id == ctx.tenant_id dan ctx.authenticated == True. Jika resource.tenant_id != ctx.tenant_id, sistem wajib mengembalikan status penolakan (HTTP 403 atau 404) dan status S tidak boleh berubah.

Pelanggaran terhadap invariant ini menandakan adanya authorization bypass atau cacat pada boundary context token yang disematkan middleware.

Spesifikasi Invariant dan Edge Cases Bypass Token Context

Celah isolasi sering terjadi pada celah konseptual antara layer middleware dan handler endpoint:

  • Header Spoofing / Injeksi Objek: Klien mengirimkan X-Tenant-ID yang berbeda dengan klaim tenant_id di dalam payload JWT terverifikasi.
  • Path Parameter Desynchronization: Handler mengeksekusi query database menggunakan ID resource dari URL (misal /api/v1/tenants/A/documents/123) tetapi middleware hanya memvalidasi hak akses subjek pada tenant dokumen tersebut tanpa mencocokkan route binding.
  • Shared Resource Pollution: Akses global cache key atau shared database table tanpa partisi tenant_id eksplisit pada level query engine.

Implementasi Model Spesifikasi Menggunakan Python Hypothesis

Kita dapat memodelkan kontrak otorisasi ini menggunakan pustaka property-based testing hypothesis. Alih-alih menguji satu ID, hypothesis mengeksplorasi ribuan kombinasi status token, ID resource, dan kepemilikan tenant untuk mencari serangan atau celah edge case (falsification).

from dataclasses import dataclass
from typing import Optional
import pytest
from hypothesis import given, strategies as st

@dataclass(frozen=True)
class SecurityContext:
    tenant_id: str
    user_id: str
    is_authenticated: bool

@dataclass(frozen=True)
class DocumentResource:
    id: str
    tenant_id: str
    data: str

class AuthorizationEngine:
    @staticmethod
    def authorize_access(ctx: SecurityContext, resource: Optional[DocumentResource]) -> bool:
        if not ctx.is_authenticated:
            return False
        if resource is None:
            return False
        # Invariant check: Boundary resource tenant WAJIB identik dengan context token
        return ctx.tenant_id == resource.tenant_id

# Generator data acak untuk property testing
tenant_ids = st.uuids().map(str)
user_ids = st.uuids().map(str)

@given(
    ctx_tenant=tenant_ids,
    res_tenant=tenant_ids,
    user_id=user_ids,
    is_auth=st.booleans(),
    doc_id=st.uuids().map(str),
    payload=st.text()
)
def test_tenant_isolation_invariant(
    ctx_tenant: str,
    res_tenant: str,
    user_id: str,
    is_auth: bool,
    doc_id: str,
    payload: str
):
    ctx = SecurityContext(tenant_id=ctx_tenant, user_id=user_id, is_authenticated=is_auth)
    resource = DocumentResource(id=doc_id, tenant_id=res_tenant, data=payload)
    
    is_allowed = AuthorizationEngine.authorize_access(ctx, resource)

    # Formal assertions
    if not is_auth:
        assert not is_allowed, "Unauthenticated context must never access resources"
    elif ctx_tenant != res_tenant:
        assert not is_allowed, "Cross-tenant access violation: Tenant boundary breached"
    else:
        assert is_allowed, "Authorized tenant member must be granted access"

Pencegahan IDOR pada Level Kontrak API

Untuk mencegah pengembang melewatkan filter tenant di handler database, enforce boundary tenant melalui guard context sebelum handler dieksekusi. Jangan biarkan SQL query bergantung pada filter parameter manual seperti WHERE id = :id.

Gunakan pendekatan Guarded Token Context di mana parameter identitas resource wajib di-resolve bersama context tenant:

# Desain handler rentan IDOR:
# SELECT * FROM documents WHERE id = :document_id; (Risiko data tenant lain terambil)

# Kontrak API yang terverifikasi aman:
def get_document_secure(ctx: SecurityContext, document_id: str, db_session) -> DocumentResource:
    # Query terisolasi secara struktural pada database boundary
    resource = db_session.query(DocumentResource).filter(
        DocumentResource.id == document_id,
        DocumentResource.tenant_id == ctx.tenant_id
    ).first()
    
    if not resource:
        # Kembalikan 404 seragam: jangan bedakan antara not found vs unauthorized
        # guna mencegah enumerasi resource ID oleh penyerang.
        raise ResourceNotFoundException()
        
    return resource

Integrasi Verifikasi Invariant pada Pipeline CI/CD

Verifikasi formal berbasis PBT dapat dijalankan secara deterministik di pipeline CI. Karena pengujian berbasis state machine membutuhkan variasi kasus yang tinggi, konfigurasikan test runner agar mengeksekusi minimum 1.000 iterasi transisi per test case.

# Contoh eksekusi pada GitHub Actions / GitLab CI runner
- name: Run Formal Invariant Tests
  run: |
    pytest tests/invariants/ \
      --hypothesis-profile=ci \
      --hypothesis-seed=20260408 \
      --hypothesis-max-examples=1000

Penggunaan parameter seed menjamin jika ditemukan pelanggaran invariant, urutan input penyebab kegagalan dapat direproduksi secara konsisten di komputer lokal pengembang untuk debugging langsung.