Sample Submission — дээж илгээх

Энэ API endpoint нь Sandbox Analyzer руу дээж илгээнэ.

Илгээх URL: https://SANDBOX_IP/api/v1/upload

Endpoint нь HTTP multipart хүсэлт хүлээн авна. Хүсэлт нь detonation сонголтуудыг агуулсан JSON болон binary файлаас бүрдэнэ. URL-аар илгээх бол хүсэлтэд binary файл оруулах ёсгүй.

JSON хэлбэрийн сонголтууд

detonation объектын бүтэц:

• type - илгээж буй мэдээллийн төрлийг заасан String. Дараах утгуудын аль нэгийг авч болно:
  • file - binary файл илгээх үед
  • url - URL илгээх үед
• detonationProfile - detonation профайлыг агуулсан String. Энэ нь sandbox-ийн detonation хийх хурд (throughput) болон илрүүлэлтийн нарийвчлалын хооронд сонголт хийх, эсвэл тэнцвэржүүлэх боломжийг олгоно. Боломжит утгууд:
  • low - Sandbox Analyzer-ийн хурд нэмэгдэнэ, detonation шинжилгээний нарийн төвөгтэй байдал буурна. Илрүүлэлтийн нарийвчлал зохистой түвшинд хэвээр байна.
  • medium - detonation-ий хугацаа болон шинжилгээний нарийвчлалын оновчтой тэнцвэр.
  • high - шинжилгээний хамгийн сайн нарийвчлал. Гаж нөлөө нь detonation-ий хурд оновчтой биш байх явдал.
• url - шинжлэх URL-ийг агуулсан String. Энэ атрибут заавал биш.
• fileName - консол дээр харуулах файлын нэрийг заасан String. Энэ атрибут заавал биш. Орхивол Sandbox Analyzer нэр үүсгэнэ.
• archivePassword - архивыг тайлах нууц үгийг агуулсан String. Энэ атрибут заавал биш. Орхивол Sandbox Analyzer нууц үгтэй (шифрлэгдсэн) архивын агуулгыг шинжилж чадахгүй.

Detonation сонголтууд

Бүх сонголт заавал биш. Сонголтыг орхивол Sandbox Analyzer үндсэн утгыг ашиглана.

Жишээ нь, шифрлэгдсэн архивтай дээжийг command line аргументтайгаар, интернэт хандалтгүй VM дээр detonate хийх JSON дараах байдалтай байна:

{
    "imageId": "1787b5e3689a8435388b96b7a32e9c87f",
    "detonation": {
        "type": "file",
        "detonationProfile": "medium",
        "fileName: "infected.zip",
        "archivePassword": "123infected"
    },
    "detonationOptions": {
        "commandLineArguments": "--extraParam 41",
        "internetAccess": false
    }
}

Дараах нь сонголтгүйгээр URL илгээх JSON юм.

{
    "imageId": "1787b5e3689a8435388b96b7a32e9c87f",
    "detonation": {
        "type": "url",
        "detonationProfile": "medium",
        "url": "http://storage.infected.info/images/test.php"
    }
}

Буцаах утга

Энэ арга нь илгээлтийн тухай мэдээлэл агуулсан Object буцаана. Объект дараах бүтэцтэй:

• code - HTTP төлвийн кодыг илтгэх Integer
• message - хариуны тайлбар агуулсан String
• submissionId - илгээсэн дээжид оноосон ID. Алдаа гарсан тохиолдолд байхгүй.
• errors - буруу хүсэлтийн (bad request) үед String-үүдийн Array. Энэ атрибут зөвхөн алдааны үед буцна.

Жишээ

Хүсэлт:

Sandbox Portal API-ийн илгээлтийн хүсэлт нь JSON RPC биш, харин HTTP multipart хүсэлт тул хэд хэдэн cURL жишээ мөн өгье. Дараах жишээнүүд API түлхүүр UjlMS+0m1l9IUZjpjWyJG8gbnv2Mta4T ашиглан authorization толгойг хэрхэн тохируулахыг харуулна.

Detonation сонголтуудыг файлаас унших:

curl -X POST \
  https://{sandbox_ip}:9090/api/v1/upload \
  -H 'Authorization: Basic \
VWpsTVMrMG0xbDlJVVpqcGpXeUpHOGdibnYyTXRhNFQ=' \
  -F 'options=@{/path/to/json_with_detonation_options}' \
  -F 'upload_file=@{/path/to/binary_file}'

Detonation сонголтуудыг шууд үүсгэх:

curl -X POST \
  https://{sandbox_ip}:9090/api/v1/upload \
  -H 'Authorization: Basic \
VWpsTVMrMG0xbDlJVVpqcGpXeUpHOGdibnYyTXRhNFQ=' \
  -F 'options={
    "imageId": "1787b5e3689a8435388b96b7a32e9c87f",
    "detonation": {
        "type": "url",
        "detonationProfile": "medium",
        "url": "http://www.infected.info/test.php"
    }
}'

Хариу:

{
    "code": 200,
    "message": "Ok",
    "submissionId": "sp02_1547807011_936_e5",
    "file": "infected.zip"
}