Evaluatiemethoden en -eigenschappen per apparaat exporteren
Van toepassing op:
- Plan 1 voor Microsoft Defender voor Eindpunt
- Plan 2 voor Microsoft Defender voor Eindpunt
- Microsoft Defender Vulnerability Management
- Microsoft Defender XDR
Wilt u Microsoft Defender voor Eindpunt ervaren? Meld u aan voor een gratis proefversie.
API-beschrijving
Biedt methoden en eigenschapsdetails over de API's die beveiligingsbeheergegevens per apparaat ophalen. Er zijn verschillende API-aanroepen om verschillende typen gegevens op te halen. Over het algemeen bevat elke API-aanroep de vereiste gegevens voor apparaten in uw organisatie.
Opmerking
Tenzij anders aangegeven, zijn alle vermelde exportevaluatiemethoden volledige export en per apparaat (ook wel per apparaat genoemd).
U kunt de exportevaluatie-API's gebruiken om verschillende typen informatie op te halen (exporteren):
- 1. Evaluatie van veilige configuraties exporteren
- 2. Evaluatie van software-inventaris exporteren
- 3. Evaluatie van beveiligingsproblemen in software exporteren
- 4. Software-inventarisatie van niet-productcode exporteren
De API's die overeenkomen met de exportinformatietypen worden beschreven in secties 1, 2 en 3.
Elke methode heeft verschillende API-aanroepen om verschillende typen gegevens op te halen. Omdat de hoeveelheid gegevens groot kan zijn, zijn er twee manieren waarop deze kunnen worden opgehaald:
JSON-antwoord De API haalt alle gegevens in uw organisatie op als JSON-antwoorden. Deze methode is het beste voor kleine organisaties met minder dan 100 K-apparaten. Het antwoord is gepagineerd, zodat u het veld @odata.nextLink uit het antwoord kunt gebruiken om de volgende resultaten op te halen.
via bestanden Met deze API-oplossing kunt u grotere hoeveelheden gegevens sneller en betrouwbaarder ophalen. Het wordt daarom aanbevolen voor grote organisaties, met meer dan 100 K-apparaten. Deze API haalt alle gegevens in uw organisatie op als downloadbestanden. Het antwoord bevat URL's voor het downloaden van alle gegevens uit Azure Storage. Met deze API kunt u als volgt al uw gegevens downloaden uit Azure Storage:
- Roep de API aan om een lijst met download-URL's met alle gegevens van uw organisatie op te halen.
- Download alle bestanden met behulp van de download-URL's en verwerk de gegevens zoals u wilt.
Gegevens die worden verzameld met behulp van 'JSON-antwoord of via bestanden' zijn de huidige momentopname van de huidige status. Deze bevat geen historische gegevens. Om historische gegevens te verzamelen, moeten klanten de gegevens opslaan in hun eigen gegevensopslag.
1. Evaluatie van veilige configuraties exporteren
Retourneert alle configuraties en hun status, per apparaat.
1.1 Methoden
| Methode | Gegevenstype: | Beschrijving |
|---|---|---|
| Beveiligde configuratie per apparaatverzameling. Zie: 1.2 Eigenschappen (JSON-antwoord) | Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, ConfigurationId. De API haalt alle gegevens in uw organisatie op als JSON-antwoorden. Deze methode is het beste voor kleine organisaties met minder dan 100 K-apparaten. Het antwoord is gepagineerd, zodat u het @odata.nextLink veld uit het antwoord kunt gebruiken om de volgende resultaten op te halen. | |
| Beveiligde configuratie per apparaatverzameling. Zie: 1.3 Eigenschappen (via bestanden) | Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, ConfigurationId. Met deze API-oplossing kunt u grotere hoeveelheden gegevens sneller en betrouwbaarder ophalen. Het wordt daarom aanbevolen voor grote organisaties, met meer dan 100 K-apparaten. Deze API haalt alle gegevens in uw organisatie op als downloadbestanden. Het antwoord bevat URL's voor het downloaden van alle gegevens uit Azure Storage. Met deze API kunt u als volgt al uw gegevens downloaden uit Azure Storage:
|
1.2 Eigenschappen (JSON-antwoord)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| configurationCategory | Tekenreeks | Categorie of groep waartoe de configuratie behoort: Toepassing, besturingssysteem, netwerk, accounts, beveiligingsbesturingselementen. |
| configurationId | Tekenreeks | Unieke id voor een specifieke configuratie. |
| configurationImpact | Tekenreeks | Beoordeeld effect van de configuratie op de algehele configuratiescore (1-10). |
| configurationName | Tekenreeks | Weergavenaam van de configuratie. |
| configurationSubcategory | Tekenreeks | Subcategorie of subgroep waartoe de configuratie behoort. In veel gevallen specifieke mogelijkheden of functies. |
| deviceId | Tekenreeks | Unieke id voor het apparaat in de service. |
| deviceName | Tekenreeks | Fully Qualified Domain Name (FQDN) van het apparaat. |
| isApplicable | Bool | Geeft aan of de configuratie of het beleid van toepassing is. |
| isCompliant | Bool | Geeft aan of de configuratie of het beleid juist is geconfigureerd. |
| isExpectedUserImpact | Bool | Geeft aan of de gebruiker wordt beïnvloed als de configuratie wordt toegepast. |
| osPlatform | Tekenreeks | Platform van het besturingssysteem dat op het apparaat wordt uitgevoerd. Specifieke besturingssystemen met variaties binnen dezelfde familie, zoals Windows 10 en Windows 11. Zie Ondersteunde besturingssystemen, platforms en mogelijkheden voor meer informatie. |
| osVersion | Tekenreeks | Specifieke versie van het besturingssysteem dat op het apparaat wordt uitgevoerd. |
| rbacGroupName | Tekenreeks | De RBAC-groep (op rollen gebaseerd toegangsbeheer). Als het apparaat niet is toegewezen aan een RBAC-groep, is de waarde 'Niet toegewezen'. Als de organisatie geen RBAC-groepen bevat, is de waarde 'Geen'. |
| rbacGroupId | Tekenreeks | De RBAC-groeps-id (op rollen gebaseerd toegangsbeheer). |
| recommendationReference | Tekenreeks | Een verwijzing naar de aanbevelings-id met betrekking tot de software. |
| Tijdstempel | Tekenreeks | De laatste keer dat de configuratie is gezien op het apparaat. |
1.3 Eigenschappen (via bestanden)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| Bestanden exporteren | matrix[tekenreeks] | Een lijst met download-URL's voor bestanden met de huidige momentopname van de organisatie. |
| GeneratedTime | Tekenreeks | Het tijdstip waarop de export is gegenereerd. |
2. Evaluatie van software-inventaris exporteren
Retourneert alle geïnstalleerde software en de bijbehorende details op elk apparaat.
2.1 Methoden
| Methode | Gegevenstype: | Beschrijving |
|---|---|---|
| Evaluatie van software-inventaris exporteren (JSON-antwoord) | Software-inventarisatie per apparaatverzameling. Zie: 2.2 Eigenschappen (JSON-antwoord) | Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion. De API haalt alle gegevens in uw organisatie op als JSON-antwoorden. Deze methode is het beste voor kleine organisaties met minder dan 100 K-apparaten. Het antwoord is gepagineerd, zodat u het @odata.nextLink veld uit het antwoord kunt gebruiken om de volgende resultaten op te halen. |
| Evaluatie van software-inventaris exporteren (via bestanden) | Software-inventarisatie op apparaatbestanden. Zie: 2.3 Eigenschappen (via bestanden) | Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion. Met deze API-oplossing kunt u grotere hoeveelheden gegevens sneller en betrouwbaarder ophalen. Het wordt daarom aanbevolen voor grote organisaties, met meer dan 100 K-apparaten. Deze API haalt alle gegevens in uw organisatie op als downloadbestanden. Het antwoord bevat URL's voor het downloaden van alle gegevens uit Azure Storage. Met deze API kunt u als volgt gegevens downloaden uit Azure Storage:
|
2.2 Eigenschappen (JSON-antwoord)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| DeviceId | Tekenreeks | Unieke id voor het apparaat in de service. |
| DeviceName | Tekenreeks | Fully Qualified Domain Name (FQDN) van het apparaat. |
| DiskPaths | Matrix[tekenreeks] | Bewijs dat het product op het apparaat is geïnstalleerd. |
| EndOfSupportDate | Tekenreeks | De datum waarop de ondersteuning voor deze software is of zal eindigen. |
| EndOfSupportStatus | Tekenreeks | Einde van de ondersteuningsstatus. Kan deze mogelijke waarden bevatten: Geen, EOS-versie, Toekomstige EOS-versie, EOS-software, toekomstige EOS-software. |
| NumberOfWeaknesses | Int | Aantal zwakke punten van deze software op dit apparaat. |
| OSPlatform | Tekenreeks | Platform van het besturingssysteem dat op het apparaat wordt uitgevoerd; specifieke besturingssystemen met variaties binnen dezelfde familie, zoals Windows 10 en Windows 11. Zie Ondersteunde besturingssystemen, platforms en mogelijkheden voor meer informatie. |
| RbacGroupName | Tekenreeks | De RBAC-groep (op rollen gebaseerd toegangsbeheer). Als dit apparaat niet is toegewezen aan een RBAC-groep, is de waarde 'Niet toegewezen'. Als de organisatie geen RBAC-groepen bevat, is de waarde 'Geen'. |
| rbacGroupId | Tekenreeks | De RBAC-groeps-id (op rollen gebaseerd toegangsbeheer). |
| RegistryPaths | Matrix[tekenreeks] | Registerbewijs dat het product in het apparaat is geïnstalleerd. |
| SoftwareFirstSeenTimestamp | Tekenreeks | De eerste keer dat deze software op het apparaat werd gezien. |
| SoftwareName | Tekenreeks | Naam van het softwareproduct. |
| SoftwareVendor | Tekenreeks | Naam van de softwareleverancier. |
| SoftwareVersion | Tekenreeks | Versienummer van het softwareproduct. |
2.3 Eigenschappen (via bestanden)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| Bestanden exporteren | matrix[tekenreeks] | Een lijst met download-URL's voor bestanden met de huidige momentopname van de organisatie. |
| GeneratedTime | Tekenreeks | Het tijdstip waarop de export is gegenereerd. |
3. Evaluatie van beveiligingsproblemen in software exporteren
Retourneert alle bekende beveiligingsproblemen op een apparaat en de bijbehorende details, voor alle apparaten.
3.1 Methoden
| Methode | Gegevenstype: | Beschrijving |
|---|---|---|
| Onderzoeksverzameling Zie: 3.2 Eigenschappen (JSON-antwoord) | Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion, CveId. De API haalt alle gegevens in uw organisatie op als JSON-antwoorden. Deze methode is het beste voor kleine organisaties met minder dan 100 K-apparaten. Het antwoord is gepagineerd, zodat u het @odata.nextLink veld uit het antwoord kunt gebruiken om de volgende resultaten op te halen. | |
| Onderzoeksentiteit Zie: 3.3 Eigenschappen (via bestanden) | Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion, CveId. Met deze API-oplossing kunt u grotere hoeveelheden gegevens sneller en betrouwbaarder ophalen. Het wordt daarom aanbevolen voor grote organisaties, met meer dan 100 K-apparaten. Deze API haalt alle gegevens in uw organisatie op als downloadbestanden. Het antwoord bevat URL's voor het downloaden van alle gegevens uit Azure Storage. Met deze API kunt u als volgt al uw gegevens downloaden uit Azure Storage:
|
|
| Onderzoeksverzameling Zie: 3.4 Properties Delta export (JSON-antwoord) | Retourneert een tabel met een vermelding voor elke unieke combinatie van: DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion, CveId en EventTimestamp. De API haalt gegevens op in uw organisatie als JSON-antwoorden. Het antwoord is gepagineerd, zodat u het @odata.nextLink veld uit het antwoord kunt gebruiken om de volgende resultaten op te halen. De volledige evaluatie van softwareproblemen (JSON-antwoord) wordt gebruikt om per apparaat een volledige momentopname te verkrijgen van de evaluatie van softwareproblemen van uw organisatie. De delta export-API-aanroep wordt echter gebruikt om alleen de wijzigingen op te halen die zijn opgetreden tussen een geselecteerde datum en de huidige datum (de 'delta'-API-aanroep). In plaats van elke keer een volledige export met een grote hoeveelheid gegevens te krijgen, krijgt u alleen specifieke informatie over nieuwe, opgeloste en bijgewerkte beveiligingsproblemen. Delta export-API-aanroep kan ook worden gebruikt om verschillende KPI's te berekenen, zoals 'hoeveel beveiligingsproblemen zijn opgelost?' of 'hoeveel nieuwe beveiligingsproblemen zijn toegevoegd aan mijn organisatie?' Omdat de Delta export-API-aanroep voor softwareproblemen alleen gegevens retourneert voor een doeldatumbereik, wordt dit niet beschouwd als een volledige export. |
3.2 Eigenschappen (JSON-antwoord)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| CveId | Tekenreeks | Unieke id die is toegewezen aan het beveiligingsprobleem onder het CVE-systeem (Common Vulnerabilities and Exposures). |
| CvssScore | Tekenreeks | De CVSS-score van de CVE. |
| DeviceId | Tekenreeks | Unieke id voor het apparaat in de service. |
| DeviceName | Tekenreeks | Fully Qualified Domain Name (FQDN) van het apparaat. |
| DiskPaths | Matrix[tekenreeks] | Bewijs dat het product op het apparaat is geïnstalleerd. |
| ExploitabilityLevel | Tekenreeks | Het niveau van misbruik van dit beveiligingsprobleem (NoExploit, ExploitIsPublic, ExploitIsVerified, ExploitIsInKit) |
| FirstSeenTimestamp | Tekenreeks | De eerste keer dat de CVE van dit product is gezien op het apparaat. |
| ID | Tekenreeks | Unieke id voor de record. |
| LastSeenTimestamp | Tekenreeks | De laatste keer dat de CVE is gezien op het apparaat. |
| OSPlatform | Tekenreeks | Platform van het besturingssysteem dat op het apparaat wordt uitgevoerd; specifieke besturingssystemen met variaties binnen dezelfde familie, zoals Windows 10 en Windows 11. Zie Ondersteunde besturingssystemen, platforms en mogelijkheden voor meer informatie. |
| RbacGroupName | Tekenreeks | De RBAC-groep (op rollen gebaseerd toegangsbeheer). Als dit apparaat niet is toegewezen aan een RBAC-groep, is de waarde 'Niet toegewezen'. Als de organisatie geen RBAC-groepen bevat, is de waarde 'Geen'. |
| rbacGroupId | Tekenreeks | De RBAC-groeps-id (op rollen gebaseerd toegangsbeheer). |
| RecommendationReference | Tekenreeks | Een verwijzing naar de aanbevelings-id met betrekking tot deze software. |
| RecommendedSecurityUpdate | Tekenreeks | Naam of beschrijving van de beveiligingsupdate die is verstrekt door de softwareleverancier om het beveiligingsprobleem op te lossen. |
| RecommendedSecurityUpdateId | Tekenreeks | Id van de toepasselijke beveiligingsupdates of id voor de bijbehorende artikelen met richtlijnen of Knowledge Base (KB). |
| Registerpaden | Matrix[tekenreeks] | Registerbewijs dat het product in het apparaat is geïnstalleerd. |
| SecurityUpdateAvailable | Booleaanse waarde | Geeft aan of er een beveiligingsupdate beschikbaar is voor de software. |
| SoftwareName | Tekenreeks | Naam van het softwareproduct. |
| SoftwareVendor | Tekenreeks | Naam van de softwareleverancier. |
| SoftwareVersion | Tekenreeks | Versienummer van het softwareproduct. |
| VulnerabilitySeverityLevel | Tekenreeks | Ernstniveau dat is toegewezen aan het beveiligingsprobleem op basis van de CVSS-score. |
3.3 Eigenschappen (via bestanden)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| Bestanden exporteren | matrix[tekenreeks] | Een lijst met download-URL's voor bestanden met de huidige momentopname van de organisatie. |
| GeneratedTime | Tekenreeks | Het tijdstip waarop de export is gegenereerd. |
3.4 Eigenschappen (delta export JSON-antwoord)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| CveId | Tekenreeks | Unieke id die is toegewezen aan het beveiligingsprobleem onder het CVE-systeem (Common Vulnerabilities and Exposures). |
| CvssScore | Tekenreeks | De CVSS-score van de CVE. |
| DeviceId | Tekenreeks | Unieke id voor het apparaat in de service. |
| DeviceName | Tekenreeks | Fully Qualified Domain Name (FQDN) van het apparaat. |
| DiskPaths | Matrix[tekenreeks] | Bewijs dat het product op het apparaat is geïnstalleerd. |
| EventTimestamp | Tekenreeks | Het tijdstip waarop de deltagebeurtenis is gevonden. |
| ExploitabilityLevel | Tekenreeks | Het niveau van misbruik van het beveiligingsprobleem (NoExploit, ExploitIsPublic, ExploitIsVerified, ExploitIsInKit) |
| FirstSeenTimestamp | Tekenreeks | De eerste keer dat de CVE van het product is gezien op het apparaat. |
| ID | Tekenreeks | Unieke id voor de record. |
| LastSeenTimestamp | Tekenreeks | De laatste keer dat de CVE is gezien op het apparaat. |
| OSPlatform | Tekenreeks | Platform van het besturingssysteem dat op het apparaat wordt uitgevoerd; specifieke besturingssystemen met variaties binnen dezelfde familie, zoals Windows 10 en Windows 11. Zie Ondersteunde besturingssystemen, platforms en mogelijkheden voor meer informatie. |
| RbacGroupName | Tekenreeks | De RBAC-groep (op rollen gebaseerd toegangsbeheer). Als dit apparaat niet is toegewezen aan een RBAC-groep, is de waarde 'Niet toegewezen'. Als de organisatie geen RBAC-groepen bevat, is de waarde 'Geen'. |
| RecommendationReference | Tekenreeks | Een verwijzing naar de aanbevelings-id met betrekking tot deze software. |
| RecommendedSecurityUpdate | Tekenreeks | Naam of beschrijving van de beveiligingsupdate die is verstrekt door de softwareleverancier om het beveiligingsprobleem op te lossen. |
| RecommendedSecurityUpdateId | Tekenreeks | Id van de toepasselijke beveiligingsupdates of id voor de bijbehorende richtlijnen of kb-artikelen (Knowledge Base) |
| RegistryPaths | Matrix[tekenreeks] | Registerbewijs dat het product in het apparaat is geïnstalleerd. |
| SoftwareName | Tekenreeks | Naam van het softwareproduct. |
| SoftwareVendor | Tekenreeks | Naam van de softwareleverancier. |
| SoftwareVersion | Tekenreeks | Versienummer van het softwareproduct. |
| Status | Tekenreeks | Nieuw (voor een nieuw beveiligingsprobleem dat is geïntroduceerd op een apparaat). Opgelost (voor een beveiligingsprobleem dat niet meer op het apparaat bestaat, wat betekent dat het is hersteld). Bijgewerkt (voor een beveiligingsprobleem op een apparaat dat is gewijzigd. De mogelijke wijzigingen zijn: CVSS-score, misbruikniveau, ernstniveau, DiskPaths, RegistryPaths, RecommendedSecurityUpdate). |
| VulnerabilitySeverityLevel | Tekenreeks | Ernstniveau toegewezen aan het beveiligingsprobleem op basis van de CVSS-score. |
4. Software-inventarisatie van niet-productcode exporteren
Retourneert alle geïnstalleerde software die geen Common Platform Enumeration (CPE) heeft en de bijbehorende details op elk apparaat.
4.1 Methoden
| Methode | Gegevenstype: | Beschrijving |
|---|---|---|
| Evaluatie van software-inventaris van niet-productcode exporteren (JSON-antwoord) | Software-inventaris van niet-productcode per apparaatverzameling. Zie: 4.2 Eigenschappen (JSON-antwoord) | Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion. De API haalt alle gegevens in uw organisatie op als JSON-antwoorden. Deze methode is het beste voor kleine organisaties met minder dan 100 K-apparaten. Het antwoord is gepagineerd, zodat u het @odata.nextLink veld uit het antwoord kunt gebruiken om de volgende resultaten op te halen. |
| Evaluatie van software-inventarisatie van niet-productcode exporteren (via bestanden) | Software-inventaris van niet-productcode op apparaatbestanden. Zie: 4.3 Eigenschappen (via bestanden) | Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion. Met deze API-oplossing kunt u grotere hoeveelheden gegevens sneller en betrouwbaarder ophalen. Het wordt daarom aanbevolen voor grote organisaties, met meer dan 100 K-apparaten. Deze API haalt alle gegevens in uw organisatie op als downloadbestanden. Het antwoord bevat URL's voor het downloaden van alle gegevens uit Azure Storage. Met deze API kunt u als volgt gegevens downloaden uit Azure Storage:
|
4.2 Eigenschappen (JSON-antwoord)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| DeviceId | tekenreeks | Unieke id voor het apparaat in de service. |
| DeviceName | tekenreeks | Fully Qualified Domain Name (FQDN) van het apparaat. |
| OSPlatform | tekenreeks | Platform van het besturingssysteem dat op het apparaat wordt uitgevoerd. Dit zijn specifieke besturingssystemen met variaties binnen dezelfde familie, zoals Windows 10 en Windows 11. Zie Ondersteunde besturingssystemen, platforms en mogelijkheden voor meer informatie. |
| RbacGroupName | tekenreeks | De RBAC-groep (op rollen gebaseerd toegangsbeheer). Als dit apparaat niet is toegewezen aan een RBAC-groep, is de waarde 'Niet toegewezen'. Als de organisatie geen RBAC-groepen bevat, is de waarde 'Geen'. |
| RbacGroupId | tekenreeks | De RBAC-groeps-id (op rollen gebaseerd toegangsbeheer). |
| SoftwareLastSeenTimestamp | tekenreeks | De laatste keer dat deze software op het apparaat is gezien. |
| SoftwareName | tekenreeks | Naam van het softwareproduct. |
| SoftwareVendor | tekenreeks | Naam van de softwareleverancier. |
| SoftwareVersion | tekenreeks | Versienummer van het softwareproduct. |
4.3 Eigenschappen (via bestanden)
| Eigenschap (id) | Gegevenstype: | Beschrijving |
|---|---|---|
| Bestanden exporteren | matrix[tekenreeks] | Een lijst met download-URL's voor bestanden met de huidige momentopname van de organisatie. |
| GeneratedTime | Tekenreeks | Het tijdstip waarop de export is gegenereerd. |
Zie ook
- Veilige configuratie-evaluatie per apparaat exporteren
- Evaluatie van software-inventaris per apparaat exporteren
- Evaluatie van beveiligingsproblemen met software per apparaat exporteren
- Evaluatie van niet-cpe-software-inventaris per apparaat exporteren
Overige gerelateerde
Tip
Wil je meer weten? Engage met de Microsoft Security-community in onze Tech Community: Microsoft Defender voor Eindpunt Tech Community.