Siber Güvenlik
API BOLA Testi: BOLA/IDOR Yetkilendirme Hataları Nasıl Test Edilir?

API BOLA testi, bir uygulama programlama arayüzünün (API) gelen isteklerdeki nesne kimliklerini (ID, UUID, dosya adı veya hesap numarası gibi) işlerken, isteği gönderen kimliği doğrulanmış kullanıcının ilgili nesne üzerinde o işlemi yapmaya gerçekten yetkili olup olmadığını sunucu tarafında doğrulayıp doğrulamadığını kontrol etme sürecidir. Yetkili test ortamında gerçekleştirilen bu değerlendirmede, farklı kullanıcı hesapları ve rolleri arasında kontrollü test nesneleri oluşturularak yatay ve dikey erişim sınırlarının korunup korunmadığı ölçülür.
Modern web ve mobil uygulamalar iş mantığının büyük bölümünü istemci tarafına taşırken, arka uç (backend) sistemleriyle iletişimi REST, GraphQL veya gRPC tabanlı API'ler üzerinden yürütür. Bu mimaride istemci ile sunucu arasındaki durum (state) takibi çoğunlukla istemcinin gönderdiği nesne referanslarına dayanır. Eğer sunucu katmanı her nesne erişiminde sahiplik ve yetki politikasını yeniden doğrulamazsa, saldırganların yalnızca istekteki bir kimlik bilgisini değiştirerek başka kullanıcılara veya farklı kurumlara ait verilere erişmesi mümkün hale gelir.
BOLA, IDOR ve API Yetkilendirmesi Arasındaki İlişki
API güvenliği alanında en sık birbirine karıştırılan iki kavram Broken Object Level Authorization (BOLA) ve Insecure Direct Object Reference (IDOR) terimleridir. Teknik literatürde bu iki kavram aynı kök nedene —eksik veya hatalı yetkilendirme kontrolüne— dayansa da tarihsel gelişimleri ve ifade ettikleri mimari odak noktaları farklıdır.
Insecure Direct Object Reference (IDOR), OWASP Web Security Testing Guide (WSTG-ATHZ-04) kapsamında tanımlanan ve uygulamanın kullanıcı tarafından sağlanan girdiyi (örneğin bir URL parametresi veya form alanı) doğrudan bir veritabanı kaydına, dosyaya ya da sistem kaynağına erişmek için kullanması durumunda ortaya çıkan zafiyeti ifade eder. Buradaki vurgu, doğrudan nesne referansının istemci tarafından manipüle edilebilmesidir.
Broken Object Level Authorization (BOLA) ise OWASP API Security Top 10 (API1:2023) listesinde birinci sırada yer alan ve sorunu doğrudan yetkilendirme mekanizmasının eksikliği çerçevesinde tanımlayan kavramdır. OWASP API Security Top 10 (2023) standardına göre BOLA; bir nesne kimliği alan ve bu nesne üzerinde herhangi bir işlem gerçekleştiren API uç noktasının, oturum açmış kullanıcının talep edilen nesne üzerinde ilgili eylemi yapma iznine sahip olup olmadığını doğrulamamasıdır. Kısacası IDOR, referansın doğrudan manipülasyon biçimini tanımlarken; BOLA, API ekosistemindeki nesne düzeyinde yetkilendirme kusurunun mimari adını koyar.
Bu farkı somutlaştırmak için basit bir ayrım yapabiliriz:
- Meşru Nesne Erişimi: Oturum açmış olan Kullanıcı A, kendi hesabına ait olan
GET /api/v1/invoices/8401isteğini gönderir. Sunucu, oturum belirtecindeki (token) kullanıcı kimliği ile8401numaralı faturanın sahibi olan kullanıcı kimliğini karşılaştırır; eşleşme sağlandığı için faturayı döndürür. - Yetkisiz Nesne Erişimi (BOLA): Kullanıcı A, kendi geçerli oturum belirtecini koruyarak isteği
GET /api/v1/invoices/8402olarak değiştirir.8402numaralı fatura Kullanıcı B'ye veya çok kiracılı (multi-tenant) bir SaaS platformunda tamamen farklı bir şirkete (Tenant Y) aittir. Sunucu yalnızca Kullanıcı A'nın geçerli bir oturumu olup olmadığına bakar, ancak8402numaralı nesnenin Kullanıcı A'ya ait olup olmadığını denetlemezse fatura verisini döndürür.
BOLA, Kimlik Doğrulama Açığı, BFLA ve BOPLA Nasıl Ayrılır?
Sağlıklı bir API yetkilendirme testi yürütebilmek için BOLA'yı komşu yetkilendirme ve kimlik doğrulama zafiyetlerinden net biçimde ayırmak gerekir. Yanlış sınıflandırma, geliştirme ekiplerine hatalı düzeltme önerileri verilmesine yol açar.
- Broken Authentication (API2:2023) ile Farkı: Kimlik doğrulama (authentication), "İsteği gönderen kişi iddia ettiği kişi mi?" sorusunu yanıtlar. BOLA senaryosunda saldırganın geçerli bir hesabı ve geçerli bir erişim belirteci (JWT, API anahtarı veya oturum çerezi) vardır; yani kimlik doğrulama aşaması başarıyla geçilmiştir. Sorun, kimliği doğrulanmış kullanıcının kapsamı dışındaki bir nesneye erişebilmesidir.
- Broken Function Level Authorization – BFLA (API5:2023) ile Farkı: BOLA'da kullanıcının ilgili API uç noktasını (örneğin
/api/v1/orders/{id}) çağırmaya zaten yetkisi vardır; ihlal, o uç nokta üzerinden başka birine ait nesneye erişilmesiyle gerçekleşir. Broken Function Level Authorization (BFLA) durumunda ise kullanıcı, rolü veya ayrıcalık seviyesi gereği hiç erişmemesi gereken bir işlevi/uç noktayı çağırabilmektedir. Örneğin standart bir kullanıcının yönetici rolüne özel olanDELETE /api/v1/admin/users/8402veyaPOST /api/v1/reports/export-allişlevini çalıştırabilmesi BFLA kapsamına girer. - Broken Object Property Level Authorization – BOPLA (API3:2023) ile Farkı: BOPLA, kullanıcının erişmeye yetkili olduğu bir nesnenin içindeki belirli alanlara (property) yönelik okuma veya yazma yetkisinin denetlenmemesidir. Örneğin Kullanıcı A, kendi profil nesnesini (
PATCH /api/v1/users/me) güncellemeye yetkilidir; ancak istek gövdesine"role": "admin"veya"credit_limit": 999999gibi değiştirmemesi gereken nesne özelliklerini ekleyerek bunları güncelleyebiliyorsa (eski adıyla Mass Assignment) ya da sunucu yanıtında görmemesi gereken dahili alanları alıyorsa (Excessive Data Exposure) bu durum BOPLA olarak değerlendirilir.
BOLA'nın İş ve Güvenlik Etkileri
OWASP API Security Top 10 (2023) değerlendirmesinde BOLA, tespit edilebilirliğinin görece kolay ve yaygınlığının yüksek olması nedeniyle kritik bir risk kategorisinde konumlandırılır. Bir API'de nesne düzeyinde yetkilendirme eksikliği bulunması halinde ortaya çıkabilecek olası teknik ve iş etkileri uç noktanın işlevine göre değişkenlik gösterir:
- Yetkisiz Bilgi İfşası (Okuma /
**GET**): Müşteri kişisel verileri (PII), fatura detayları, sağlık kayıtları, finansal hareketler, özel mesajlaşmalar veya kurum içi belgeler yetkisiz kişilerce görüntülenebilir. Çok kiracılı (multi-tenant) B2B uygulamalarda tenant izolasyonu kırıldığında, bir müşteri kurum diğer rakip kurumların ticari verilerine ulaşabilir. - Yetkisiz Veri Değiştirme (Yazma /
**PUT**,**PATCH**,**POST**): Saldırgan başka bir kullanıcının teslimat adresini, iletişim e-postasını, sipariş içeriğini veya onay durumunu değiştirebilir. OWASP API1:2023 senaryolarında belirtildiği üzere, parola sıfırlama veya e-posta güncelleme akışlarında nesne düzeyinde yetkilendirme eksikliği varsa bu durum tam hesap ele geçirmeye (account takeover) kadar uzanabilir. - Yetkisiz Veri Silme veya İşlem Tetikleme (
**DELETE**,**POST**): Başka kullanıcılara ait kayıtların silinmesi, aboneliklerin iptal edilmesi veya fiziksel/dijital cihaz komutlarının (örneğin bağlantılı bir cihazın kilidinin açılması ya da bir ödeme talimatının tetiklenmesi) yetkisiz biçimde çalıştırılması gibi iş sürekliliğini doğrudan etkileyen sonuçlar doğabilir.
Her BOLA bulgusunun aynı etki seviyesinde olmadığını unutmamak gerekir. Yalnızca herkese açık olması planlanan bir profil takma adını döndüren uç nokta ile finansal işlem geçmişini değiştiren uç noktanın iş etkisi birbirinden tamamen farklıdır. Bu nedenle değerlendirme sırasında olası etki, uygulamanın veri sınıflandırması ve iş mantığı bağlamında somutlaştırılmalıdır.
Test Öncesi Kapsam ve İzin Çerçevesi
Yetkilendirme testleri doğrudan veri erişim sınırlarını sınadığı için, gerçek üçüncü taraf sistemlerde veya izinsiz ortamlarda deneme yapmak hem hukuki sorumluluk doğurur hem de üretim verilerinin bütünlüğünü tehlikeye atar. Profesyonel bir API pentest veya kurum içi güvenlik değerlendirmesi öncesinde aşağıdaki yönetişim koşullarının yazılı olarak netleştirilmesi gerekir:
- Yazılı Yetki ve Test Kapsamı: Test edilecek API alan adları (
api.test.ornekfirma.localgibi), API sürümleri (/v1,/v2), dahil edilen mikroservisler ve kesinlikle kapsam dışı bırakılan (out-of-scope) üçüncü taraf entegrasyonlar (ödeme geçitleri, harici kimlik sağlayıcılar vb.) yazılı onay belgesinde tanımlanmalıdır. - Ortam Seçimi: Mümkün olan her durumda testler üretim (production) ortamı yerine, üretimle aynı yetkilendirme mantığına ve yapılandırmaya sahip izole bir hazırlık (staging) veya QA ortamında yürütülmelidir. Zorunlu olarak üretim ortamında sınırlı doğrulama yapılacaksa, test yalnızca bu amaçla oluşturulmuş sentetik test hesapları ve test nesneleriyle sınırlandırılmalıdır.
- Kontrollü Test Hesapları ve Test Nesneleri: Başka gerçek kullanıcıların verilerine dokunmamak için en az iki ayrı standart kullanıcı hesabı (Test Kullanıcısı A ve Test Kullanıcısı B), varsa farklı kiracılara ait hesaplar (Tenant 1 ve Tenant 2) ile farklı yetki seviyelerindeki roller (örneğin standart üye, ekip yöneticisi, salt okunur denetçi) önceden tanımlanmalıdır. Her hesabın altında yalnızca test için üretilmiş örnek kayıtlar bulunmalıdır.
- Test Penceresi ve İletişim Kişisi: Testin hangi tarih ve saat aralığında yapılacağı, test sırasında beklenmedik bir hata veya performans düşüşü yaşanırsa doğrudan ulaşılacak teknik sorumlu (acil durum kontağı) ve test kaynak IP adresleri belirlenmelidir.
- Durdurma Koşulları (Stop Conditions): Test sırasında üretim verisine temas riski oluşması, arka plan iş kuyruklarının kilitlenmesi, e-posta/SMS bildirim fırtınası tetiklenmesi veya beklenmeyen bir veri bozulması gözlemlenmesi halinde testin derhal durdurulup sistem sahibine bildirileceği kurallar baştan kararlaştırılmalıdır.
API BOLA Testi Ön Hazırlığı
Etkili bir API BOLA testi rastgele parametre değiştirerek değil, uygulamanın nesne modelini ve yetkilendirme kurallarını anlayarak başlar. Hazırlık aşamasında şu teknik bileşenler toplanmalıdır:
- API Envanteri ve Sözleşmeler: OpenAPI (Swagger) tanımları, Postman koleksiyonları, GraphQL şemaları (introspection aktifse veya şema dosyası paylaşıldıysa) ve istemci uygulamanın (web arayüzü veya mobil uygulama) ürettiği gerçek ağ trafiği incelenerek tüm uç noktalar listelenir. Eski veya belgelenmemiş sürüm uç noktaları (
/api/v1/...yanında açık kalan/api/beta/...gibi) özellikle envantere dahil edilir. - Roller ve Nesne Sahipliği Haritası: Sistemdeki varlıklar (kullanıcı, sipariş, fatura, proje, dosya, destek talebi) ile roller arasındaki ilişkiler çıkarılır. Hangi rolün hangi nesneyi oluşturabileceği, okuyabileceği, güncelleyebileceği, paylaşabileceği ve silebileceği iş kurallarına göre not edilir.
- Oturum ve Belirteç Yönetimi: API'nin kimlik ve yetki bağlamını nasıl taşıdığı incelenir. JSON Web Token (JWT), opak erişim belirteçleri (OAuth 2.0 Bearer Token), API anahtarları veya oturum çerezlerinin geçerlilik süreleri ve yenileme (refresh) mekanizmaları test araçlarında (örneğin Burp Suite Repeater/Autorize veya OWASP ZAP) sorunsuz çalışacak şekilde yapılandırılır.
- Sentetik Veri Hazırlığı: Test Kullanıcısı A ve Test Kullanıcısı B hesaplarıyla normal uygulama akışları kullanılarak kendi nesneleri oluşturulur ve bu nesnelerin kimlik değerleri (ID, UUID, slug vb.) bir eşleştirme tablosuna kaydedilir.
Adım Adım API BOLA Testi Yöntemi
OWASP Web Security Testing Guide (WSTG-APIT-02 ve WSTG-ATHZ-04) metodolojisini esas alan güvenli ve tekrarlanabilir test süreci yedi temel adımdan oluşur:
1. Nesne Referansı Taşıyan Uç Noktaları ve Parametreleri Belirleme
Toplanan API trafiği ve dokümantasyon üzerinden bir nesneyi işaret eden tüm uç noktalar işaretlenir. Yalnızca sayısal artan kimlikler (1001, 1002) değil; UUID/GUID değerleri, kullanıcı adları, e-posta adresleri, dosya adları, sipariş kodları ve Base64 ile kodlanmış referanslar da inceleme kapsamına alınır.
2. Kontrollü Test Hesapları ve Sahiplik Eşleşmeleri Oluşturma
Test Kullanıcısı A oturumuyla Nesne_A1 (örneğin bir taslak sipariş veya özel belge), Test Kullanıcısı B oturumuyla Nesne_B1 oluşturulur. Çok kiracılı mimarilerde Tenant 1 altındaki bir kullanıcı ile Tenant 2 altındaki bir kullanıcı için ayrı nesneler üretilir. Böylece test uzmanı gerçek kullanıcı verilerine yönelmeden, sahipliği kesin olarak bilinen hedefler üzerinde çalışır.
3. Temel (Baseline) İstekleri Kaydetme
Her iki kullanıcının da kendi yetkili olduğu nesneye eriştiği başarılı istek ve yanıt çiftleri kaydedilir:
- Kullanıcı A ->
Nesne_A1erişimi (Beklenen durum: Yetkili erişim başarılı). - Kullanıcı B ->
Nesne_B1erişimi (Beklenen durum: Yetkili erişim başarılı).
Bu temel kayıtlar, daha sonra yetkisiz denemelerden dönecek yanıtların uzunluğunu, yapısını ve HTTP durum kodunu karşılaştırmak için referans noktası oluşturur.
4. Nesne Referanslarını Çapraz Olarak Test Etme
Kullanıcı A'nın geçerli oturum belirteci korunurken, istekteki Nesne_A1 referansı yalnızca Test Kullanıcısı B'ye ait olan Nesne_B1 referansı ile değiştirilir. Aynı işlem ters yönde (Kullanıcı B oturumuyla Nesne_A1 referansı kullanılarak) ve farklı roller/tenant'lar arasında tekrarlanır. Geniş ölçekli kimlik taraması (enumeration) yerine, sahipliği bilinen test nesneleri arasında hedefli doğrulama yapılır.
5. HTTP Durum Kodunun Ötesinde Yanıtı ve Yan Etkileri Analiz Etme
API BOLA testi sırasında yalnızca HTTP yanıt koduna bakmak yanıltıcı sonuçlara yol açabilir:
- Yanıt Gövdesi (Response Body): Sunucu
200 OKdöndürüyor ancak gövdede boş bir dizi ([]),nullveya"data": nullveriyorsa ortada bir veri sızıntısı olmayabilir. Buna karşılık, sunucu hata kodu gibi görünen bir yanıtın içinde Nesne_B1'e ait meta verileri (örneğin dosya boyutu, sahibi veya oluşturulma tarihi) sızdırıyor olabilir. - 403 vs. 404 Davranışı: Bir uygulamanın yetkisiz nesne erişiminde mutlaka
403 Forbiddenveya mutlaka404 Not Founddöndürmesi yönünde evrensel bir zorunluluk yoktur. OWASP IDOR Prevention Cheat Sheet dokümanında vurgulandığı üzere, kaynağın varlığının dahi gizli tutulması gereken durumlarda (örneğin belirli bir e-posta adresinin sistemde kayıtlı olup olmadığının anlaşılmaması için) yetkisiz erişim ile var olmayan kaynağın aynı404 Not Foundyanıtına eşlenmesi tercih edilebilir. Önemli olan yanıt kodunun adı değil, yetkisiz erişimin engellenmesi ve varlık bilgisinin (existence oracle) istemciye sızdırılmamasıdır. - Yan Etkiler (Side Effects): Özellikle durum değiştiren isteklerde yanıt gövdesi boş dönse bile işlem arka planda gerçekleşmiş olabilir. Bu nedenle test sonrasında Kullanıcı B oturumuyla
Nesne_B1yeniden kontrol edilerek veride değişiklik olup olmadığı doğrulanır.
6. Salt Okunur Kontrolden Yazma ve Silme Testlerine Geçiş
Test her zaman en düşük riskli işlemler olan salt okunur (GET veya GraphQL query) uç noktalarla başlatılır. Yazma (POST, PUT, PATCH) ve silme (DELETE veya GraphQL mutation) testleri yalnızca:
- Yazılı kapsam onayında bu HTTP yöntemlerine izin veriliyorsa,
- Hedef nesne yalnızca bu test için oluşturulmuş sentetik bir test kaydıysa ve
- İşlem başka test akışlarını veya paylaşılan sistem bileşenlerini bozmayacaksa uygulanır.
7. Tekrar Üretilebilirlik, Kanıt Toplama ve Temizlik
Bir yetkilendirme eksikliği tespit edildiğinde, bulgunun tesadüfi olmadığını göstermek için istek bir kez daha tekrarlanır. Ekran görüntüsü ve HTTP istek/yanıt kayıtları alınırken belirteç değerleri ve gereksiz test verileri maskelenir. Test tamamlandığında oluşturulan sentetik test nesneleri temizlenir ve ortam ilk durumuna getirilir.
İncelenmesi Gereken Başlıca Test Yüzeyleri
Modern API mimarilerinde nesne referansları yalnızca URL yolunda yer almaz. Kapsamlı bir IDOR güvenlik testi sırasında aşağıdaki tüm giriş yüzeyleri sistematik olarak değerlendirilmelidir:
- URL Yolu (Path Parameters): En yaygın yüzeydir. Örnek:
GET /api/v2/organizations/org_101/projects/proj_505. Burada hem üst nesne (org_101) hem de alt nesne (proj_505) ayrı ayrı manipüle edilmelidir; çünkü bazı uygulamalar proje kimliğini kontrol ederken organizasyon kimliğindeki yatay geçişi gözden kaçırabilir. - Sorgu Parametreleri (Query Strings): Filtreleme, sayfalama veya dışa aktarma uç noktalarında görülür. Örnek:
GET /api/v2/reports/export?accountId=2002&format=csv. - İstek Gövdesi (JSON / XML / Form Payload): Özellikle
POST,PUTvePATCHisteklerinde nesne kimliği URL yerine gövde içinde taşınabilir. Örnek:{"targetDocumentId": "doc-9921", "comment": "Test notu"}. İç içe geçmiş (nested) JSON dizilerindeki nesne referansları sıkça gözden kaçan test noktalarıdır. - Özel HTTP Üstbilgileri (Custom Headers): Çok kiracılı sistemlerde veya API ağ geçitlerinde (API Gateway) kiracı ya da profil bağlamı
X-Tenant-ID,X-Account-IDveyaX-On-Behalf-Ofgibi üstbilgilerle taşınabilir. Sunucu bu üstbilgiyi JWT içindeki yetkili kiracı listesiyle doğrulamıyorsa ciddi bir tenant izolasyonu zafiyeti oluşur. - Dosya ve Asenkron İş Kaydı Referansları: Rapor oluşturma, toplu içe/dışa aktarma veya medya yükleme süreçlerinde sistem istemciye bir görev kimliği (
jobId) ya da indirme anahtarı (GET /api/v2/downloads/tmp_report_8841.pdf) döndürür. Asenkron iş kuyruklarının sonuç uç noktalarında nesne sahipliği kontrolü sıklıkla unutulur. - GraphQL Sorgu ve Mutasyon Değişkenleri: Tek bir
/graphqluç noktası üzerinden çalışan API'lerde nesne referanslarıvariablesbloğu içinde veya doğrudan sorgu argümanlarında yer alır. Ayrıca GraphQL'denode(id: "...")gibi genel arayüzler (Global Object Identification) veya ilişkili alt nesneler (user { orders { invoice { id } } }) üzerinden doğrudan uç noktada uygulanan yetki kontrolü atlatılabilir.
API Yetkilendirme Testi için Yetki Matrisi
Test öncesinde ve sırasında hangi erişim senaryolarının deneneceğini standartlaştırmak için aşağıdaki yetki matrisi referans alınabilir:
| Kontrol Kategorisi | Test Senaryosu | Test Edilen İlişki | Beklenen Güvenli Davranış | Tipik BOLA / Yetki Hatası Belirtisi |
|---|---|---|---|---|
| Yatay Erişim (Horizontal) | Kullanıcı A, aynı roldeki Kullanıcı B’ye ait nesneyi görüntüler veya düzenler. | Aynı rol, farklı nesne sahibi | Erişim reddedilir (403/404), veri dönmez veya değişmez. | Kullanıcı B’nin verisi 200 OK ile döner ya da güncellenir. |
| Kiracı Sınırı (Tenant Isolation) | Tenant 1 yöneticisi, Tenant 2 içindeki bir nesne ID’sini sorgular. | Farklı organizasyon / kiracı sınırları | İstek oturumun kiracı bağlamıyla sınırlandırılır, erişim engellenir. | Farklı şirkete ait kayıtlar listelenir veya okunur. |
| Dikey / Rol Sınırı | Standart üye, kendi ekibindeki yöneticiye özel nesneye veya işleme erişir. | Aynı organizasyon, farklı yetki seviyesi | Rol politikası nesne üzerinde yetkisiz işlemi engeller. | Standart kullanıcı yönetici onaylı nesneyi değiştirebilir. |
| Paylaşılan Nesne Erişimi | Erişim izni sonradan kaldırılmış eski işbirlikçi, önceden bildiği nesne ID’sini çağırır. | Dinamik paylaşım / erişim iptali (revocation) | İptal anında nesne erişimi sunucu tarafında kesilir. | Önbellek veya eksik kontrol nedeniyle eski link çalışmaya devam eder. |
| Alt Nesne / İlişkili Kayıt | Kullanıcı A, kendi sipariş ID’si içine Kullanıcı B’nin adres veya ödeme yöntemi ID’sini ekler. | Üst nesne yetkili, referans verilen alt nesne yetkisiz | Bağlanan alt nesnenin de isteği yapan kullanıcıya ait olduğu doğrulanır. | Kullanıcı A’nın siparişine Kullanıcı B’nin adresi atanır. |
| Nesne Özelliği (BOPLA Ayrımı) | Kullanıcı A, kendi nesnesini güncellerken yetkisiz bir alanı (isApproved: true) gönderir. | Sahip olunan nesne, yetkisiz alan (property) | Yalnızca izin verilen alanlar işlenir, hassas alanlar yoksayılır/reddedilir. | Nesnenin dahili durum veya yetki alanı kullanıcı tarafından değiştirilir. |
Sentetik Örnek Senaryo: B2B Sipariş Takip API'si
Aşağıdaki senaryo, tamamen kurgusal bir B2B tedarik platformunun (api.example-b2b.test) yetkili test ortamında gerçekleştirilen API BOLA testi akışını göstermektedir:
Test Bağlamı ve Hazırlık
- Uç Nokta:
GET /api/v1/shipments/{shipmentId} - İş Kuralı: Her tedarikçi firma kullanıcısı yalnızca kendi firmasına (
tenantId) bağlı sevkiyat kayıtlarını görüntüleyebilmelidir. - Test Hesapları:
- Kullanıcı A:
[email protected](tenantId: "t-100", oluşturduğu test sevkiyatı:shp-9001) - Kullanıcı B:
[email protected](tenantId: "t-200", oluşturduğu test sevkiyatı:shp-9002)
- Kullanıcı A:
Adım 1: Temel İstek (Kullanıcı A kendi nesnesine erişir)
GET /api/v1/shipments/shp-9001 HTTP/1.1
Host: api.example-b2b.test
Authorization: Bearer <TOKEN_USER_A>
Accept: application/json
Gözlenen Yanıt: 200 OK döner ve gövdede shp-9001 kaydına ait sentetik test verileri ("tenantId": "t-100", "destination": "Test Depo 1") yer alır.
Adım 2: Çapraz Nesne Kontrolü (Kullanıcı A, Kullanıcı B'nin nesnesini ister)
GET /api/v1/shipments/shp-9002 HTTP/1.1
Host: api.example-b2b.test
Authorization: Bearer <TOKEN_USER_A>
Accept: application/json
- Beklenen Güvenli Davranış: Sunucu,
<TOKEN_USER_A>içindekit-100kiracı bilgisinishp-9002kaydının sahibi olant-200ile karşılaştırır. Eşleşme sağlanmadığı için isteği reddeder (403 Forbiddenveya kaynak gizliliği politikası gereği404 Not Found) ve yanıt gövdesinde sevkiyata dair hiçbir alan döndürmez. - Olası BOLA Bulgusu İşareti: Sunucu
200 OKdöndürür ve yanıt gövdesinde"shipmentId": "shp-9002","tenantId": "t-200"bilgilerini paylaşırsa, uç noktada nesne düzeyinde yetkilendirme kontrolünün eksik olduğu doğrulanmış olur. - Kapsam Sınırı: Test uzmanı bu aşamada
shp-9003,shp-9004gibi diğer kimlikleri taramaya geçmez; tek bir sentetik kayıtla zafiyeti kanıtlayarak raporlama aşamasına geçer.
BOLA Bulgusu Nasıl Doğrulanır ve Güvenli Biçimde Raporlanır?
Tespit edilen bir BOLA zafiyetinin geliştirme ekibi tarafından hızlıca anlaşılabilmesi ve yeniden üretilebilmesi için teknik raporun yapılandırılmış ve ölçülü olması gerekir. İyi bir API pentest raporunda şu başlıklar yer almalıdır:
- Bulgu Başlığı ve Özeti: Etkilenen işlevi ve zafiyet sınıfını net biçimde tanımlayan başlık (örneğin: Sevkiyat Detay Uç Noktasında Nesne Düzeyinde Yetkilendirme Eksikliği (BOLA)).
- Etkilenen Uç Nokta ve Yöntem: Tam HTTP yöntemi, yol, ilgili parametre veya GraphQL operasyon adı (
GET /api/v1/shipments/{shipmentId}). - Ön Koşullar ve Test Hesabı Rolü: Bulgudan yararlanmak için kimlik doğrulama gerekip gerekmediği ve hangi rolün kullanıldığı (örneğin: Kimliği doğrulanmış standart tedarikçi kullanıcısı).
- Adım Adım Yeniden Üretim (Steps to Reproduce): Kullanıcı A ve Kullanıcı B test hesaplarıyla gerçekleştirilen minimal HTTP istekleri.
- Beklenen ve Gözlenen Davranış: Uygulamanın iş kurallarına göre vermesi gereken yanıt ile gerçekte verdiği yanıtın karşılaştırması.
- Minimum Kanıt (Proof of Concept): Yalnızca bulguyu kanıtlamaya yetecek kadar maskelenmiş HTTP yanıt kesiti. Rapor içine tam veritabanı dökümleri, maskelenmemiş erişim belirteçleri veya test dışı kayıtlara ait veriler kesinlikle eklenmez.
- Olası Etki ve Risk Değerlendirmesi: Etkilenen veri türü, yatay/dikey erişim kapsamı ve iş süreci üzerindeki olası sonuçlar dikkate alınarak yapılan dengeli risk derecelendirmesi.
- Uygulanabilir Düzeltme Önerisi: İlgili teknoloji yığınına uygun sunucu taraflı sahiplik kontrolü ve regresyon testi önerisi.
Geliştiriciler BOLA/IDOR Riskini Nasıl Azaltabilir?
BOLA zafiyetlerini kalıcı olarak ortadan kaldırmak, istemci tarafında parametre gizlemekle değil, sunucu tarafında tutarlı bir yetkilendirme mimarisi kurmakla mümkündür. OWASP API Security Top 10 (API1:2023) ve OWASP IDOR Prevention Cheat Sheet rehberlerine dayanan temel savunma ilkeleri şunlardır:
1. Her Nesne Erişiminde Sunucu Taraflı Yetki Kontrolü
Kullanıcıdan gelen bir nesne kimliğiyle veritabanına, dosya sistemine veya harici bir servise erişen her API uç noktası ve GraphQL çözümleyicisi (resolver), işlemi gerçekleştirmeden önce oturum açmış kullanıcının o nesne üzerinde ilgili eyleme yetkili olduğunu doğrulamalıdır.
2. Veri Sorgularını Kullanıcı ve Kiracı Kapsamına Alma (Scoped Queries)
Nesneyi yalnızca birincil anahtarıyla (findById(id)) çekip uygulama katmanında kontrol etmeyi unutmak yaygın bir hata kaynağıdır. Bunun yerine veri erişim katmanında sorguyu doğrudan kimliği doğrulanmış kullanıcının veya kiracının bağlamıyla sınırlandırmak çok daha güvenlidir:
// Riskli yaklaşım: Yalnızca istemciden gelen ID ile sorgulama
Shipment shipment = shipmentRepository.findById(shipmentId)
.orElseThrow();
// Güvenli yaklaşım: Sorguyu oturumdaki kiracı ve yetki kapsamıyla sınırlandırma
Shipment shipment = shipmentRepository
.findByIdAndTenantId(shipmentId, currentUser.getTenantId())
.orElseThrow(() -> new ResourceNotFoundException("Kayıt bulunamadı"));
Bu desen kullanıldığında, başka bir kiracıya ait geçerli bir shipmentId gönderilse dahi veritabanı sorgusu eşleşme döndürmez.
3. Merkezi ve Test Edilebilir Yetkilendirme Politikaları
Yetki kontrollerini her kontrolcü (controller) içine dağınık if/else blokları olarak yazmak yerine, merkezi bir politika motoru (örneğin RBAC/ABAC tabanlı ara katmanlar veya framework düzeyinde yöntem güvenliği) kullanmak bakım maliyetini ve unutulma riskini azaltır. Politika kararları "varsayılan olarak reddet" (deny-by-default) ilkesiyle çalışmalıdır.
4. Kimlik Karmaşıklığını Savunma Derinliği Olarak Konumlandırma
Ardışık tam sayılar (101, 102, 103) yerine tahmin edilmesi zor UUIDv4 veya kriptografik olarak rastgele kimlikler kullanmak, saldırganların kimlik numaralarını sırayla tahmin etmesini (enumeration) zorlaştırır. Ancak UUID kullanmak tek başına bir yetkilendirme kontrolü değildir. Bir UUID değeri tarayıcı geçmişinden, loglardan, paylaşılan bağlantılardan veya başka bir uç noktadan sızdığında, sunucu tarafında sahiplik kontrolü yoksa BOLA zafiyeti aynı şekilde istismar edilebilir. Bu nedenle rastgele kimlikler yalnızca ikincil bir savunma katmanı (defense-in-depth) olarak değerlendirilmelidir.
5. Olumsuz (Negatif) Senaryolar İçin Otomatik Regresyon Testleri
Birim (unit) ve entegrasyon testlerine yalnızca "Kullanıcı kendi nesnesini görebilir" senaryoları değil, "Kullanıcı A, Kullanıcı B'nin nesnesini okuyamaz, güncelleyemez ve silemez" biçimindeki negatif yetkilendirme testleri de eklenmelidir. CI/CD hattında bu testlerden biri başarısız olduğunda dağıtım otomatik olarak durdurulmalıdır.
Otomatik Tarama ile Manuel API Yetkilendirme Testi Arasındaki Fark
Otomatik zafiyet tarayıcıları (DAST) ve statik kod analiz araçları (SAST), eksik güvenlik başlıkları, bilinen bileşen zafiyetleri veya belirgin enjeksiyon kalıplarını tespit etmede hız kazandırır. Ancak iş API yetkilendirme testi olduğunda otomasyon tek başına yeterli değildir.
Bunun temel nedeni, yetkilendirmenin teknik bir sözdizimi hatası değil, iş mantığı ve bağlam meselesi olmasıdır. Bir otomatik tarayıcı, GET /api/v1/projects/412 isteğine 200 OK yanıtı döndüğünde bu verinin isteği gönderen kullanıcıya mı ait olduğunu, herkese açık bir proje mi olduğunu yoksa başka bir müşterinin gizli verisi mi olduğunu iş kurallarını bilmeden anlayamaz. Benzer şekilde çok adımlı iş akışlarında, organizasyon içi hiyerarşilerde veya paylaşılan nesne izinlerinde hangi erişimin meşru hangisinin ihlal olduğuna karar vermek bağlamsal analiz gerektirir.
Öte yandan hibrit bir yaklaşım verimliliği artırır: Uzman tarafından iki farklı kullanıcı oturumu ve rol matrisiyle yapılandırılan yarı otomatik proxy eklentileri (örneğin trafik tekrarlama ve oturum karşılaştırma araçları), geniş API yüzeylerinde aday uç noktaları hızla işaretleyebilir. Ancak işaretlenen her aday bulgunun bir güvenlik uzmanı tarafından manuel olarak doğrulanması, yanlış pozitiflerin (false positive) elenmesi ve gerçek iş etkisinin yorumlanması şarttır. Genel web uygulaması tarama süreçlerinin kapsamı ve sınırları hakkında daha fazla bağlam için OWASP tabanlı web uygulaması güvenlik kontrolleri yazısını inceleyebilirsiniz.
API BOLA Testini Ne Zaman Profesyonel Kapsamda Yaptırmalısınız?
Kurum içi geliştirme ve AppSec ekiplerinin CI/CD süreçlerine entegre ettiği temel yetkilendirme testleri kritik bir ilk savunma hattıdır. Bununla birlikte, bağımsız ve derinlemesine bir web uygulaması ve API sızma testi değerlendirmesinin kuruma somut değer kattığı belirli dönüm noktaları vardır:
- Yeni API Sürümleri ve Mimari Dönüşümler: Monolitik bir uygulamadan mikroservis mimarisine geçildiğinde, yeni bir mobil uygulama arka ucu yayına alındığında veya GraphQL katmanı eklendiğinde servisler arası yetki aktarımı (identity propagation) hataları sıkça ortaya çıkar.
- Çok Kiracılı (Multi-Tenant) Yapı ve Rol Modeli Değişiklikleri: B2B SaaS ürünlerinde yeni organizasyon hiyerarşileri, alt kullanıcı rolleri veya dış işbirlikçi paylaşım özellikleri eklendiğinde tenant izolasyonu sınırlarının bağımsız gözle test edilmesi gerekir.
- Kritik Veri ve Finansal İş Akışları: Ödeme sistemleri, kişisel sağlık/finans verileri, sözleşme yönetimi veya uzaktan cihaz kontrolü gibi yüksek etkili nesneler üzerinde işlem yapan API'lerde manuel senaryo bazlı doğrulama büyük önem taşır.
- Düzenleyici Uyum ve Müşteri Denetimleri: Sektörel regülasyonlar, kurumsal tedarikçi güvenlik değerlendirmeleri veya ISO/IEC 27001 gibi bilgi güvenliği süreçleri kapsamında yetkilendirme kontrollerinin kanıtlanabilir biçimde test edilmesi gerekebilir.
- Kritik Bulgu Düzeltmeleri Sonrası Doğrulama (Retest): Daha önce tespit edilen bir BOLA/IDOR açığının yalnızca yüzeysel bir yamayla değil, tüm ilişkili uç noktaları kapsayacak şekilde kalıcı olarak kapatıldığının teyit edilmesi için bağımsız doğrulama testi yapılır.
Kurumunuzun API mimarisine uygun kapsamlı bir değerlendirme planlamak için web uygulaması ve API sızma testi hizmet detaylarını inceleyebilirsiniz.
Sık Sorulan Sorular (SSS)
1. BOLA ile IDOR aynı şey mi?
Aynı kök nedene (eksik nesne düzeyinde yetkilendirme kontrolüne) dayansalar da odak noktaları farklıdır. IDOR (Insecure Direct Object Reference), istemcinin gönderdiği doğrudan bir referansın değiştirilerek başka kaynağa erişilmesini tanımlar. BOLA (Broken Object Level Authorization) ise OWASP API Security Top 10 kapsamında, API uç noktasının nesne bazında yetki kontrolü yapmaması zafiyetini ifade eden daha geniş mimari terimdir.
2. UUID veya tahmin edilmesi zor kimlikler kullanmak BOLA'yı önler mi?
Hayır, tek başına önlemez. UUIDv4 gibi rastgele kimlikler ardışık kimlik tahminini (enumeration) zorlaştırdığı için iyi bir savunma derinliği uygulamasıdır; ancak yetkilendirme kontrolünün yerini tutmaz. Bir UUID değeri ağ trafiğinden, paylaşılan bağlantılardan, istemci önbelleğinden veya başka bir API yanıtından elde edildiğinde sunucu sahiplik kontrolü yapmıyorsa BOLA zafiyeti devam eder.
3. Giriş (kimlik doğrulama) yapmadan da BOLA oluşabilir mi?
Teknik olarak BOLA, kimliği doğrulanmış bir kullanıcının yetkisi dışındaki başka bir nesneye erişmesini tanımlar. Bir uç nokta hiç oturum açmamış (anonim) kullanıcılara nesne verisi döndürüyorsa, bu durum genellikle eksik kimlik doğrulama (Broken Authentication) veya hatalı erişim kontrolü yapılandırması kapsamında değerlendirilir.
4. API BOLA testi için kaç kullanıcı hesabı gerekir?
En temel yatay erişim kontrolü için farklı nesnelere sahip en az iki ayrı standart kullanıcı hesabı (Kullanıcı A ve Kullanıcı B) gerekir. Çok kiracılı (multi-tenant) yapılarda ve rol tabanlı sistemlerde ise farklı kiracılara ait hesaplar ile farklı ayrıcalık seviyelerindeki rollerin (örneğin standart üye, yönetici, denetçi) eklenmesi sağlıklı bir yetki matrisi testi için gereklidir.
5. GraphQL API'lerinde BOLA görülebilir mi?
Evet. GraphQL tek bir uç nokta (/graphql) kullansa bile arka plandaki çözümleyiciler (resolvers) veritabanı nesnelerine istemciden gelen argümanlar veya variables içindeki kimliklerle erişir. Sorgu ve mutasyon çözümleyicilerinde nesne sahipliği kontrolü yapılmazsa GraphQL API'lerinde de BOLA oluşur.
6. Sunucunun 403 Forbidden döndürmesi açığın olmadığını kanıtlar mı?
Tek başına kanıtlamaz. Öncelikle farklı HTTP yöntemlerinin (GET, POST, PUT, PATCH, DELETE), alternatif içerik türlerinin veya aynı veriye ulaşan ikincil uç noktaların (örneğin mobil API sürümü veya GraphQL eşdeğeri) da aynı yetki kontrolünü uygulayıp uygulamadığı doğrulanmalıdır. Ayrıca nadir durumlarda hatalı yapılandırılmış ara katmanlar 403 koduyla birlikte yanıt gövdesinde hassas hata ayrıntıları döndürebilir.
7. Otomatik güvenlik tarayıcıları BOLA zafiyetini tek başına bulabilir mi?
Tam otomatik tarayıcılar iş mantığını ve hangi nesnenin hangi kullanıcıya ait olduğunu kendiliğinden bilemediği için BOLA tespitinde sınırlı kalır. Otomatik araçlar yalnızca belirgin yapılandırma hatalarını veya önceden iki oturumla eğitilmiş basit erişim farklarını işaretleyebilir; kesin doğrulama için insan uzmanlığı gerekir.
8. BOLA bulgusu geliştirme ekibine nasıl raporlanmalıdır?
Rapor; etkilenen uç noktayı, kullanılan HTTP yöntemini, test hesabı rolünü, yalnızca sentetik test nesneleriyle oluşturulan minimal istek/yanıt örneklerini, beklenen ve gözlenen davranış farkını ve sunucu tarafında sorguyu kullanıcı/kiracı kapsamına almayı öneren somut düzeltme rehberini içermelidir.
API BOLA testi, modern uygulamaların en kritik veri sınırlarını koruyan nesne düzeyinde yetkilendirme mekanizmalarının gerçek iş kurallarıyla uyumlu çalışıp çalışmadığını doğrulamanın en doğrudan yoludur. İster kendi ürününü geliştiren bir yazılım ekibi ister kurumsal riskleri yöneten bir güvenlik yöneticisi olun, şu üç adımla hemen harekete geçebilirsiniz:
- Kapsam ve Yetki Matrisini Netleştirin: Üretim verilerine dokunmadan, yazılı onaylı test ortamınızda en kritik API uç noktalarınızı, rollerinizi ve kiracı sınırlarınızı listeleyin.
- Kontrollü Test Hesaplarıyla Doğrulama Yapın: En az iki ayrı test hesabı ve sentetik kayıtlar kullanarak kritik
GET,PUT/PATCHveDELETEişlemlerinde nesne sahipliği kontrollerini sınayın. - Sunucu Taraflı Kalıcı Düzeltme ve Yeniden Doğrulama Uygulayın: Veri erişim katmanında sorguları oturum ve kiracı bağlamıyla sınırlandırın, negatif yetkilendirme senaryolarını otomatik testlerinize ekleyin ve kritik mimari değişikliklerin ardından bağımsız bir doğrulama planlayın.
Son güncelleme:























