Как загрузить файл или архив на сервер vxCube

Вы можете загрузить на сервер vxCube для последующего анализа как отдельный файл, так и архив с несколькими файлами. Информация о поддерживаемых форматах файлов и архивов приведена в разделе Поддерживаемые форматы.

Как загрузить на сервер vxCube отдельный файл

Чтобы загрузить на сервер файл, отправьте запрос POST samples:

curl -X POST https://<IP-адрес/доменное имя сервера>/api-2.0/samples \

-F "file=@testfile.pdf" \

-F "password="vxcube"" \

-H "Authorization: api-key aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

В ответ вы получите объект Sample, который будет содержать данные о загруженном файле, в том числе формат файла, определенный автоматически, и список поддерживаемых платформ. Используйте данные из ответа при отправке запроса на анализ загруженного файла.

Пример ответа:

{

   "id": 6784,

   "size": 10881846,

   "name": "testfile.pdf",

   "is_x64": null,

   "format_name": "pdf",

   "upload_date": "2019-02-08T04:08:15.162343+00:00",

   "md5": "34fb8ae3c01653985085ee7e2f749ea5",

   "sha1": "00a610100a3516f4d0daa33e7de317d2ddb6c2c6",

   "sha256": "11bd131be00cbe1c43b4444ec4300dc7651805ea36393b1cca1675983dc275bc",

   "platforms": [

       "acrobat_xp_10",

       "acrobat_7_32_11",

       "acrobat_7_64_15",

       "acrobat_10_64_15",

       "acrobat_11_64_15"

   ]

}

Как загрузить на сервер vxCube архив с файлами

Чтобы загрузить на сервер архив, отправьте запрос POST samples:

curl -X POST https://<IP-адрес/доменное имя сервера>/api-2.0/samples \

-F "file=@testarchive.zip" \

-F "password="vxcube"" \

-H "Authorization: api-key aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

В ответ вы получите список объектов Sample, которые будут содержать данные о загруженных в составе архива файлах, в том числе формат файлов, определенный автоматически, и список поддерживаемых платформ. Используйте данные из ответа при отправке запроса на анализ файлов. Обратите внимание, что для каждого файла из архива потребуется отправить отдельный запрос на анализ.

Пример ответа:

{

   "samples": [

     {

       "id": 322277,

       "name": "script_bash.sh",

       "size": 31,

       "format_name": "sh",

       "upload_date": "2025-01-10T10:22:05.370576",

       "md5": "ee7f40fc10ebc0c5227f2307d4cc0eec",

       "sha1": "824917b5b19af65b09b4f879787bcbc304304df3",

       "sha256": "7a4b93d2a929c865da7f8fa060cf8bdeba00caa3a246c00c61819e101578c525",

       "is_x64": null,

       "platforms": [

           "intel64_astra_ce_2.12",

           "intel64_astra_se_1.7.2",

           "intel64_debian_bullseye"

       ]

     },

     {

       "id": 322278,

       "name": "Simulator.exe",

       "size": 12796104,

       "format_name": "exe",

       "upload_date": "2025-01-10T10:22:06.673229",

       "md5": "1d8a2c83aeec264d6df97f3867d13051",

       "sha1": "6e417d89c4a6ae436f815ee038255f5dbf31c1ca",

       "sha256": "b1fd18441460ed1bd9b6a8107f2f09ddc971ed33ddbca53c6a38124f6830b2d9",

       "is_x64": false,

       "platforms": [

           "win11x64",

           "win10x64",

           "win7x64",

           "win7x86",

           "winxpx86"

       ]

     },

     {

       "id": 322279,

       "name": "Welcome.doc",

       "size": 28909,

       "format_name": "odt",

       "upload_date": "2025-01-10T10:22:06.684141",

       "md5": "64df4748a0e674cb65601a1157a1c900",

       "sha1": "0bfac9df80cade5b8b03576194549b197fc34388",

       "sha256": "7ce72f1ea01bea3d99e4658e5dc909e662e10c65d83d280aa4bf0e25526bf752",

       "is_x64": null,

       "platforms": [

           "office_11_64",

           "office_10_64",

           "office_7_32",

           "office_7_64",

           "office_xp"

       ]

     }

   ]

}