Lista sårbarheter efter maskin och programvaraList vulnerabilities by machine and software

Gäller för:Applies to:

Vill du uppleva Microsoft Defender för Slutpunkt?Want to experience Microsoft Defender for Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.Sign up for a free trial.

Anteckning

Om du är myndighetskund i USA kan du använda de URI:er som visas i Microsoft Defender för Slutpunkt för kunder inom myndigheter i USA.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Tips

För bättre prestanda kan du använda servern närmare din geografiska plats:For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

Hämtar en lista över alla säkerhetsproblem som påverkar organisationen per maskin- och programvara.Retrieves a list of all the vulnerabilities affecting the organization per machine and software.

  • Om problemet har åtgärdats, visas det i svaret.If the vulnerability has a fixing KB, it will appear in the response.
  • Stöder OData V4-frågor.Supports OData V4 queries.
  • OData $filter stöds för alla egenskaper.The OData $filter is supported on all properties.

Tips

Det här är bra API för Power BI-integrering.This is great API for Power BI integration.

BehörigheterPermissions

En av följande behörigheter krävs för att anropa detta API.One of the following permissions is required to call this API. Mer information, inklusive hur du väljer behörigheter, finns i Använda Microsoft Defender för slutpunkts-API:er för mer information.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

BehörighetstypPermission type BehörighetPermission Visningsnamn för behörighetPermission display name
ProgramApplication Vulnerability.Read.AllVulnerability.Read.All "Läs sårbarhetsinformation för hot och sårbarhetshantering"'Read Threat and Vulnerability Management vulnerability information'
Delegerat (arbets- eller skolkonto)Delegated (work or school account) Sårbarhet.LäsaVulnerability.Read "Läs sårbarhetsinformation för hot och sårbarhetshantering"'Read Threat and Vulnerability Management vulnerability information'

HTTP-begäranHTTP request

GET /api/vulnerabilities/machinesVulnerabilities

Begäran om rubrikerRequest headers

NamnName SkrivType BeskrivningDescription
AuktoriseringAuthorization SträngString Bearer {token}.Bearer {token}. Obligatoriskt.Required.

Begärans brödtextRequest body

TomEmpty

SvarResponse

Om det lyckas returnerar den här metoden 200 OK med en lista över säkerhetsproblem i brödtexten.If successful, this method returns 200 OK with the list of vulnerabilities in the body.

ExempelExample

BegäranRequest

Här är ett exempel på begäran.Here is an example of the request.

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

SvarResponse

Här är ett exempel på svaret.Here is an example of the response.

{
    "@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"
        },
        ...
    ]

}

Se ävenSee also