Eksportér vurdering af softwaresårbarheder pr. enhed

Artikel
01/31/2025

Gælder for:

Vil du opleve Microsoft Defender for Endpoint? Tilmeld dig en gratis prøveversion.

Returnerer alle kendte softwaresårbarheder og deres oplysninger for alle enheder på enhedsbasis.

Forskellige API-kald henter forskellige typer data. Da mængden af data kan være stor, er der tre måder, den kan hentes på:

Vurdering af softwaresårbarheder: JSON-svar API'en henter alle data i din organisation som Json-svar. Denne metode er bedst til små organisationer med mindre end 100.000 enheder. Svaret er sideinddelt, så du kan bruge feltet @odata.nextLink fra svaret til at hente de næste resultater.
Eksportér vurdering af softwaresårbarheder: via filer Denne API-løsning gør det muligt at trække større mængder data hurtigere og mere pålideligt. Via-filer anbefales til store organisationer med mere end 100.000 enheder. Denne API henter alle data i din organisation som downloadfiler. Svaret indeholder URL-adresser til download af alle data fra Azure Storage. Denne API giver dig mulighed for at downloade alle dine data fra Azure Storage på følgende måde:
- Kald API'en for at få en liste over URL-adresser til download med alle dine organisationsdata.
- Download alle filerne ved hjælp af URL-adresserne til download, og behandl dataene, som du vil.
Vurdering af sårbarheder i forbindelse med deltaeksportsoftware: JSON-svar Returnerer en tabel med en post for hver entydige kombination af: DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion, CveId og EventTimestamp. API'en henter data i din organisation som Json-svar. Svaret er sideinddelt, så du kan bruge feltet @odata.nextLink fra svaret til at hente de næste resultater.

Den fulde "vurdering af softwaresårbarheder (JSON-svar)" bruges til at få et helt snapshot af vurderingen af softwaresårbarheder for din organisation efter enhed. Api-kaldet til deltaeksport bruges dog kun til at hente de ændringer, der er foretaget mellem en valgt dato og dags dato (API-kaldet "delta"). I stedet for at få en fuld eksport med en stor mængde data hver gang, får du kun specifikke oplysninger om nye, faste og opdaterede sikkerhedsrisici. Delta export JSON-svar-API-kald kan også bruges til at beregne forskellige KPI'er, f.eks. "hvor mange sikkerhedsrisici blev løst?" eller "Hvor mange nye sikkerhedsrisici blev føjet til min organisation?"

Da deltaeksport-JSON-svar-API-kaldet for softwaresårbarheder kun returnerer data for et bestemt datointerval, anses det ikke for at være en fuld eksport.

Data, der indsamles (ved hjælp af enten Json-svar eller via filer), er det aktuelle snapshot af den aktuelle tilstand. Den indeholder ikke historiske data. For at indsamle historiske data skal kunderne gemme dataene i deres egne datalagre.

Bemærk!

Medmindre andet er angivet, er alle angivne eksportvurderingsmetoder fuld eksport og efter enhed (også kaldet pr. enhed).

1. Eksportér vurdering af softwaresårbarheder (JSON-svar)

Beskrivelse af API-metoden 1.1

Dette API-svar indeholder alle data fra installeret software pr. enhed. Returnerer en tabel med en post for hver entydige kombination af DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion og CVEID.

1.1.1 Begrænsninger

Den maksimale sidestørrelse er 200.000.
Hastighedsbegrænsninger for denne API er 30 kald pr. minut og 1.000 opkald pr. time.

1.2 Tilladelser

En af følgende tilladelser er påkrævet for at kalde denne API. Du kan få mere at vide, herunder hvordan du vælger tilladelser, under Brug Microsoft Defender for Endpoint API'er for at få flere oplysninger.

Tilladelsestype	Tilladelse	Vist navn for tilladelse
Program	Vulnerability.Read.All	'Læs oplysninger om sårbarheder i forbindelse med trussels- og sårbarhedsstyring'
Uddelegeret (arbejds- eller skolekonto)	Vulnerability.Read	'Læs oplysninger om sårbarheder i forbindelse med trussels- og sårbarhedsstyring'

1.3 URL-adresse

GET /api/machines/SoftwareVulnerabilitiesByMachine

