Harita UI (User Interface) ile Vendor API (Application Programming Interface) Arasında Trust Boundary (Harita UI Ve Vendor API Guven Siniri)

Harita UI (User Interface) ile Vendor API (Application Programming Interface) Arasında Trust Boundary

Tarayıcıya vendor anahtarı vermeyin. Never call the telematics vendor directly from the browser for privileged feeds; keep trust at your API edge.

browser map ← your API ← telematics vendor

Tarayıcıya vendor anahtarı vermeyin.

Kavramlar ilk geçtiği yerde

📦 Geofence
Haritada tanımlı coğrafi sınır; daire için merkez + yarıçap.

📦 Telematics Feed
Araç konum/ignition verisini sağlayan dış telemetri kaynağı.

📦 km_metric
API'den gelen kilometre cinsinden yarıçap; haritada metreye çevrilir.

📦 Operational State
Operatörün karar verdiği bekleme durumu; ham GPS'ten farklıdır.

Bu kavramları ayırt edemeyen ekip, UI ile entegrasyon sınırını karıştırır.

Problemin şekli

Never call the telematics vendor directly from the browser for privileged feeds; keep trust at your API edge.

browser map ← your API ← telematics vendor

Çalışan ayrım

Tarayıcıya vendor anahtarı vermeyin.

browser map ← your API ← telematics vendor
        ↓
   explicit contract

Üretimde kırılan yer

Sözleşme veya yarıçap/kimlik/deploy varsayımları gizlendiğinde incident büyür. Görünür sözleşme, görünür geri alma.

Bu bölümde en çok karışan eşleştirmeler

❌ Her şey tek uygulamada daha güvenli
✓ Sınırlar net değilse tek uygulama daha kırılgandır

❌ Konfigürasyon kodda hardcoded kalsın
✓ Yarıçap, remote URL ve expose path operasyonel kontratlardır

❌ Vendor/API gerçeği UI state'tir
✓ Vendor feed kanıt, ops state karardır

Kendi sisteminizi denetleme listesi

1. Bu yüzeyin sahiplik sınırını bir cümleyle yazın.
2. Hangi kontrat değişirse kim deploy eder?
3. Timeout veya vendor gecikmesinde UI ne gösterir?
4. Standalone ve gömülü senaryoları ayrı test ediyor musunuz?
5. Deny-list: içerikte firma/vendor domain sızıntısı var mı?

Bu bölümden aklında kalması gerekenler

1. Sözleşme görünür olmalıdır: expose path, yarıçap, ticket durumu veya remote URL.
2. UI ile dış sistem arasındaki boşluk tasarım kararıdır, bug değil.
3. Bağımsız deploy, bağımsız geri alma demektir.

Gizlediğiniz sınır, üretimde sizi bulur.