EresusSecurity
Araştırmalara Dön
Uygulama Güvenliği

API'lerde BOLA ve IDOR: Nesne Düzeyinde Yetkilendirmeyi Test Etme

Yiğit İbrahim SağlamOfansif Güvenlik Uzmanı
25 Şubat 2025
Güncellendi: 18 Ekim 2026
8 dk okuma

Kısa yanıt: Broken Object Level Authorization (BOLA), yaygın adıyla IDOR, API'nin çağırana erişme yetkisi olmayan bir nesne üzerinde işlem yapmasına izin vermesidir. Kimlik doğrulama isteği yapan kişinin kim olduğunu gösterir; istenen nesneyi okuma, değiştirme veya silme yetkisini tek başına kanıtlamaz. Bu sınırı yalnızca test etme yetkiniz olan sistem ve verilerde inceleyin.

OWASP API Security Top 10:2023 bu riski API1:2023 olarak adlandırır. Nesne kimlikleri URL path veya query alanında, header'larda, istek gövdesinde, GraphQL değişkenlerinde, dosya referanslarında ya da iş kuyruğu kimliklerinde bulunabilir. Kimliğin sıralı, rastgele veya opak olması sunucudaki yetkilendirme kararının yerini tutmaz.

Nesne yetkisini fonksiyon yetkisinden ayırın

BOLA, kullanıcının genel olarak çağırabildiği bir fonksiyon üzerinden belirli bir nesneye erişim yetkisi olmamasıyla ilgilidir. Örneğin giriş yapmış bir müşteri faturalarını okuyabilir, ancak başka bir müşterinin faturasını okuyamaz. Broken Function Level Authorization (BFLA) ise kullanıcının hiç çağırmaması gereken bir fonksiyon veya işleme erişmesidir. Aynı değerlendirmede ikisi de bulunabilir; ancak test ve düzeltme soruları farklıdır.

Tek başına başarılı HTTP durum kodu zafiyet kanıtı değildir. Yanıt gövdesi, durum değişikliği veya sonraki sistem etkisi beklenen politika ve güvenli bir kontrol örneğiyle karşılaştırılmalıdır. Benzer şekilde, istek yetkisiz yan etkiye zaten yol açtıysa 403 veya 404 yanıtı doğru yetkilendirmeyi kanıtlamaz.

Güvenli bir yetkilendirme matrisi kurun

Testten önce yazılı kapsamı ve üretim dışı ortamı ya da onaylı test verilerini belirleyin. En az yetkili, amaca özel hesaplar ve sentetik kayıtlar oluşturun; gerçek müşteri kimliklerini taramayın veya başka kullanıcıların verilerini çekmeyin. Her isteği göndermeden önce beklenen kararı yazın.

Çağıran ve nesne Okuma Güncelleme Silme veya başka durum değişikliği
Aynı tenant'taki nesne sahibi Beklenen politikayı belirleyin Beklenen politikayı belirleyin Beklenen politikayı belirleyin
Aynı tenant'taki farklı kullanıcı Açıkça tanımlayın Açıkça tanımlayın Açıkça tanımlayın
Başka tenant'taki kullanıcı Reddedin veya onaylı paylaşım kuralını tanımlayın Reddedin veya onaylı paylaşım kuralını tanımlayın Reddedin veya onaylı paylaşım kuralını tanımlayın
Yalnızca okuma rolü Onaylı okumalar dışında reddedin Politika aksini söylemiyorsa reddedin Politika aksini söylemiyorsa reddedin
Süresi dolmuş veya doğrulanmamış oturum Korumalı erişimi reddedin Reddedin Reddedin

“Politikayı açıkça tanımlayın” ifadesi bilinçlidir; her sistemin erişim modeli farklıdır. Destek rolü, paylaşılan çalışma alanı veya devredilmiş hesap meşru erişime sahip olabilir. Testin beklenen sonucu rol adından değil, ürünün erişim politikasından çıkarılmalıdır.

Her nesne referansını ve işlemi test edin

