Not tutma ve writeup yazma düzeni: markdown şablonu, kanıt toplama, ekran görüntüsü
Bu sayfada
Bir makineyi çözdün, sevinçten ellerin titriyor, sonra o iğrenç an geliyor: "Writeup yazayım" ve hiçbir şey hatırlamıyorsun. Hangi komutu çalıştırmıştın? O parola nereden çıkmıştı? Neden o yolu seçmiştin? Biz de bunu yaşadık, o yüzden bir düzen kurduk. Bu yazıda onu anlatıyoruz.
Temel fikir: notu sonradan değil, sırasında al
Writeup bir hafıza egzersizi değil, bir kayıt işi. Çözüm sırasında not almak ilk başta yavaşlatır, ama iki şeyi kazandırır:
- Çıkmazlar kayıtlı. Yanlış denediğin şeyler en öğretici kısım; sonradan akla gelmez.
- Tekrar üretilebilirlik. Bir şeyi yeniden yapman gerekirse komutlar elinde.
Kural basit: bir komut çalıştırıyorsan ve sonucu önemliyse, çıktının ilgili kısmıyla birlikte nota yapıştır.
Araç: Obsidian mı, düz markdown mı?
İkisi de olur. Biz markdown dosyalarını kullanıyoruz; çünkü format taşınabilir, git'e girer, her editörde açılır. Obsidian ise bu dosyaların üstüne oturan iyi bir arayüz; bağlantılar, arama ve grafik görünüm sağlıyor.
| Seçenek | Artı | Eksi |
|---|---|---|
| Düz markdown + git | Sürüm geçmişi, taşınabilir | Arayüz yok, kendin disiplinli olmalı |
| Obsidian | Arama, [[bağlantı]], eklentiler |
Eklenti bağımlılığı olabilir |
| CherryTree / OneNote | Ağaç yapısı, hızlı yapıştırma | Format kapalı ya da yarı kapalı |
Hangisini seçersen seç, tek kural: format dışa aktarılabilir olsun. Bir yıl sonra araç kapanırsa notların gitmesin.
Klasör yapısı
Her makine için aynı iskelet:
$ mkdir -p ~/notlar/htb/<makine>/{ss,loot,tarama}
$ touch ~/notlar/htb/<makine>/notlar.mdss/ekran görüntüleriloot/bulunan dosyalar, yapılandırmalar (hassas olanları yayından önce temizle!)tarama/ham araç çıktılarınotlar.mdana akış
Şablon
Aşağıdaki şablon, her makinenin başında kopyaladığımız dosya. Boşlukları çözüm sırasında dolduruyoruz.
---
makine:
platform: HackTheBox
os:
zorluk:
durum: devam
tarih:
---
## Özet
Tek paragraf: ne vardı, hangi zincirle ilerlendi.
## Keşif
- Açık portlar ve servisler
- İlginç bulgular (ve neden ilginç)
## İlk erişim
- Hangi zayıflık / yanlış yapılandırma?
- Neden çalıştı? (kök neden)
## Yetki yükseltme
- Mevcut durum -> hedef durum
- Kök neden
## Çıkmazlar
- Denedim ama olmadı: ... Neden olmadığını sandım: ...
## Savunma notları
- Bu zincir nasıl engellenirdi?
## Referanslar
- Kullanılan dokümantasyon, yazılar"Çıkmazlar" ve "Savunma notları" bölümleri bizim imzamız. İlki dürüstlük, ikincisi ise bu işi neden yaptığımızın cevabı: saldırıyı anlamak, savunmayı öğrenmek.
Kanıt toplama
Writeup'ta iddianı kanıtlaman gerek. Üç tür kanıt:
- Komut ve çıktı. Metin olarak, kod bloğunda. Ekran görüntüsünden çok daha iyidir; aranabilir, kopyalanabilir.
- Ekran görüntüsü. Arayüz gerektiren yerlerde: web paneli, hata ekranı.
- Zaman damgası. Neyi ne zaman yaptığını bilmek, log ile eşleştirme ya da tekrar etmede işe yarar.
Terminal kaydı için script komutu en kolayı:
$ script -a -f ~/notlar/htb/<makine>/tarama/oturum-$(date +%F).log
# ... çalış ...
$ exit-a ekleme modu, -f her yazımda diske flush eder; bilgisayar çökse bile kayıt durur. Kayıtta parolalar da görünebilir, bu dosyayı asla olduğu gibi paylaşma.
Ekran görüntüsü kuralları
- Sadece ilgili alanı al, tüm ekranı değil.
- Önemli yeri işaretle (kutu, ok), ama orijinali de sakla.
- Dosya adını anlamlı koy:
03-admin-panel-giris.png.Screenshot_2026-11-09_193012.pngkimseye bir şey söylemez. - Hassas bilgiyi bulanıklaştır. Kendi kimlik bilgilerin, VPN IP'n, kişisel yol adların (
/home/adın/) görünmesin.
Yazarken akış
Notlarla writeup arasında bir adım var: düzenleme. Ham notları olduğu gibi yayınlamıyoruz.
- Yapıyı kur. Başlıklar: keşif, ilk erişim, yetki yükseltme, çıkmazlar, savunma.
- Hikâyeyi bul. Zincir tek cümleyle ifade edilebilmeli: "Açık bir yedek dosyası, yeniden kullanılan bir parola ve yanlış yapılandırılmış bir servis."
- Neden'i ekle. Her adımın yanına "neden bunu denedim?" yaz. Okuyucu komutu değil, düşünceyi arıyor.
- Kısalt. Ham tarama çıktısının 200 satırını koyma; ilgili 5 satırı koy.
- Bir arkadaşa okut. Anlamadığı yer, yazının zayıf noktası.
Kod bloğu stili
Blogda komutları şöyle veriyoruz: $ ile başlayan satır komut, onun altındaki çıktı. Dosya içeriği ise başlıklı blokta:
$ nmap -p"$ports" -sV hedef.htb
80/tcp open http nginx 1.18.0
# ... (diğer satırlar kısaltıldı)Kısaltma yaptığında bunu belirt (# ... kısaltıldı). Okuyucuyu yanıltma.
Küçük bir alışkanlık: gün sonu özeti
Bir makinede birkaç gün çalışıyorsan, her oturumu iki satırla kapat: "Şu an neredeyim, bir sonraki adım ne?" Ertesi gün bilgisayarı açtığında o iki satır seni on beş dakikalık "ben nerede kalmıştım?" sisinden kurtarıyor. Takıldığın yerde de aynısı geçerli: sorunu yazıya dökmek, çoğu zaman çözümü kendiliğinden getiriyor. Buna hacker'lar arasında "lastik ördek" etkisi diyoruz; ördeğin yerine not defterini koyabilirsin.
Kontrol listesi: yayın öncesi
- Makine emekli mi? (Aktif ise yayınlama.)
- Flag'ler ve hassas veriler çıkarıldı mı?
- Ekran görüntülerinde kişisel bilgi var mı?
- Her adımın "neden"i yazılı mı?
- Çıkmazlar bölümü dolu mu?
- Savunma notu eklendi mi?
- Bir arkadaş okudu mu?
Son söz
İyi not tutmak yavaş görünür ama iki hafta sonra katlanarak geri öder. Writeup yazmak ise öğrendiğini sağlamlaştırmanın en iyi yolu: bir şeyi anlatabiliyorsan anlamışsındır. Şablonu kopyala, kendine göre değiştir, en önemlisi bugünkü makineden başla.
> TEPKİ
YORUMLAR (0)
$ cat yorumlar.log
(boş) henüz ses yok.