목록 - 경고 API
GET 또는 POST 요청을 실행하여 지정된 필터와 일치하는 경고 목록을 가져옵니다.
GET /api/v1/alerts/
POST /api/v1/alerts/
매개 변수 | 설명 |
---|---|
필터 | 요청에 대한 모든 검색 필터를 사용하여 개체를 필터링합니다. 자세한 내용은 경고 필터를 참조하세요 . |
sortDirection | 정렬 방향입니다. 가능한 값은 및 입니다 asc . desc |
sortField | 경고를 정렬하는 데 사용되는 필드입니다. 가능한 값은 다음과 같습니다. - date: 경고가 만들어진 날짜입니다. - 심각도: 경고의 심각도 |
거르다 | 지정된 레코드 수를 건너뜁니다. |
한계 | 요청에서 반환된 최대 레코드 수 |
다음은 요청의 예입니다.
curl -XPOST -H "Authorization:Token <your_token_key>" -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/alerts/" -d '{
"filters": {
// some filters
},
"skip": 5,
"limit": 10
...
}'
JSON 형식의 경고 목록을 반환합니다. 각 속성에 대한 자세한 내용은 경고 속성 사양을 참조하세요.
{
"data": [
{
"_id": "603f704aaf7417985bbf3b22",
"contextId": "206e2965-6533-48a6-ba9e-794364a84bf9",
"description": "Contoso user performed 11 suspicious activities MITRE Technique used Account Discovery (T1087) and subtechnique used Domain Account (T1087.002)",
"entities": [
{
"entityRole": "Source",
"entityType": 2,
"id": "6204bdaf-ad46-4e99-a25d-374a0532c666",
"inst": 0,
"label": "user1",
"pa": "user1@contoso.com",
"type": "account"
},
{
"entityRole": "Related",
"id": "55017817-27af-49a7-93d6-8af6c5030fdb",
"label": "DC3",
"type": "device"
},
{
"id": 20940,
"label": "Active Directory",
"type": "service"
},
{
"entityRole": "Related",
"id": "95c59b48-98c1-40ff-a444-d9040f1f68f2",
"label": "DC4",
"type": "device"
},
{
"id": "5bfd18bfab73c36ba10d38ca",
"label": "Honeytoken activity",
"policyType": "ANOMALY_DETECTION",
"type": "policyRule"
},
{
"entityRole": "Source",
"id": "34f3ecc9-6903-4df7-af79-14fe2d0d4553",
"label": "Client1",
"type": "device"
},
{
"entityRole": "Related",
"id": "d68772fe-1171-4124-9f73-0f410340bd54",
"label": "DC1",
"type": "device"
},
{
"type": "groupTag",
"id": "5f759b4d106abbe4a504ea5d",
"label": "All Users"
}
],
"idValue": 15795464,
"isSystemAlert": false,
"resolutionStatusValue": 0,
"severityValue": 1,
"statusValue": 1,
"stories": [
0
],
"threatScore": 34,
"timestamp": 1621941916475,
"title": "Honeytoken activity",
"comment": "",
"handledByUser": "administrator@contoso.com",
"resolveTime": "2021-05-13T14:02:34.904Z",
"URL": "https://contoso.portal.cloudappsecurity.com/#/alerts/603f704aaf7417985bbf3b22"
}
],
"hasNext": false,
"max": 1,
"total": 1,
"moreThanTotal": false
}
문제가 발생하면 도움을 드리겠습니다. 제품 문제에 대한 지원 또는 지원을 받으려면 지원 티켓을 여세요.