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, aksiA(ctx, resource_id)hanya diizinkan menghasilkan transisi sukses jika dan hanya jikaresource.tenant_id == ctx.tenant_iddanctx.authenticated == True. Jikaresource.tenant_id != ctx.tenant_id, sistem wajib mengembalikan status penolakan (HTTP 403 atau 404) dan statusStidak 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-IDyang berbeda dengan klaimtenant_iddi 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_ideksplisit 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.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!