Lijst van beveiligingsproblemen per computer en software

Artikel
08/14/2024

Van toepassing op:

Wilt u Microsoft Defender voor Eindpunt ervaren? Meld u aan voor een gratis proefversie.

Opmerking

Als u een klant van de Amerikaanse overheid bent, gebruikt u de URI's die worden vermeld in Microsoft Defender voor Eindpunt voor klanten van de Amerikaanse overheid.

Tip

Voor betere prestaties kunt u de server dichter bij uw geografische locatie gebruiken:

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

Haalt per computer en software een lijst op met alle beveiligingsproblemen die van invloed zijn op de organisatie.

Als het beveiligingsprobleem een kb voor het oplossen van problemen heeft, wordt deze weergegeven in het antwoord.
Ondersteunt OData V4-query's.
De OData-query $filter wordt ondersteund op: id, cveId, machineId, fixingKbId, productName, productVersion, , severity, en productVendor eigenschappen.
$stop met een maximale waarde van 10.000
$skip

Tip

Dit is een geweldige API voor Power BI-integratie.

Machtigingen

Een van de volgende machtigingen is vereist om deze API aan te roepen. Zie Microsoft Defender voor Eindpunt-API's gebruiken voor meer informatie, waaronder het kiezen van machtigingen.

Machtigingstype	Machtiging	Weergavenaam van machtiging
Toepassing	Vulnerability.Read.All	'Informatie over beveiligingsproblemen in bedreigings- en beveiligingsbeheer lezen'
Gedelegeerd (werk- of schoolaccount)	Vulnerability.Read	'Informatie over beveiligingsproblemen in bedreigings- en beveiligingsbeheer lezen'

HTTP-aanvraag

GET /api/vulnerabilities/machinesVulnerabilities

Aanvraagheaders

Naam	Type	Beschrijving
Machtiging	Tekenreeks	Bearer {token}. Vereist.

Aanvraagtekst

Leeg

Antwoord

Als dit lukt, retourneert deze methode 200 OK met de lijst met beveiligingsproblemen in de hoofdtekst.

Voorbeeld

Voorbeeld van aanvraag

Hier volgt een voorbeeld van de aanvraag.

GET https://api.securitycenter.microsoft.com/api/vulnerabilities/machinesVulnerabilities

Antwoordvoorbeeld

Hier volgt een voorbeeld van het antwoord.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.PublicAssetVulnerabilityDto)",
    "value": [
        {
            "id": "5afa3afc92a7c63d4b70129e0a6f33f63a427e21-_-CVE-2020-6494-_-microsoft-_-edge_chromium-based-_-81.0.416.77-_-",
            "cveId": "CVE-2020-6494",
            "machineId": "5afa3afc92a7c63d4b70129e0a6f33f63a427e21",
            "fixingKbId": null,
            "productName": "edge_chromium-based",
            "productVendor": "microsoft",
            "productVersion": "81.0.416.77",
            "severity": "Low"
        },
        {
            "id": "7a704e17d1c2977c0e7b665fb18ae6e1fe7f3283-_-CVE-2016-3348-_-microsoft-_-windows_server_2012_r2-_-6.3.9600.19728-_-3185911",
            "cveId": "CVE-2016-3348",
            "machineId": "7a704e17d1c2977c0e7b665fb18ae6e1fe7f3283",
            "fixingKbId": "3185911",
            "productName": "windows_server_2012_r2",
            "productVendor": "microsoft",
            "productVersion": "6.3.9600.19728",
            "severity": "Low"
        },
        ...
    ]

}

Zie ook

Tip

Wil je meer weten? Neem contact op met de Microsoft Security-community in onze Tech Community: Microsoft Defender for Endpoint Tech Community.

Delen via