API'lerde BOLA ve IDOR: Nesne Düzeyinde Yetkilendirmeyi Test Etme
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:
- Test kimliği, rolü, tenant'ı ve test kaydının sahibi.
- İstek yöntemi, rota, ilgili nesne referansı ve işlem.
- Beklenen politika kararı ve gözlenen yanıt.
- 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.
- 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 OKyanı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
403yanı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.
İlgili Araştırmalar
GraphQL API Güvenlik Testi: Resolver Yetkisi, Batching ve Maliyet
GraphQL API’lerinde resolver ve field yetkisi, batching, sorgu maliyeti, introspection ve hata sızıntısı için pratik test rehberi.
Backend SecuritySaaS Tenant Isolation Testi Nasıl Yapılır?
Çok kiracılı SaaS sistemlerinde tenant isolation, BOLA, cache, queue ve file storage katmanlarında nasıl test edilir?
Uygulama GüvenliğiAppSec Bulgusundan Doğrulanmış Düzeltmeye: Düzeltme ve Retest Akışı
Bir tarama veya inceleme sonucunu sorumlusu, etki bağlamı, ölçülebilir düzeltmesi, saklanan kanıtı ve kapsamlı retest’i olan kapalı bir riske dönüştürün.
İ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.