collectInvestigationPackage — forensic багц цуглуулах

Энэ method-оор endpoint дээр forensic цуглуулалтын даалгавар эхлүүлнэ. Endpoint урьдчилан тодорхойлсон investigation package-ийг цуглуулж, цаашдын шинжилгээнд зориулан GravityZone-ийн төвлөрсөн хадгалалтын байршилд байршуулна. Investigation package-д орох өгөгдлийн талаар Investigation Package data-г үзнэ үү.

API URL: CONTROL_CENTER_APIs_ACCESS_URL/v1.0/jsonrpc/investigation.

Parameters

• targetId — Заавал; төрөл: String. Investigation package цуглуулах даалгаврын зорилтот, удирдагдаж буй endpoint-ийн ID. Яг 24 арван зургаатын (hexadecimal) тэмдэгт агуулсан, удирдагдаж буй endpoint-ийн хүчинтэй ID байх ёстой.

General parameters

Эдгээр нь public API-ийн бүх method-д нийтлэг хэрэглэгддэг параметрүүд юм:

• id — Заавал; төрөл: String. Хүсэлтэд танигч нэмж, түүнийг хариутай холбоно. Хүлээн авагч хариунд ижил утгыг буцаадаг тул дуудлагыг хялбар мөрдөнө. Нэмэлт шаардлага байхгүй. Жишээ: "id": "ad12cb61-52b3-4209-a87a-93a8530d91cb"
• method — Заавал; төрөл: String. Хүсэлт илгээхэд ашиглаж буй method-ийн нэр. Хүчинтэй method-ийн нэр байх ёстой. Жишээ: "method": "methodName"
• jsonrpc — Заавал; төрөл: String. Хүсэлт болон хариуны ашигладаг JSON-RPC-ийн хувилбар. Цорын ганц боломжит утга нь 2.0. Жишээ: "jsonrpc": "2.0"
• params — Заавал; төрөл: Object. Хүсэлтийн тохиргоог агуулсан объект. Нэмэлт шаардлага байхгүй. Жишээ: "params": {...}

Return value

• result — төрөл: Object. Эхлүүлсэн даалгаврын танигчийг агуулна. Дэлгэрэнгүйг доорх result объектоос үзнэ үү.

Objects

result

• activityId — төрөл: String. Эхлүүлсэн даалгаврын танигч.

> Зөвлөмж: Даалгавар дууссаны дараа forensic artifact-ийн архивыг татах URL-ийг авахын тулд энэ утгыг `getInvestigationFileUrl`-ийн activityId параметрт ашиглана. Investigation package-ийг GravityZone Control Center-ээс шууд татаж болно: Network хэсгээс endpoint-ийн дэлгэрэнгүйг нээж, Investigation таб руу орно.

Example

Request:

{
    "jsonrpc": "2.0",
    "method": "collectInvestigationPackage",
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "params": {
        "targetId": "559bd17ab1a43d241b7b23c6"
    }
}

Response:

{
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "jsonrpc": "2.0",
    "result": {
        "activityId": "559bd17ab1a43d241b7b23d7"
    }
}