createSubmitToSandboxAnalyzerTask: файлыг Sandbox Analyzer-т илгээх task

Энэ method-оор Sandbox Analyzer task үүсгэж, шинжлүүлэхээр дээд тал нь 5 файл илгээнэ. Task нь шинжлэх файлуудыг болон процесст оролцох бусад шаардлагатай файлуудыг заасан endpoint-оос татаж авна.

Параметрүүд

• `targetId` — String; заавал; task-ийг эхлүүлэх, илгээх файлууд байрлах endpoint-ийн ID. Нэмэлт шаардлага байхгүй. Жишээ: "targetId": "5d7244b10ea1de153817c072"
• `samplePaths` — Array of Strings; заавал; шинжлүүлэхээр илгээх файлуудын path. Array нь 1-ээс 5 String агуулна. Утга бүр зөв path хэлбэртэй, 1024 хүртэл тэмдэгттэй байна. Жишээ: "samplePaths": [ "C:\\first-script.ps1", "C:\\executable.exe", "C:\\text-file.txt" ]
• `commandLines` — Array of Strings; заавал биш; Sandbox Analyzer-т файл тус бүрийг хэрхэн боловсруулахыг тохируулах олон String агуулна. String бүр хоёр элементтэй: файлыг боловсруулах зааврыг агуулсан script-үүдийн path, мөн зааврыг хэрэгжүүлэх файлын path. Array нь 1-ээс 10 String агуулна. Хоёр path-ийн аль аль нь зөв хэлбэртэй байна. String бүр 4096 хүртэл тэмдэгттэй байна. Жишээ: "commandLines": [ "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe C:\\first-script.ps1", "C:\\executable.exe -v --dry delete-all", "runas /user:Administrator C:\Program Files\Notepad++\notepad++.exe C:\\text1.txt" ]
• `taskName` — String; заавал биш; task-д өгөх нэр. String нь 512 хүртэл тэмдэгттэй байна. Анхдагч утга: Submit to Sandbox Analyzer YYYY-MM-DD. Жишээ: "taskName": "Submit to Sandbox Task Example"

Буцаах утга

• `result` — String; амжилттай бол үүссэн task-ийн ID-г буцаана.

Алдааны мессежүүд

• -32602 — Invalid params; "details": "No applicable targets were found."
• -32602 — Invalid params; "details": "Target's company does not have a license that includes Sandbox Analyzer feature."
• -32602 — Invalid params; "details": "Target operating system not supported."
• -32602 — Invalid params; "details": "You must specify at least one sample path."
• -32602 — Invalid params; "details": "The maximum number of 5 paths has been exceeded."
• -32602 — Invalid params; "details": "The path must have a maximum of 1024 characters."
• -32602 — Invalid params; "details": "Invalid path format."
• -32602 — Invalid params; "details": "The command line must have a maximum of 4096 characters."
• -32602 — Invalid params; "details": "The maximum number of 10 command lines has been exceeded."
• -32602 — Invalid params; "details": "The task name must have a maximum of 512 characters."

Жишээ

Хүсэлт

{
    "params": {
        "targetId": "5d7244b10ea1de153817c072",
        "samplePaths": [
            "C:\\first-script.ps1",
            "C:\\executable.exe",
            "C:\\text-file.txt"
            "C:\\text-file2.txt"
        ],
        "commandLines": [
            "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe C:\\first-script.ps1",
            "C:\\executable.exe -v --dry delete-all",
            "runas /user:Administrator C:\Program Files\Notepad++\notepad++.exe C:\\text1.txt"
        ],
        "taskName": "Submit to Sandbox Task Example"
    },
    "jsonrpc": "2.0",
    "method": "createSubmitToSandboxAnalyzerTask",
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f"
}

Хариу

{
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "jsonrpc":"2.0",
    "result": "6560a95884f89d6eca0b61b1"
}