1.4 Parametre

pageSize (standard = 50.000): Antal resultater i svar.
$top: Antallet af resultater, der skal returneres (returnerer @odata.nextLink ikke og trækker derfor ikke alle dataene).

1.5 Egenskaber

Bemærk!

Hver post er 1 KB data. Du skal tage højde for denne størrelse, når du vælger den korrekte pageSize-parameter for dig.
Nogle andre kolonner returneres muligvis i svaret. Disse kolonner er midlertidige og kan blive fjernet, så brug kun de dokumenterede kolonner.
De egenskaber, der er defineret i følgende tabel, vises alfabetisk efter egenskabs-id. Under kørsel af denne API returneres det resulterende output ikke nødvendigvis i den samme rækkefølge, som er angivet i denne tabel.

Egenskab (id)	Datatype	Beskrivelse	Eksempel på en returneret værdi
CveId	String	Entydigt id, der er tildelt sikkerhedssårbarheden under CVE-systemet (Common Vulnerabilities and Exposures).	CVE-2020-15992
CvssScore	Dobbelt	CVSS-scoren for CVE.	6.2
DeviceId	String	Entydigt id for enheden i tjenesten.	9eaf3a8b5962e0e6b1af9ec756664a9b823df2d1
DeviceName	String	Fuldt domænenavn (FQDN) for enheden.	johnlaptop.europe.contoso.com
DiskPaths	Matrix[streng]	Disk, der beviser, at produktet er installeret på enheden.	["C:\Programmer (x86)\Microsoft\Silverlight\Application\silverlight.exe"]
Udnyttelsesniveau	String	Udnyttelsesniveauet for denne sårbarhed (NoExploit, ExploitIsPublic, ExploitIsVerified, ExploitIsInKit)	ExploitIsInKit
FirstSeenTimestamp	String	Første gang, dette produkt CVE blev set på enheden.	2020-11-03 10:13:34.8476880
ID	String	Entydigt id for posten.	123ABG55_573AG&mnp!
LastSeenTimestamp	String	Sidste gang softwaren blev rapporteret på enheden.	2020-11-03 10:13:34.8476880
OSPlatform	String	Platform for det operativsystem, der kører på enheden. Denne egenskab angiver specifikke operativsystemer med variationer inden for samme familie, f.eks. Windows 10 og Windows 11. Se Admininstration af håndtering af sikkerhedsrisici til Microsoft Defender understøttede operativsystemer og platforme for at få flere oplysninger.	Windows10 og Windows 11
RbacGroupName	String	Den rollebaserede adgangskontrolgruppe (RBAC). Hvis denne enhed ikke er tildelt nogen RBAC-gruppe, er værdien "Ikke tildelt". Hvis organisationen ikke indeholder nogen RBAC-grupper, er værdien "Ingen".	Servere
Reference til anbefaling	String	En reference til det anbefalings-id, der er relateret til denne software.	va--microsoft--silverlight
RecommendedSecurityUpdate (valgfrit)	String	Navn på eller beskrivelse af den sikkerhedsopdatering, der leveres af softwareleverandøren til at løse problemet med sårbarheden.	Sikkerheds Opdateringer fra april 2020
RecommendedSecurityUpdateId (valgfrit)	String	Identifikator for de relevante sikkerhedsopdateringer eller identifikator for de tilsvarende artikler om vejledning eller videnbase (KB)	4550961
RegistryPaths	Matrix[streng]	Registreringsdatabase beviser, at produktet er installeret på enheden.	["HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\MicrosoftSilverlight"]
Sikkerhedsopdatering er tilgængelig	Boolesk	Angiver, om der er en tilgængelig sikkerhedsopdatering til softwaren.	De mulige værdier er true eller false.
SoftwareName	String	Navnet på softwareproduktet.	Krom
SoftwareVendor	String	Navnet på softwareleverandøren.	Google
SoftwareVersion	String	Softwareproduktets versionsnummer.	81.0.4044.138
VulnerabilitySeverityLevel	String	Alvorsgradsniveau, der er tildelt sikkerhedssårbarheden baseret på CVSS-scoren.	Middel

1.6 Eksempler

1.6.1 Eksempel på anmodning

GET https://api.securitycenter.microsoft.com/api/machines/SoftwareVulnerabilitiesByMachine?pageSize=5

