Evaluatie van browserextensies exporteren per apparaat

Artikel
04/26/2024

Van toepassing op:

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

Wilt u Microsoft Defender Vulnerability Management ervaren? Meer informatie over hoe u zich kunt registreren voor de openbare proefversie van Microsoft Defender Vulnerability Management.

Retourneert alle bekende geïnstalleerde browserextensies en de bijbehorende details voor alle apparaten, per apparaat.

Met verschillende API-aanroepen worden verschillende typen gegevens opgehaald. Omdat de hoeveelheid gegevens groot kan zijn, zijn er twee manieren waarop deze kunnen worden opgehaald:

JSON-antwoord voor evaluatie van browserextensies exporteren 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.
Evaluatie van browserextensies exporteren 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 een 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.

Opmerking

Tenzij anders aangegeven, zijn alle vermelde exportevaluatiemethoden volledige export en per apparaat (ook wel per apparaat genoemd).

1. Evaluatie van browserextensies exporteren (JSON-antwoord)

Beschrijving van API-methode 1.1

Dit API-antwoord bevat alle gegevens voor geïnstalleerde browserextensies per apparaat. Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, BrowserName, ExtensionId.

1.1.1 Beperkingen

Het maximale paginaformaat is 200.000.
Frequentiebeperkingen voor deze API zijn 30 aanroepen per minuut en 1000 aanroepen per uur.

1.2 Machtigingen

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

Machtigingstype	Machtiging	Weergavenaam van machtiging
Toepassing	Software.Read.All	'Informatie over software voor bedreigings- en beveiligingsproblemenbeheer lezen'
Gedelegeerd (werk- of schoolaccount)	Software.Read	'Informatie over software voor bedreigings- en beveiligingsproblemenbeheer lezen'

1.3 URL

GET /api/Machines/BrowserExtensionsInventoryByMachine

1.4 Parameters

pageSize (standaard = 50.000): aantal resultaten in antwoord.
$top: aantal resultaten dat moet worden geretourneerd (retourneert niet @odata.nextLink en haalt daarom niet alle gegevens op)

1.5 Eigenschappen

Opmerking

Elke record bevat ongeveer 0,5 KB aan gegevens. U moet hiermee rekening houden bij het kiezen van de juiste parameter pageSize voor u.
De eigenschappen die in de volgende tabel zijn gedefinieerd, worden alfabetisch weergegeven, op eigenschaps-id. Wanneer u deze API uitvoert, wordt de resulterende uitvoer niet noodzakelijkerwijs geretourneerd in dezelfde volgorde die in deze tabel wordt vermeld.
Er kunnen enkele extra kolommen worden geretourneerd in het antwoord. Deze kolommen zijn tijdelijk en kunnen worden verwijderd. Gebruik alleen de gedocumenteerde kolommen.

Eigenschap (id)	Gegevenstype:	Beschrijving
BrowserName	tekenreeks	Naam van de browser waarop de extensie is geïnstalleerd.
DeviceId	tekenreeks	Unieke id voor het apparaat.
DeviceName	tekenreeks	Fully Qualified Domain Name (FQDN) van het apparaat.
ExtensionDescription	tekenreeks	Beschrijving van een specifieke browserextensie.
ExtensionId	tekenreeks	Unieke id voor een specifieke browserextensie.
ExtensionName	tekenreeks	Naam van een specifieke browserextensie.
ExtensionRisk	tekenreeks	Het hoogste risiconiveau dat wordt gegenereerd door de browserextensie. Mogelijke waarden zijn: 'Geen', 'Laag', 'Gemiddeld', 'Hoog', 'Kritiek'.
ExtensionVersion	tekenreeks	Versienummer van een specifieke browserextensie.
IsActivated	Booleaanse waarde	Geeft aan of een browserextensie actief is.
RbacGroupId	Geheel getal	De RBAC-groeps-id (op rollen gebaseerd toegangsbeheer).
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'.
InstallationTime	tekenreeks	Het tijdstip waarop de browserextensie is geïnstalleerd.
Machtigingen	Matrix[tekenreeks]	De set machtigingen die zijn aangevraagd door een specifieke browserextensie.

1.6 Voorbeelden

1.6.1 Voorbeeld van aanvraag

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

