styx0s STYX0S / BLOG

MAKALE · ·5 dk okuma ·0 görüntülenme

Not tutma ve writeup yazma düzeni: markdown şablonu, kanıt toplama, ekran görüntüsü

Bu sayfada
  1. Temel fikir: notu sonradan değil, sırasında al
  2. Araç: Obsidian mı, düz markdown mı?
  3. Klasör yapısı
  4. Şablon
  5. Kanıt toplama
  6. Ekran görüntüsü kuralları
  7. Yazarken akış
  8. Kod bloğu stili
  9. Küçük bir alışkanlık: gün sonu özeti
  10. Kontrol listesi: yayın öncesi
  11. Son söz

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:

bashmakine iskeleti
$ mkdir -p ~/notlar/htb/<makine>/{ss,loot,tarama}
$ touch ~/notlar/htb/<makine>/notlar.md
  • ss/ ekran görüntüleri
  • loot/ bulunan dosyalar, yapılandırmalar (hassas olanları yayından önce temizle!)
  • tarama/ ham araç çıktıları
  • notlar.md ana akış

Şablon

Aşağıdaki şablon, her makinenin başında kopyaladığımız dosya. Boşlukları çözüm sırasında dolduruyoruz.

mdsablon.md
---
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:

  1. Komut ve çıktı. Metin olarak, kod bloğunda. Ekran görüntüsünden çok daha iyidir; aranabilir, kopyalanabilir.
  2. Ekran görüntüsü. Arayüz gerektiren yerlerde: web paneli, hata ekranı.
  3. 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ı:

bashoturum kaydı
$ 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.png kimseye 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.

  1. Yapıyı kur. Başlıklar: keşif, ilk erişim, yetki yükseltme, çıkmazlar, savunma.
  2. 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."
  3. Neden'i ekle. Her adımın yanına "neden bunu denedim?" yaz. Okuyucu komutu değil, düşünceyi arıyor.
  4. Kısalt. Ham tarama çıktısının 200 satırını koyma; ilgili 5 satırı koy.
  5. 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:

bashörnek: kısaltılmış çıktı
$ 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İ

$ cat yorumlar.log
(boş) henüz ses yok.

    $ yorum >> yorumlar.log