1.6.2 Svareksempel

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.AssetVulnerability)",
    "value": [
        {
            "id": "00044f612345baf759462dbe6db733b6a9c59ab4_edge_10.0.17763.1637__",
            "deviceId": "00044f612345daf756462bde6bd733b9a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18663b45912eed224b2de2f5ea3142726e63f16a.DomainPII_21eeb80d089e79bdfa178eabfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "edge",
            "softwareVersion": "10.0.17763.1637",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [],
            "lastSeenTimestamp": "2020-12-30 14:17:26",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-edge",
            "securityUpdateAvailable": true
        },
        {
            "id": "00044f912345baf756462bde6db733b9a9c56ad4_.net_framework_4.0.0.0__",
            "deviceId": "00044f912345daf756462bde6db733b6a9c59ad4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18663b45912eed224b2be2f5ea3142726e63f16a.DomainPII_21eeb80b086e79bdfa178eabfa25e8de6acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": ".net_framework",
            "softwareVersion": "4.0.0.0",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "SOFTWARE\\Microsoft\\NET Framework Setup\\NDP\\v4.0\\Client\\Install"
            ],
            "lastSeenTimestamp": "2020-12-30 13:18:33",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-.net_framework",
            "securityUpdateAvailable": true
        },
        {
            "id": "00044f912345baf756462dbe6db733d6a9c59ab4_system_center_2012_endpoint_protection_4.10.209.0__",
            "deviceId": "00044f912345daf756462bde6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18663b45912eed224b2be2f5ea3142726e63f16a.DomainPII_21eed80b089e79bdfa178eadfa25e8be6acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "system_center_2012_endpoint_protection",
            "softwareVersion": "4.10.209.0",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Security Client"
            ],
            "lastSeenTimestamp": "2020-12-30 14:17:26",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-system_center_2012_endpoint_protection",
            "securityUpdateAvailable": true
        },
        {
            "id": "00044f612345bdaf759462dbe6bd733b6a9c59ab4_onedrive_20.245.1206.2__",
            "deviceId": "00044f91234daf759492dbe6bd733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_189663d45612eed224b2be2f5ea3142729e63f16a.DomainPII_21eed80b086e79bdfa178eadfa25e8de6acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "onedrive",
            "softwareVersion": "20.245.1206.2",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_USERS\\S-1-5-21-2944539346-1310925172-2349113062-1001\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\OneDriveSetup.exe"
            ],
            "lastSeenTimestamp": "2020-12-30 13:18:33",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-onedrive",
            "securityUpdateAvailable": true
        },
        {
            "id": "00044f912345daf759462bde6db733b6a9c56ab4_windows_10_10.0.17763.1637__",
            "deviceId": "00044f912345daf756462dbe6db733d6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18663b45912eeb224d2be2f5ea3142729e63f16a.DomainPII_21eeb80d086e79bdfa178eadfa25e8de6acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "windows_10" "Windows_11",
            "softwareVersion": "10.0.17763.1637",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [],
            "lastSeenTimestamp": "2020-12-30 14:17:26",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-windows_10" "va-_-microsoft-_-windows_11",
            "securityUpdateAvailable": true
        }
    ],
    "@odata.nextLink": "https://api.securitycenter.microsoft.com/api/machines/SoftwareVulnerabilitiesByMachine?pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0xMS8xMTAxLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}

2. Eksportér vurdering af softwaresårbarheder (via filer)

2.1 Beskrivelse af API-metode

2.1.2 Begrænsninger

Hastighedsbegrænsninger for denne API er 5 kald pr. minut og 20 opkald pr. time.

2.2 Tilladelser

Tilladelsestype	Tilladelse	Vist navn for tilladelse
Program	Vulnerability.Read.All	'Læs oplysninger om sårbarheder i forbindelse med trussels- og sårbarhedsstyring'
Uddelegeret (arbejds- eller skolekonto)	Vulnerability.Read	'Læs oplysninger om sårbarheder i forbindelse med trussels- og sårbarhedsstyring'

2.3 URL-adresse

GET /api/machines/SoftwareVulnerabilitiesExport

2.4 Parametre

sasValidHours: Det antal timer, som URL-adresserne til download er gyldige for. Maksimum er 6 timer.

