Merhaba Değerli Forum Üyeleri,
Bugün konumuzda, KleenScan API'yi Python ile nasıl kullanacağınızı detaylı bir şekilde anlatmaya çalışacağım. Öncelikle KleenScan API, zararlı yazılım analizinde kullanılan bulut tabanlı bir araç olup, güvenlik araştırmacıları tarafından kötü amaçlı yazılım analizleri için tercih edilir. Python ile KleenScan API kullanarak zararlı dosyaları tarayıp, analiz sonuçlarını alabilir ve kendinizi güvende tutabilirsiniz.
1. KleenScan API'ye Erişim ve Gereksinimler
API'yi kullanmaya başlamadan önce bir KleenScan hesabı oluşturmanız ve API anahtarınızı almanız gerekmektedir.
API anahtarınızı aldığınızda, Python'da HTTP isteklerini gerçekleştirmek için için 'requests' kütüphanesini ve JSON verilerini işlemek için 'json' modülünü kullanacağız.
Gerekli Python Paketlerinin Kurulumu
2. API Anahtarının ve Temel Ayarların Yapılandırılması
API'ye erişim sağlamak için API anahtarınızın aşağıdaki gibi bir değişken içinde tutmanız gerekir. Anahtar, API'ye her istek gönderildiğinde yetkilendirme amacıyla kullanacaktır:
3. Dosya Yükleme
KleenScan API kullanarak bir dosya yüklemek için, API'ye 'POST' isteği gönderilir. Bu istekte dosya ve API anahtarı yer alır:
Bu fonksiyon, verilen
yolundaki dosyayı KleenScan API'ye yükler. API dosyayı başarıyla yükledikten sonra, yüklenen dosyaya ait benzersiz bir dosya kimliği döndürülür.
Gerekli Python Paketlerinin Kurulumu
Bash:
pip install requests2. API Anahtarının ve Temel Ayarların Yapılandırılması
API'ye erişim sağlamak için API anahtarınızın aşağıdaki gibi bir değişken içinde tutmanız gerekir. Anahtar, API'ye her istek gönderildiğinde yetkilendirme amacıyla kullanacaktır:
Python:
import requests
import json
API_KEY = "API_ANAHTARINIZ"
BASE_URL = "https://api.kleenscan.com/v1/"3. Dosya Yükleme
KleenScan API kullanarak bir dosya yüklemek için, API'ye 'POST' isteği gönderilir. Bu istekte dosya ve API anahtarı yer alır:
Python:
def upload_file(file_path):
url = BASE_URL + "upload"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
# Dosya gönderilir
file = {'file': open(file_path, 'rb')}
response = requests.post(url, headers=headers, files=file)
if response.status_code == 200:
return response.json()
else:
raise Exception(f"Dosya yüklenemedi. Durum kodu: {response.status_code}")
Kod:
file_path
4. Analiz Sonuçlarını Alma
Yüklenen dosyanın analizi tamamlandıktan sonra, analiz sonuçları almak için dosya kimliğini kullanarak API'ye bir 'get' isteği göndermemiz gerekir:
Python:
def get_analysis_result(file_id):
url = BASE_URL + f"report/{file_id}"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
# Analiz sonuçları istenir
response = requests.get(url, headers=headers)
if response.status_code == 200:
return response.json()
else:
raise Exception(f"Analiz sonuçları alınamadı. Durum kodu: {response.status_code}")4. Sonuçları İşleme ve Raporlama
Analiz sonuçlarını aldıktan sonra bu verileri işlemek ve kullanıcıya raporlamak mümkündür. Analiz edilen dosyanın tehdit seviyesini ve tespit edilen zararlı yazılım ailelerini raporlamak için aşağıdaki fonksiyon yazılabilir:
Python:
def get_analysis_result(file_id):
url = BASE_URL + f"report/{file_id}"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
# Analiz sonuçları istenir
response = requests.get(url, headers=headers)
if response.status_code == 200:
return response.json()
else:
raise Exception(f"Analiz sonuçları alınamadı. Durum kodu: {response.status_code}")6. Tam Uygulama
Yukarıdaki fonksiyonları birleştirerek tam bir zararlı yazılım analizi oluşturabilirsiniz. Bu python kodu, KleenScan API'yi kullanarak dosya yükleme, analiz sonuçlarını alma ve rapor oluşturma işlemlerini bir araya getirir:
Python:
def main(file_path):
try:
# 1. Dosya Yükleme
upload_result = upload_file(file_path)
file_id = upload_result['file_id']
print(f"Dosya yüklendi, Dosya ID: {file_id}")
# 2. Analiz Sonuçlarını Alma
analysis_result = get_analysis_result(file_id)
# 3. Sonuçları Raporlama
generate_report(analysis_result)
except Exception as e:
print(f"Hata oluştu: {e}")
if __name__ == "__main__":
file_path = "test_dosyasi.exe" # Analiz edilecek dosya yolunu belirtin
main(file_path)Sonuç
Python ile KleenScan API kullanarak zararlı yazılım analizleri yapmak oldukça pratiktir. Bu yazıda, API anahtarını kullanarak dosya yükleme, analiz sonuçlarını alma ve rapor oluşturma adımlarını detaylı olarak ele aldık.
Diğer konularda görüşmek üzere, kendinize iyi bakın.
Son düzenleme:
