How to get Audit logs of Microsoft defender for endpoint using Rest APIs.

Pavan Bollepalli 0

How to get Audit logs of Microsoft defender for endpoint using Rest APIs with start time & end time along with pagination

1 answer

Catherine Kyalo 655 Microsoft Employee

Hi @Pavan Bollepalli You can use the createdDateTime parameter that is supported as per https://video2.skills-academy.com/en-us/graph/api/security-list-alerts_v2?view=graph-rest-beta&tabs=http#optional-query-parameters. Below query is a sample

2024-02-13T12:49:01.00Zhttps://graph.microsoft.com/v1.0/security/alerts_v2?$filter=createdDateTime ge 2024-02-12T12:49:01.00Z and createdDateTime le 2024-02-13T12:49:01.00Z&$top=50

To apply pagination, you can use $top and parameters:

Niharika Naik 0 Reputation points

2024-03-13T06:01:45.9266667+00:00

@Catherine Kyalo Could you tell me what are the possible values of the field "category" in Alert API response?
Currently I'm only getting "Malware" and "execution" as values for "category".
Catherine Kyalo 655 Reputation points Microsoft Employee

2024-03-13T09:02:24.2033333+00:00
Hi @Niharika Naik

The category property is aligned to the attack kill-chain category that the alert belongs to according to the MITRE ATT&CK framework.

Persistence

Execution

Discovery

Suspicious Activity

Credentia Theft (and more)

More information can be found here https://techcommunity.microsoft.com/t5/microsoft-defender-for-endpoint/microsoft-defender-atp-alert-categories-are-now-aligned-with/ba-p/732748

Niharika Naik 0

Hi @Catherine Kyalo
Thank you for the response

In the documentation, "Malware" category is not mentioned and yet we are getting it in our response. Do you know if "Malware" is a subcategory of any other category? If yes, which one?
I have added the response we got below for reference:
(I have hidden the sensitive data)

{
            "id": "da2363e68b-xxxx-xxxx-be55-d2104788ab41_1",
            "providerAlertId": "xxxxxxxx-753d-4d90-be55-d2104788ab41_1",
            "incidentId": "8",
            "status": "resolved",
            "severity": "informational",
            "classification": null,
            "determination": null,
            "serviceSource": "microsoftDefenderForEndpoint",
            "detectionSource": "antivirus",
            "productName": "Microsoft Defender for Endpoint",
            "detectorId": "xxxxxxxx-ecd8-4d77-8186-a801597ec762",
            "tenantId": "c19fb0c9-a0e8-xxxx-xxxx-0c4e7d7e8ae1",
            "title": "'EICAR_Test_File' malware was prevented",
            "description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nThis detection might indicate that the malware was stopped from delivering its payload. However, it is prudent to check the machine for signs of infection.",
            "recommendedActions": "Collect artifacts and determine scope\n•\tReview the machine timeline for suspicious activities that may have occurred before and after the time of the alert, and record additional related artifacts (files, IPs/URLs) \n•\tLook for the presence of relevant artifacts on other systems. Identify commonalities and differences between potentially compromised systems.\n•\tSubmit relevant files for deep analysis and review resulting detailed behavioral information.\n•\tSubmit undetected files to the MMPC malware portal\n\nInitiate containment & mitigation \n•\tContact the user to verify intent and initiate local remediation actions as needed.\n•\tUpdate AV signatures and run a full scan. The scan might reveal and remove previously-undetected malware components.\n•\tEnsure that the machine has the latest security updates. In particular, ensure that you have installed the latest software, web browser, and Operating System versions.\n•\tIf credential theft is suspected, reset all relevant users passwords.\n•\tBlock communication with relevant URLs or IPs at the organization’s perimeter.",
            "category": "Malware",
            "assignedTo": "API-App:API Action",
            "alertWebUrl": "https://security.microsoft.com/alerts/xxxxxxxx-xxxx-xxxx-xxxx-d2104788ab41_1?tid=c19fb0c9-a0e8-42bd-8974-0c4e7d7e8ae1",
            "incidentWebUrl": "https://security.microsoft.com/incidents/8?tid=c19fb0c9-xxxx-xxxx-8974-0c4e7d7e8ae1",
            "actorDisplayName": null,
            "threatDisplayName": "Virus:DOS/EICAR_Test_File",
            "threatFamilyName": "EICAR_Test_File",
            "mitreTechniques": [],
            "createdDateTime": "2024-03-13T11:36:20.0966667Z",
            "lastUpdateDateTime": "2024-03-13T11:45:01.0266667Z",
            "resolvedDateTime": "2024-03-13T11:45:00.8728917Z",
            "firstActivityDateTime": "2024-03-13T11:35:25.0597141Z",
            "lastActivityDateTime": "2024-03-13T11:35:25.0597141Z",
            "systemTags": [],
            "alertPolicyId": null,
            "additionalData": null,
            "comments": [],
            "evidence": [
                {
                    "@odata.type": "#microsoft.graph.security.fileEvidence",
                    "createdDateTime": "2024-03-13T11:36:20.2Z",
                    "verdict": "malicious",
                    "remediationStatus": "prevented",
                    "remediationStatusDetails": "Entity was pre-remediated by Windows Defender",
                    "roles": [],
                    "detailedRoles": [],
                    "tags": [],
                    "detectionStatus": "prevented",
                    "mdeDeviceId": "xxx",
                    "fileDetails": {
                        "sha1": "xxx",
                        "sha256": "xxx",
                        "fileName": "EICAR.txt",
                        "filePath": "C:\\Users\\xxx\\Downloads",
                        "fileSize": 68,
                        "filePublisher": null,
                        "signer": null,
                        "issuer": null
                    }
                },
                {
                    "@odata.type": "#microsoft.graph.security.deviceEvidence",
                    "createdDateTime": "2024-03-13T11:36:20.2Z",
                    "verdict": "unknown",
                    "remediationStatus": "none",
                    "remediationStatusDetails": null,
                    "roles": [],
                    "detailedRoles": [
                        "PrimaryDevice"
                    ],
                    "tags": [],
                    "firstSeenDateTime": "2024-02-20T06:25:28.862052Z",
                    "mdeDeviceId": "xxx",
                    "azureAdDeviceId": null,
                    "deviceDnsName": "desktop-xxx",
                    "osPlatform": "Windows11",
                    "osBuild": 22621,
                    "version": "22H2",
                    "healthStatus": "active",
                    "riskScore": "medium",
                    "rbacGroupId": 0,
                    "rbacGroupName": null,
                    "onboardingStatus": "onboarded",
                    "defenderAvStatus": "notSupported",
                    "ipInterfaces": [
                        "192.168.0.153",
                        "fd01::a0cc:36f6:177e:2caa",
                        "fd01::9127:d317:a584:c85a",
                        "fe80::3868:e243:3bac:67f0",
                        "127.0.0.1",
                        "::1"
                    ],
                    "vmMetadata": null,
                    "loggedOnUsers": [
                        {
                            "accountName": "xxx",
                            "domainName": "DESKTOP-xxx"
                        }
                    ]
                }
            ]

Share via

How to get Audit logs of Microsoft defender for endpoint using Rest APIs.

1 answer