2.5 Egenskaber

Bemærk!

Filerne er GZIP-komprimerede & i JSON-format med flere streger.
URL-adresserne til download er gyldige i 1 time, medmindre parameteren sasValidHours bruges.
Hvis du vil have maksimal downloadhastighed for dine data, kan du sikre dig, at du downloader fra det samme Azure-område, som dine data er placeret i.
Hver post er 1 KB data. Du skal tage højde for dette, når du vælger den korrekte pageSize-parameter for dig.
Nogle ekstra kolonner kan blive returneret i svaret. Disse kolonner er midlertidige og kan blive fjernet, så brug kun de dokumenterede kolonner.

Egenskab (id)	Datatype	Beskrivelse	Eksempel på en returneret værdi
Eksportér filer	matrix[streng]	En liste over URL-adresser til hentning af filer, der indeholder det aktuelle snapshot af organisationen.	["https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1", "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2"]
GeneratedTime	String	Det tidspunkt, hvor eksporten blev genereret.	2021-05-20T08:00:00Z

2.6 Eksempler

2.6.1 Eksempel på anmodning

GET https://api-us.securitycenter.contoso.com/api/machines/SoftwareVulnerabilitiesExport

2.6.2 Svareksempel

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.ExportFilesResponse",
    "exportFiles": [
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/VaExport/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-bcc26c4f-e531-48db-9892-c93ac5d72d5c.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A35%3A13Z&se=2021-01-11T14%3A35%3A13Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/VaExport/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-bcc26c4f-e531-48db-9892-c93ac5d72d5c.c001.json.gz?sv=2019-12-12&st=2021-01-11T11%3A35%3A13Z&se=2021-01-11T14%3A35%3A13Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/VaExport/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-bcc26c4f-e531-48db-9892-c93ac5d72d5c.c002.json.gz?sv=2019-12-12&st=2021-01-11T11%3A35%3A13Z&se=2021-01-11T14%3A35%3A13Z&sr=b&sp=r&sig=..."
    ],
    "generatedTime": "2021-01-11T11:01:00Z"
}

3. Vurdering af sårbarheder i forbindelse med deltaeksport af software (JSON-svar)

Beskrivelse af API-metoden 3.1

Returnerer en tabel med en post for hver entydige kombination af DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion, CveId. API'en henter data i din organisation som Json-svar. Svaret er sideinddelt, så du kan bruge feltet @odata.nextLink fra svaret til at hente de næste resultater. I modsætning til vurderingen af sårbarheder i hele softwaren (JSON-svar), som bruges til at få et helt snapshot af vurderingen af softwaresårbarhederne for din organisation efter enhed, bruges deltaeksport-API-kaldet til svar til kun at hente de ændringer, der er sket mellem en valgt dato og den aktuelle dato (API-kaldet "delta"). I stedet for at få en fuld eksport med en stor mængde data hver gang, får du kun specifikke oplysninger om nye, faste og opdaterede sikkerhedsrisici. Delta export JSON-svar-API-kald kan også bruges til at beregne forskellige KPI'er, f.eks. "hvor mange sikkerhedsrisici blev løst?" eller "Hvor mange nye sikkerhedsrisici blev føjet til min organisation?"

Bemærk!

Det anbefales på det kraftigste, at du bruger vurderingen af sårbarheder i forbindelse med fuld eksport af software efter enheds-API-kald mindst én gang om ugen, og denne ekstra sikkerhedssvaghed ved eksport af software ændres efter enhedens (delta)API-kald til alle de andre dage i ugen. I modsætning til de andre JSON-svar-API'er til vurderinger er "deltaeksport" ikke en fuld eksport. Delta-eksporten indeholder kun de ændringer, der er foretaget mellem en valgt dato og dags dato (API-kaldet "delta").

3.1.1 Begrænsninger

Den maksimale sidestørrelse er 200.000.
Parameteren sinceTime har maksimalt 14 dage.
Hastighedsbegrænsninger for denne API er 30 kald pr. minut og 1.000 opkald pr. time.

3.2 Tilladelser