İstemci tarafından kontrol edilen referansları path ve query parametrelerinde, JSON alanlarında, GraphQL değişkenlerinde, toplu işlemlerde, dışa aktarımlarda, yüklenmiş dosya anahtarlarında ve asenkron iş kimliklerinde listeleyin. Her nesne türünde yetkili bir temel senaryoyu, ikinci bir test kimliğiyle kontrollü negatif senaryoyla karşılaştırın. Nesnenin bulunduğu yerde okuma, güncelleme, silme ve paylaşma/dışa aktarma gibi işlemleri ayrı değerlendirin.

Her senaryoda yeniden üretim için gereken asgari kanıtı saklayın:

  1. Test kimliği, rolü, tenant'ı ve test kaydının sahibi.
  2. İstek yöntemi, rota, ilgili nesne referansı ve işlem.
  3. Beklenen politika kararı ve gözlenen yanıt.
  4. Verinin dönüp dönmediği veya durumun değişip değişmediği; test kaydını ve ilgili denetim kaydını kontrol edin.
  5. Kuyruğa alınmış iş veya cache okuması gibi ilgili sonraki yol.

Token'ları ve kişisel verileri maskeleyin. İstek gerçek kullanıcı kaydına, onaylanmamış bir hosta veya beklenmeyen bir durum değiştirme akışına ulaşıyorsa testi durdurun.

Örnek test: özel bir belge

Özel belgelerin sahibi dışındaki kişilerle açıkça paylaşılmadığı kurgusal bir workspace düşünün. Yalnızca test için açılmış hesap ve sentetik kayıt kullanın:

Kimlik doc-test-A ile ilişkisi Okuma için beklenen sonuç
Alice, North tenant'ı Sahibi İzin ver
Ben, North tenant'ı Aynı tenant'ta, paylaşılmamış Reddet
Cy, South tenant'ı Farklı tenant Reddet
Destek rolü Onaylı destek yetkisi yok Reddet

Bu sonuçlar yalnızca örnek bir politikadır; gerçek test uygulamanın belgelenmiş paylaşım ve destek kurallarını kullanmalıdır. Önce Alice ile doc-test-A isteği gönderip test kaydının ve rotanın çalıştığını doğrulayın. Aynı okuma isteğini Ben ve Cy ile yineleyin, yanıt verisini ve denetim kayıtlarını karşılaştırın. Güncelleme senaryosunda atılabilir bir test alanı kullanın; yetkisiz kimlikle isteği gönderdikten sonra Alice ile kaydın değişmediğini doğrulayın. Gerçek bir kullanıcının hesabından alınan kimliği testte kullanmayın.

Test tek bir HTTP kodunu zorunlu tutmamalı, güvenlik özelliğini doğrulamalıdır. Uygulama nesnenin varlığını gizlemek için 404 veya açık ret için 403 döndürebilir; her iki durumda da korunan içeriği açıklamamalı veya işlemi gerçekleştirmemelidir. Hem yanıtı hem test kaydının son durumunu kontrol edin.

Yetkilendirme kararını sistem sınırları boyunca izleyin

Bir endpoint doğru karar verirken başka bir yol aynı kontrolü atlayabilir. Yalnızca yetkili uygulama kapsamındaki yolları ekleyin:

  • Toplu işlemler: sahip olunan ve olunmayan sentetik kayıtları birlikte test edin. Belgelenen tümü-birlikte veya kayıt-başına davranışı doğrulayın; reddedilen kayıtların yan etkisi olmadığını kontrol edin.
  • İstemcinin gönderdiği sahiplik alanları: yalnızca atılabilir test kaydında ownerId, tenantId, rol veya paylaşım alanlarını değiştirmeyi deneyin. Yetki, çağıranın gönderdiği sahiplik iddiasından değil, doğrulanmış kimlik ve güvenilir politikadan türetilmelidir.
  • GraphQL: doğrudan nesne sorgularını, alt alanları, mutation'ları ve kapsam içindeki subscription'ları test edin. Üst resolver kontrolü alt nesneleri kendiliğinden korumaz.
  • Dosya ve dışa aktarımlar: varsa indirme anahtarlarında, export işlerinde, imzalı bağlantılarda ve üretilen arşivlerde aynı politikayı doğrulayın.
  • Cache: bir kimliğe göre yetkilendirilmiş yanıtın erişim politikası farklı başka bir kimliğe tekrar sunulmadığını doğrulayın. Cache tasarımı değişebilir; gözlenen yetkilendirme sonucu değişmemelidir.
  • Kuyruğa alınmış işler: worker'ın güvenilir actor/tenant bağlamı aldığını ve çalıştırma anında gerekli izni yeniden değerlendirdiğini kontrol edin. İstemcinin verdiği job ID veya tenant değeri yetki değildir.

