Sebezhetőségek listázása gép és szoftver szerint

Lekéri a szervezetet érintő biztonsági rések listáját gépenként és szoftverenként.

Ez az API a Power BI-integrációhoz használható.

• Ha a biztonsági rés rendelkezik kijavított kb-tal, az megjelenik a válaszban.

• Támogatja az OData V4-lekérdezéseket. OData által támogatott operátorok:

  • $filtera következő tulajdonságok támogatottak:
    • id
    • cveId
    • machineId
    • fixingKbId
    • productName
    • productVersion
    • severity
    • productVendor
  • $stop legfeljebb 10 000 értékkel.
  • $skip

  Lásd a példákat az OData-lekérdezések Végponthoz készült Microsoft Defender.

Engedélyek

Az API meghívásához az alábbi engedélyek egyikére van szükség. További információ, többek között az engedélyek kiválasztása: Végponthoz készült Microsoft Defender API-k használata.

Engedély típusa	Engedély	Engedély megjelenítendő neve
Alkalmazás	Vulnerability.Read.All	"Veszélyforrás- és biztonságirés-kezelési biztonságirés-információk olvasása"
Delegált (munkahelyi vagy iskolai fiók)	Biztonsági rés.Read	"Veszélyforrás- és biztonságirés-kezelési biztonságirés-információk olvasása"

HTTP-kérés

GET /api/vulnerabilities/machinesVulnerabilities

Kérelemfejlécek

Name (Név)	Típus	Leírás
Engedélyezési	Karakterlánc	Tulajdonos : {token}. Kötelező megadni.

Kérelem törzse

Üres

Válasz

Ha sikerült, ez a metódus 200 OK értéket ad vissza a törzsben található biztonsági rések listájával.

Példa

Példa kérésre

Íme egy példa a kérésre.

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

Példa válaszra

Íme egy példa a válaszra.

{
    "@odata.context": "https://api.security.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"
        },
        ...
    ]

}