Tilladelsestype	Tilladelse	Vist navn for tilladelse
Program	Vulnerability.Read.All	'Læs oplysninger om sårbarheder i forbindelse med trussels- og sårbarhedsstyring'
Uddelegeret (arbejds- eller skolekonto)	Vulnerability.Read	'Læs oplysninger om sårbarheder i forbindelse med trussels- og sårbarhedsstyring'

3.3 URL-adresse

GET /api/machines/SoftwareVulnerabilityChangesByMachine

3.4 Parametre

sinceTime (påkrævet): Starttidspunktet, hvorfra du vil se dataændringer. Administration af sårbarheder genererer data om nye og opdaterede sikkerhedsrisici hver 6. time. De returnerede data inkluderer alle de ændringer, der registreres i 6-timers perioden, som den angivne sinceTime falder ind under, sammen med ændringerne i eventuelle efterfølgende 6-timers perioder op til og med de senest genererede data.
pageSize (standard = 50.000): antal resultater i svar.
$top: antallet af resultater, der skal returneres (returnerer @odata.nextLink ikke og trækker derfor ikke alle dataene).

3.5 Egenskaber

Hver returnerede post indeholder alle data fra vurderingen af sårbarheder i forbindelse med fuld eksport af software efter enheds-API samt yderligere to felter: EventTimestamp og Status.

Bemærk!

Nogle andre kolonner returneres muligvis i svaret. Disse kolonner er midlertidige og kan blive fjernet, så brug kun de dokumenterede kolonner.
De egenskaber, der er defineret i følgende tabel, vises alfabetisk efter egenskabs-id. Når du kører denne API, returneres det resulterende output ikke nødvendigvis i den samme rækkefølge, som er angivet i denne tabel.

Egenskab (id)	Datatype	Beskrivelse	Eksempel på returneret værdi
CveId	String	Entydigt id, der er tildelt sikkerhedssårbarheden under CVE-systemet (Common Vulnerabilities and Exposures).	CVE-2020-15992
CvssScore	Dobbelt	CVSS-scoren for CVE.	6.2
DeviceId	String	Entydigt id for enheden i tjenesten.	9eaf3a8b5962e0e6b1af9ec756664a9b823df2d1
DeviceName	String	Fuldt domænenavn (FQDN) for enheden.	johnlaptop.europe.contoso.com
DiskPaths	Matrix[streng]	Disk, der beviser, at produktet er installeret på enheden.	["C:\Programmer (x86)\Microsoft\Silverlight\Application\silverlight.exe"]
EventTimestamp	String	Det tidspunkt, hvor denne delta-hændelse blev fundet.	2021-01-11T11:06:08.291Z
Udnyttelsesniveau	String	Udnyttelsesniveauet for denne sårbarhed (NoExploit, ExploitIsPublic, ExploitIsVerified, ExploitIsInKit)	ExploitIsInKit
FirstSeenTimestamp	String	Første gang CVE for dette produkt blev set på enheden.	2020-11-03 10:13:34.8476880
ID	String	Entydigt id for posten.	123ABG55_573AG&mnp!
LastSeenTimestamp	String	Sidste gang CVE blev set på enheden.	2020-11-03 10:13:34.8476880
OSPlatform	String	Platform for det operativsystem, der kører på enheden; specifikke operativsystemer med variationer inden for samme familie, f.eks. Windows 10 og Windows 11. Se Admininstration af håndtering af sikkerhedsrisici til Microsoft Defender understøttede operativsystemer og platforme for at få flere oplysninger.	Windows10 og Windows 11
RbacGroupName	String	Den rollebaserede adgangskontrolgruppe (RBAC). Hvis denne enhed ikke er tildelt nogen RBAC-gruppe, er værdien "Ikke tildelt". Hvis organisationen ikke indeholder nogen RBAC-grupper, er værdien "Ingen".	Servere
Reference til anbefaling	streng	En reference til det anbefalings-id, der er relateret til denne software.	va--microsoft--silverlight
RecommendedSecurityUpdate	String	Navn på eller beskrivelse af den sikkerhedsopdatering, der leveres af softwareleverandøren til at løse problemet med sårbarheden.	Sikkerheds Opdateringer fra april 2020
RecommendedSecurityUpdateId	String	Identifikator for de relevante sikkerhedsopdateringer eller identifikator for de tilsvarende artikler om vejledning eller videnbase (KB)	4550961
RegistryPaths	Matrix[streng]	Registreringsdatabase beviser, at produktet er installeret på enheden.	["HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\Google Chrome"]
SoftwareName	String	Navnet på softwareproduktet.	Krom
SoftwareVendor	String	Navnet på softwareleverandøren.	Google
SoftwareVersion	String	Softwareproduktets versionsnummer.	81.0.4044.138
Status	String	Ny (for en ny sårbarhed, der introduceres på en enhed) (1) Fast (hvis denne sårbarhed ikke længere findes på enheden, hvilket betyder, at den blev afhjælpet). (2) Opdateret (hvis en sårbarhed på en enhed ændres. De mulige ændringer er: CVSS-score, udnyttelsesniveau, alvorsgradsniveau, DiskPaths, RegistryPaths, RecommendedSecurityUpdate).	Fast
VulnerabilitySeverityLevel	String	Alvorsgradsniveau, der er tildelt sikkerhedsrisikoen, og som er baseret på CVSS-scoren.	Middel