Rol değişikliği, paylaşımın kaldırılması ve hesabın kapatılması ayrı senaryolardır: eski bir oturum veya cache kararı, izni veren koşuldan daha uzun yaşayabilir. Uygulamanın belgelenmiş geçersiz kılma davranışını test edin; onaysız hesap veya hostlara kapsamı genişletmeyin.

Test kararını değiştiren durumlar

Nesne sahipliği her zaman tek bir owner_id karşılaştırması değildir. İş politikası açık paylaşım, devredilmiş erişim, onaylı bir destek biletiyle sınırlı destek yetkisi veya süreli rol tanımlayabilir. Testten önce bu ilişkileri kaydedin ve beklenen sonucu onlardan çıkarın. İki hesap ID'si farklı diye tasarlanmış paylaşım akışını BOLA olarak sınıflandırmayın.

Ayrıca yalnızca nesneyi değil, işlemi de test edin. Bir kaydı okuma izni; değiştirme, silme, dışa aktarma veya paylaşma izni vermeyebilir. Kullanıcı profil alanını güncelleyebilirken kaydı başka bir tenant'a aktaramayabilir. Her işlem için istemcinin hangi alanları değiştirebileceğini ve hangi değerleri sunucunun türetmesi gerektiğini belirtin.

Uygulama liste veya toplu istekte kısmi sonuç döndürüyorsa her sentetik kayıt için içeriği ve yan etkileri doğrulayın. Genel bir başarı yanıtı, kayıt başına yetkilendirme hatasını veya başarılı bir yetkisiz yazmayı gizleyebilir.

Örnek sunucu tarafı yetkilendirme sınırı

Örnek sözde kod; belirli bir framework'ün uygulaması değildir:

document = documentRepository.findForAction(
    objectId = request.documentId,
    principal = authenticatedPrincipal,
    action = "read"
)

if document yoksa:
    uygulamanın belgelenmiş ret yanıtını döndür

document'i döndür

Repository veya politika katmanı, paylaşım ve devredilmiş erişim dahil tam kuralı uygulamalıdır. Okuma ve yazma işlemleri aynı politikayı kullanabilir; ancak istenen işlemi açıkça belirtin. Okuma izni sessizce güncelleme iznine dönüşmemelidir.

Sık sorulan sorular

BOLA ile IDOR aynı şey mi?

IDOR, istemci kontrollü bir referansın bir nesneyi göstermesini anlatır. BOLA ise çağıranın o nesneye erişmesine veya onu değiştirmesine izin veren eksik nesne düzeyinde yetkilendirme kararını anlatır. API bağlamında terimler çoğu zaman aynı hata sınıfı için kullanılır; etikete değil, ihlal edilen gerçek politikaya odaklanın.

UUID kullanmak BOLA'yı önler mi?

Hayır. Tahmin edilmesi zor kimlikler denemeyi azaltabilir; ancak çağıran geçerli bir ID gönderdiğinde de yetki kontrolü yapılmalıdır.

Reddedilen her istek 403 dönmeli mi?

Hayır. Bilgi ifşasını önleme politikasına göre uygulama 403 veya 404 döndürebilir. Korunan içeriğin dönmediğini, işlemin gerçekleşmediğini ve yanıtın belgelenmiş politikaya uyduğunu kontrol edin.

Otomatik scanner BOLA'yı tek başına doğrulayabilir mi?

Genel olarak hayır. Otomatik kapsam; test kimliklerine, nesne sahipliği bilgisine, uygulamaya özgü politikaya ve beklenen sonucu tanımlayan bir test oracle'ına bağlıdır. Araç gözlemi bu bilgilerle karşılaştırılarak incelenmelidir.

Düzeltmeyi nesnenin sahibi olan sınırda uygulayın

