Skip to main content

/tasks/create/file

POST /tasks/create/file

Bir dosyayı bekleyen görevler listesine ekler. Yeni oluşturulan görevin kimliğini döndürür.

Örnek request:

curl -H "Authorization: Bearer S4MPL3" -F file=@/path/to/file http://localhost:8090/tasks/create/file

Python kullanılan örnek request:

import requests

REST_URL = "<http://localhost:8090/tasks/create/file>"
SAMPLE_FILE = "/path/to/malwr.exe"
HEADERS = {"Authorization": "Bearer S4MPL3"}

with open(SAMPLE_FILE, "rb") as sample:
    files = {"file": ("temp_file_name", sample)}
    r = requests.post(REST_URL, headers=HEADERS, files=files)

# Add your code to error checking for r.status_code.

task_id = r.json()["task_id"]

# Add your code for error checking if task_id is None.

Örnek response:

{
    "task_id" : 1
}

Form parametreleri:

  • file (zorunlu) - örnek dosya (multipart kodlu dosya içeriği)
  • package (isteğe bağlı) - analiz için kullanılacak analiz paketi
  • timeout (isteğe bağlı) (int) - analiz süresi aşımı (saniye cinsinden)
  • priority (isteğe bağlı) (int) - göreve atanacak öncelik (1-3)
  • options (isteğe bağlı) - analiz paketine iletmek için seçenekler
  • machine (isteğe bağlı) - analiz için kullanılacak analiz makinesinin etiketi
  • platform (isteğe bağlı) - analiz makinesini seçmek için platform adı (örneğin "windows")
  • tags (isteğe bağlı) - makineyi başlatmak için etiketlere göre tanımlama. Bu kullanıldığında
  • platformun ayarlanmış olması gerekir. Etiketler virgülle ayrılır
  • custom (isteğe bağlı) - analiz ve işleme/bildirme modüllerine geçirilmek üzere özel bir dize
  • owner (isteğe bağlı) - birden fazla kullanıcının aynı cuckoo örneğine dosya gönderebileceği durumlarda görev sahibi
  • clock (isteğe bağlı) - sanal makine saatinin ayarlanması (biçim %m-%d-%Y %H:%M:%S)
  • memory (isteğe bağlı) - analiz makinesinin tam bellek dökümü oluşturmayı etkinleştirme
  • unique (isteğe bağlı) - daha önce analiz edilmemiş örnekleri yalnızca gönderme
  • enforce_timeout (isteğe bağlı) - tam zaman aşımı değerini zorlamak için etkinleştirme

Durum kodları:

  • 200 - hata yok
  • 400 - yinelenen dosya tespit edildi (unique seçeneği kullanılıyorsa)
Back to top