Præciseringer

Hvis softwaren blev opdateret fra version 1.0 til version 2.0, og begge versioner er eksponeret for CVE-A, modtager du to separate hændelser:
1. Løst: CVE-A på version 1.0 blev rettet.
2. Ny: CVE-A på version 2.0 blev tilføjet.
Hvis en bestemt sårbarhed (f.eks. CVE-A) først blev set på et bestemt tidspunkt (f.eks. 10. januar) på software med version 1.0, og et par dage senere blev softwaren opdateret til version 2.0, som også blev eksponeret for samme CVE-A, modtager du disse to adskilte hændelser:
1. Løst: CVE-X, FirstSeenTimestamp 10. januar, version 1.0.
2. Ny: CVE-X, FirstSeenTimestamp 10. januar, version 2.0.

3.6 Eksempler

3.6.1 Eksempel på anmodning

GET https://api.securitycenter.microsoft.com/api/machines/SoftwareVulnerabilityChangesByMachine?pageSize=5&sinceTime=2021-05-19T18%3A35%3A49.924Z

3.6.2 Svareksempel

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.DeltaAssetVulnerability)",
    "value": [
        {
            "id": "008198251234544f7dfa715e278d4cec0c16c171_chrome_87.0.4280.88__",
            "deviceId": "008198251234544f7dfa715e278b4cec0c19c171",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_1c8fee370690ca24b6a0d3f34d193b0424943a8b8.DomainPII_0dc1aee0fa366d175e514bd91a9e7a5b2b07ee8e.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.19042.685",
            "osArchitecture": "x64",
            "softwareVendor": "google",
            "softwareName": "chrome",
            "softwareVersion": "87.0.4280.88",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [
                "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"
            ],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Google Chrome"
            ],
            "lastSeenTimestamp": "2021-01-04 00:29:42",
            "firstSeenTimestamp": "2020-11-06 03:12:44",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-google-_-chrome",
            "status": "Fixed",
            "eventTimestamp": "2021-01-11T11:06:08.291Z"
        },
        {
            "id": "00e59c61234533860738ecf488eec8abf296e41e_onedrive_20.64.329.3__",
            "deviceId": "00e56c91234533860738ecf488eec8abf296e41e",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_82c13a8ad8cf3dbaf7bf34fada9fa3aebc124116.DomainPII_21eeb80d086e79dbfa178eadfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.18363.1256",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "onedrive",
            "softwareVersion": "20.64.329.3",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_USERS\\S-1-5-21-2127521184-1604012920-1887927527-24918864\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\OneDriveSetup.exe"
            ],
            "lastSeenTimestamp": "2020-12-11 19:49:48",
            "firstSeenTimestamp": "2020-12-07 18:25:47",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-onedrive",
            "status": "Fixed",
            "eventTimestamp": "2021-01-11T11:06:08.291Z"
        },
        {
            "id": "01aa8c73095bb12345918663f3f94ce322107d24_firefox_83.0.0.0_CVE-2020-26971_",
            "deviceId": "01aa8c73065bb12345918693f3f94ce322107d24",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_42684eb981bea2d670027e7ad2caafd3f2b381a3.DomainPII_21eed80b086e76dbfa178eabfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.19042.685",
            "osArchitecture": "x64",
            "softwareVendor": "mozilla",
            "softwareName": "firefox",
            "softwareVersion": "83.0.0.0",
            "cveId": "CVE-2020-26971",
            "vulnerabilitySeverityLevel": "High",
            "recommendedSecurityUpdate": "193220",
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [
                "C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe"
            ],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Mozilla Firefox 83.0 (x86 en-US)"
            ],
            "lastSeenTimestamp": "2021-01-05 17:04:30",
            "firstSeenTimestamp": "2020-05-06 12:42:19",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-mozilla-_-firefox",
            "status": "Fixed",
            "eventTimestamp": "2021-01-11T11:06:08.291Z"
        },
        {
            "id": "026f0fcb12345fbd2decd1a339702131422d362e_project_16.0.13701.20000__",
            "deviceId": "029f0fcb13245fbd2decd1a336702131422d392e",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_a5706750acba75f15d69cd17f4a7fcd268d6422c.DomainPII_f290e982685f7e8eee168b4332e0ae5d2a069cd6.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.19042.685",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "project",
            "softwareVersion": "16.0.13701.20000",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\ProjectProRetail - en-us"
            ],
            "lastSeenTimestamp": "2021-01-03 23:38:03",
            "firstSeenTimestamp": "2019-08-01 22:56:12",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-project",
            "status": "Fixed",
            "eventTimestamp": "2021-01-11T11:06:08.291Z"
        },
        {
            "id": "038df381234510b357ac19d0113ef622e4e212b3_chrome_81.0.4044.138_CVE-2020-16011_",
            "deviceId": "038df381234510d357ac19b0113ef922e4e212b3",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_365f5c0bb7202c163937dad3d017969b2d760eb4.DomainPII_29596a43a2ef2bbfa00f6a16c0cb1d108bc63e32.DomainPII_3c5fefd2e6fda2f36257359404f6c1092aa6d4b8.net",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.18363.1256",
            "osArchitecture": "x64",
            "softwareVendor": "google",
            "softwareName": "chrome",
            "softwareVersion": "81.0.4044.138",
            "cveId": "CVE-2020-16011",
            "vulnerabilitySeverityLevel": "High",
            "recommendedSecurityUpdate": "ADV 200002",
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [
                "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"
            ],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\{C4EBFDFD-0C55-3E5F-A919-E3C54949024A}"
            ],
            "lastSeenTimestamp": "2020-12-10 22:45:41",
            "firstSeenTimestamp": "2020-07-26 02:13:43",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-google-_-chrome",
            "status": "Fixed",
            "eventTimestamp": "2021-01-11T11:06:08.291Z"
        }
    ],
    "@odata.nextLink": "https://wpatdadi-eus-stg.cloudapp.net/api/machines/SoftwareVulnerabilitiesTimeline?sincetime=2021-01-11&pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0xMS8xMTAxLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}

