Custom Keylogger (Lab Env)

PowerShell tabanlı otomatik yükleyici, persistence ve klavye olayları analiz aracı.

Bu proje, Windows sistemlerinde saldırı yaşam döngüsünün farklı aşamalarını laboratuvar ortamında incelemek amacıyla PowerShell kullanılarak geliştirilmiştir. İçerisinde çok aşamalı yükleyici (Stage-1), kalıcılık , keylogging ve ağ üzerinden veri aktarımı gibi araştırma senaryoları bulunmaktadır.

Temel Özellikler

• Çok Aşamalı Çalışma Yapısı: Stage-1 scripti gerekli bileşenleri indirerek ikinci aşamayı otomatik olarak başlatır.
• Persistence Mekanizması: Windows Registry üzerinde kullanıcı oturumu açıldığında otomatik çalışacak şekilde kayıt oluşturur.
• PowerShell Keylogger: Klavye girişlerini kullanıcı seviyesinde izleyerek belirlenen aralıklarla bellekte toplar.
• Aktif Pencere Takibi: Kullanıcının işlem yaptığı pencere başlıklarını kayıt altına alabilir.
• Veri Aktarımı: HTTP istekleri veya Telegram Bot API üzerinden laboratuvar ortamına veri gönderebilir.
• Arka Plan Çalışması: PowerShell süreçlerini görünmez modda çalıştırarak kullanıcı etkileşimini minimumda tutar.
• Modüler Yapı: Her bileşen bağımsız olarak çalıştırılabilir veya zincir halinde kullanılabilir.

Kurulum

Gereksinimler

• Windows işletim sistemi
• PowerShell 5.1 veya üzeri
• İnternet bağlantısı (isteğe bağlı)
• Telegram Bot API veya HTTP sunucusu (senaryoya bağlı)

Projeyi İndirme

git clone https://github.com/muzoovy/keylogger.git
cd keylogger

Kullanım

Stage-1 yükleyicisini çalıştırmak için:

powershell -ExecutionPolicy Bypass -File setup.ps1

Doğrudan araştırma scriptlerini çalıştırmak için:

powershell -ExecutionPolicy Bypass -File keylogger.ps1

veya

powershell -ExecutionPolicy Bypass -File keylogcu.ps1

📂 Proje Yapısı

PowerShell-Research/
├── setup.ps1          # Stage-1 Loader
├── keylogger.ps1      # HTTP tabanlı araştırma modülü
├── keylogcu.ps1       # Telegram tabanlı araştırma modülü
└── README.md

Amaç

Bu proje aşağıdaki konuların laboratuvar ortamında incelenmesi amacıyla geliştirilmiştir.

• Windows Persistence
• PowerShell Automation
• Keylogging Mekanizmaları
• Process Execution
• HTTP / Telegram Communication
• Detection Engineering
• Malware Analysis
• Threat Hunting