Her nesne ve işlem için, doğrulanmış kimlik ve sunucunun güvendiği ilişkiler üzerinden sunucu tarafında politika uygulayın. Veri erişim sorgusunu tenant veya sahiplik ilişkisine göre daraltmak yardımcı olabilir; ancak filtre tam erişim politikasını yansıtmalıdır. Rol, paylaşım veya devredilmiş erişim varsa tenant eşitliği tek başına yeterli olmayabilir. İstemciden gelen ownerId ya da tenantId değerini yetki kanıtı saymayın.

Kuralın iki tarafı için regresyon testi ekleyin: yetkili sahip/rol beklenen işlemi yapabilmeli; yetkisiz kimlik reddedilmeli ve hiçbir durum değişikliği oluşmamalıdır. İlgili toplu ve asenkron yolları da dahil edin. Endpoint'ler arasında farklılaşabilecek dağınık kontroller yerine tutarlı bir yetkilendirme servisi veya domain politikası kullanın.

Sık yapılan test hataları

  • Tahmin edilmesi zor ID'yi yetkilendirme kontrolü sanmak.
  • Dönen veri veya yan etkiyi incelemeden 200 OK yanıtından etki çıkarmak.
  • Yalnızca tek rolü, tek tenant'ı veya salt okuma işlemini test etmek.
  • Açık yetki olmadan üretim hesabı ya da gerçek müşteri verisi kullanmak.
  • Yazma işlemi zaten gerçekleşmişken 403 yanıtını başarılı test saymak.
  • Her scanner'ın BOLA'yı mutlaka kaçırdığını veya tek başına doğrulayabildiğini iddia etmek; kapsam uygulamanın kimlik, politika ve test yapılandırmasına bağlıdır.

Savunulabilir bir bulgu neleri içermeli?

Etkilenen nesne türünü ve işlemi, iki test kimliğini ve aralarındaki ilişkiyi, uygulanması gereken politikayı, maskelenmiş istek/yanıtı ve gözlenen yetkisiz sonucu açıklayın. Sınırlamaları ve yazma ya da sonraki sistem etkisinin doğrulanıp doğrulanmadığını belirtin. Kanıtın ötesinde sır, müşteri kaydı veya exploit iddiası yayımlamayın.

Düzeltme için tekrarlanabilir kabul koşulu tanımlayın: yetkili kimlik amaçlanan akışı tamamlar; yetkisiz kimlik test kaydını okuyamaz veya değiştiremez; ilgili regresyon testi geçer. Kapanış kaydı için bulgudan doğrulanmış düzeltmeye retest akışımızı, GraphQL'e özgü senaryolar için GraphQL güvenlik rehberini inceleyin. Yetkili API incelemesi planlayan ekipler Eresus Security API güvenlik değerlendirmesi sayfasını da ziyaret edebilir.

Kaynaklar

AI Security Başlangıç Eğitimi

Prompt injection, RAG veri sızıntısı, MCP riskleri ve model dosyası güvenliği için pratik kontrol listesini e-posta ile isteyin.

Prompt injection ve koruma kuralı atlatma kontrolleri.
RAG veri sızıntısı ve izin sınırı incelemesi.
MCP kimlik, taşıma ve komut riski kontrolleri.

Spam yok. Yalnızca kaynağı ve ilgili güvenlik notlarını paylaşmak için kullanılır.

İlgili Araştırmalar

İlgili Hizmetler

Kapsam Tahmini

Kapsam görüşmesinden önce tahmini çalışma büyüklüğünü öğrenin.

Bu derinlik neyi kapsar
Kapsamdaki hedefler için OWASP test planının tam uygulaması: kırık erişim kontrolü, enjeksiyon, kimlik doğrulama ve yetkilendirme kusurları, iş kuralı kötüye kullanımı, yeniden üretim adımlarıyla bulgular.
Neyi kapsamaz
Haftalar süren rakip simülasyonu, fiziksel ve oltalama vektörleri, özel istismar geliştirmesi, kaynak kod incelemesi.

Tahmini efor

~5 testci-günü

Bu bir tahmindir, teklif değil. Yukarıdaki üç faktörle ölçeklenir; hedeflerin test penceresi içinde erişilebilir olduğunu ve test hesaplarının sağlandığını varsayar.

Kesin kapsam talebi