Se også

Andre relaterede

Tip

Vil du vide mere? Engage med Microsoft Security-community'et i vores tech-community: Microsoft Defender for Endpoint Tech Community.

Del via

Eksportér vurdering af softwaresårbarheder pr. enhed

1. Eksportér vurdering af softwaresårbarheder (JSON-svar)

Beskrivelse af API-metoden 1.1

1.1.1 Begrænsninger

1.2 Tilladelser

1.3 URL-adresse

1.4 Parametre

1.5 Egenskaber

1.6 Eksempler

1.6.1 Eksempel på anmodning

1.6.2 Svareksempel

2. Eksportér vurdering af softwaresårbarheder (via filer)

2.1 Beskrivelse af API-metode

2.1.2 Begrænsninger

2.2 Tilladelser

2.3 URL-adresse

2.4 Parametre

2.5 Egenskaber

2.6 Eksempler

2.6.1 Eksempel på anmodning

2.6.2 Svareksempel

3. Vurdering af sårbarheder i forbindelse med deltaeksport af software (JSON-svar)

Beskrivelse af API-metoden 3.1

3.1.1 Begrænsninger

3.2 Tilladelser

3.3 URL-adresse

3.4 Parametre

3.5 Egenskaber

Præciseringer

3.6 Eksempler

3.6.1 Eksempel på anmodning

3.6.2 Svareksempel

Se også

Feedback

Yderligere ressourcer