1.6.2 Voorbeeld van antwoord

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(contoso.windowsDefenderATP.api.AssetSoftware)",
    "value": [
        {
            "DeviceId": "1c32162b42e9efa1f5de42f951775f22f435c997",
            "DeviceName": "computerpii_1363c2e016e2225cb03974df58f14e6968067aa8.domainpii_f260e982985f7e8eee198b4332e0ae5b2a069cd6.corp.microsoft.com",
            "RbacGroupId": 86,
            "RbacGroupName": "UnassignedGroup",
            "InstallationTime": "2022-05-26T18:46:27.000Z",
            "BrowserName": "chrome",
            "ExtensionId": "dkpejdfnpdkhifgbancbammdijojoffk",
            "ExtensionName": "Logitech Smooth Scrolling",
            "ExtensionDescription": "Buttery-smooth scrolling for Logitech mice and touchpads.",
            "ExtensionVersion": "6.65.62",
            "ExtensionRisk": "High",
            "IsActivated": true,
            "Permissions": [
                        {
                                    "Id": "tabs",
                                    "IsRequired": true,
                                    "Risk": "High"
                        },
                        {
                                    "Id": http://*/*,
                                    "IsRequired": true,
                                    "Risk": "High"
                        },
                        {
                                    "Id": https://*/*,
                                    "IsRequired": true,
                                    "Risk": "High"
                        }
            ]
}
    ],
    "@odata.nextLink": "https://api.securitycenter.microsoft.com/api/Machines/BrowserExtensionsInventoryByMachine?pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0yNS8wMjAwLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}

2. Evaluatie van browserextensie exporteren (via bestanden)

Beschrijving van API-methode 2.1

Dit API-antwoord bevat alle gegevens voor geïnstalleerde browserextensies per apparaat. Retourneert een tabel met een vermelding voor elke unieke combinatie van DeviceId, BrowserName, ExtensionId.

2.1.1 Beperkingen

Tariefbeperkingen voor deze API zijn 5 aanroepen per minuut en 20 aanroepen per uur.

2.2 Machtigingen

Machtigingstype	Machtiging	Weergavenaam van machtiging
Toepassing	Software.Read.All	'Informatie over software voor bedreigings- en beveiligingsproblemenbeheer lezen'
Gedelegeerd (werk- of schoolaccount)	Software.Read	'Informatie over software voor bedreigings- en beveiligingsproblemenbeheer lezen'

2.3 URL

GET /api/machines/browserextensionsinventoryExport

2.4 Parameters

sasValidHours: het aantal uren dat de download-URL's geldig zijn (maximaal 24 uur)

2.5 Eigenschappen

Opmerking

De bestanden zijn gzip gecomprimeerd & in JSON-indeling met meerdere regels.
De download-URL's zijn slechts 3 uur geldig. Anders kunt u de parameter gebruiken.
Voor een maximale downloadsnelheid van uw gegevens kunt u ervoor zorgen dat u downloadt vanuit dezelfde Azure-regio waarin uw gegevens zich bevinden.

Eigenschap (id)	Gegevenstype:	Beschrijving	Voorbeeld van een geretourneerde waarde
Bestanden exporteren	matrix[tekenreeks]	Een lijst met download-URL's voor bestanden met de huidige momentopname van de organisatie	"[Https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1", "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2"]
GeneratedTime	tekenreeks	Het tijdstip waarop de export is gegenereerd.	2021-05-20T08:00:00Z

2.6 Voorbeelden

2.6.1 Voorbeeld van aanvraag

GET https://api.securitycenter.microsoft.com/api/machines/browserextensionsinventoryExport

2.6.2 Voorbeeld van antwoord

{
    "@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/BrowserExtensions/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/BrowserExtensions/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/BrowserExtensions/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c001.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=..."
    ],
    "generatedTime": "2021-01-11T11:01:00Z"
}

Zie ook

Tip

Wil je meer weten? Engage met de Microsoft Security-community in onze Tech Community: Microsoft Defender voor Eindpunt Tech Community.

Delen via

Evaluatie van browserextensies exporteren per apparaat

1. Evaluatie van browserextensies exporteren (JSON-antwoord)

Beschrijving van API-methode 1.1

1.1.1 Beperkingen

1.2 Machtigingen

1.3 URL

1.4 Parameters

1.5 Eigenschappen

1.6 Voorbeelden

1.6.1 Voorbeeld van aanvraag

1.6.2 Voorbeeld van antwoord

2. Evaluatie van browserextensie exporteren (via bestanden)

Beschrijving van API-methode 2.1

2.1.1 Beperkingen

2.2 Machtigingen

2.3 URL

2.4 Parameters

2.5 Eigenschappen

2.6 Voorbeelden

2.6.1 Voorbeeld van aanvraag

2.6.2 Voorbeeld van antwoord

Zie ook

Feedback

Aanvullende resources

Delen via

Evaluatie van browserextensies exporteren per apparaat

1. Evaluatie van browserextensies exporteren (JSON-antwoord)

Beschrijving van API-methode 1.1

1.1.1 Beperkingen

1.2 Machtigingen

1.3 URL

1.4 Parameters

1.5 Eigenschappen

1.6 Voorbeelden

1.6.1 Voorbeeld van aanvraag

1.6.2 Voorbeeld van antwoord

2. Evaluatie van browserextensie exporteren (via bestanden)

Beschrijving van API-methode 2.1

2.1.1 Beperkingen

2.2 Machtigingen

2.3 URL

2.4 Parameters

2.5 Eigenschappen

2.6 Voorbeelden

2.6.1 Voorbeeld van aanvraag

2.6.2 Voorbeeld van antwoord

Zie ook

Overige gerelateerde

Feedback

Aanvullende resources