Eksportowanie oceny rozszerzeń przeglądarki na urządzenie

Artykuł
04/26/2024

Dotyczy:

Chcesz poznać usługę ochrony punktu końcowego w usłudze Microsoft Defender? Utwórz konto bezpłatnej wersji próbnej.

Chcesz doświadczyć Zarządzanie lukami w zabezpieczeniach w usłudze Microsoft Defender? Dowiedz się więcej o tym, jak można zarejestrować się w Zarządzanie lukami w zabezpieczeniach w usłudze Microsoft Defender publicznej wersji zapoznawczej.

Zwraca wszystkie znane zainstalowane rozszerzenia przeglądarki i ich szczegóły dotyczące wszystkich urządzeń na poszczególnych urządzeniach.

Różne wywołania interfejsu API pobierają różne typy danych. Ponieważ ilość danych może być duża, można pobrać je na dwa sposoby:

Eksportowanie odpowiedzi JSON oceny rozszerzeń przeglądarki Interfejs API ściąga wszystkie dane w organizacji jako odpowiedzi JSON. Ta metoda jest najlepsza w przypadku małych organizacji z urządzeniami o rozmiarze mniejszym niż 100 K. Odpowiedź jest podzielona na strony, więc możesz użyć pola @odata.nextLink z odpowiedzi, aby pobrać następne wyniki.
Eksportowanie oceny rozszerzeń przeglądarki za pośrednictwem plików To rozwiązanie interfejsu API umożliwia szybsze i bardziej niezawodne ściąganie większych ilości danych. Dlatego jest to zalecane w przypadku dużych organizacji z ponad 100-K urządzeń. Ten interfejs API pobiera wszystkie dane w organizacji jako pliki do pobrania. Odpowiedź zawiera adresy URL umożliwiające pobranie wszystkich danych z usługi Azure Storage. Ten interfejs API umożliwia pobranie wszystkich danych z usługi Azure Storage w następujący sposób:
- Wywołaj interfejs API, aby uzyskać listę adresów URL pobierania ze wszystkimi danymi organizacji.
- Pobierz wszystkie pliki przy użyciu adresów URL pobierania i przetwórz dane zgodnie z tym, co chcesz.

Zbierane dane (przy użyciu odpowiedzi JSON lub za pośrednictwem plików) są bieżącą migawką bieżącego stanu. Nie zawiera danych historycznych. Aby zbierać dane historyczne, klienci muszą zapisywać dane we własnych magazynach danych.

Uwaga

O ile nie wskazano inaczej, wszystkie wymienione metody oceny eksportu to pełny eksport i urządzenie (określane również jako dla każdego urządzenia).

1. Eksportowanie oceny rozszerzeń przeglądarki (odpowiedź JSON)

Opis metody interfejsu API 1.1

Ta odpowiedź interfejsu API zawiera wszystkie dane dotyczące zainstalowanych rozszerzeń przeglądarki na urządzenie. Zwraca tabelę z wpisem dla każdej unikatowej kombinacji elementów DeviceId, BrowserName, ExtensionId.

1.1.1 Ograniczenia

Maksymalny rozmiar strony to 200 000.
Ograniczenia szybkości dla tego interfejsu API to 30 wywołań na minutę i 1000 wywołań na godzinę.

1.2 Uprawnienia

Do wywołania tego interfejsu API jest wymagane jedno z następujących uprawnień. Aby dowiedzieć się więcej, w tym jak wybrać uprawnienia, zobacz Używanie interfejsów API Ochrona punktu końcowego w usłudze Microsoft Defender, aby uzyskać szczegółowe informacje.

Typ uprawnień	Uprawnienie	Nazwa wyświetlana uprawnień
Aplikacja	Software.Read.All	"Odczytywanie informacji o oprogramowaniu do zarządzania zagrożeniami i lukami w zabezpieczeniach"
Delegowane (konto służbowe)	Software.Read	"Odczytywanie informacji o oprogramowaniu do zarządzania zagrożeniami i lukami w zabezpieczeniach"

Adres URL 1.3

GET /api/Machines/BrowserExtensionsInventoryByMachine

Parametry 1.4

pageSize (wartość domyślna = 50 000): liczba wyników w odpowiedzi.
$top: liczba wyników do zwrócenia (nie zwraca @odata.nextLink i w związku z tym nie ściąga wszystkich danych)

1.5 Właściwości

Uwaga

Każdy rekord to około 0,5 KB danych. Należy wziąć to pod uwagę podczas wybierania prawidłowego parametru pageSize.
Właściwości zdefiniowane w poniższej tabeli są wyświetlane alfabetycznie według identyfikatora właściwości. Podczas uruchamiania tego interfejsu API wynikowe dane wyjściowe nie muszą być zwracane w tej samej kolejności wymienionej w tej tabeli.
W odpowiedzi mogą zostać zwrócone dodatkowe kolumny. Te kolumny są tymczasowe i mogą zostać usunięte. Użyj tylko udokumentowanych kolumn.

Właściwość (ID)	Typ danych	Opis
Nazwa przeglądarki	Ciąg	Nazwa przeglądarki, w której zainstalowano rozszerzenie.
Deviceid	Ciąg	Unikatowy identyfikator urządzenia.
DeviceName	Ciąg	W pełni kwalifikowana nazwa domeny (FQDN) urządzenia.
ExtensionDescription	Ciąg	Opis określonego rozszerzenia przeglądarki.
ExtensionId	Ciąg	Unikatowy identyfikator określonego rozszerzenia przeglądarki.
ExtensionName	Ciąg	Nazwa określonego rozszerzenia przeglądarki.
ExtensionRisk	Ciąg	Najwyższy poziom ryzyka wygenerowany przez rozszerzenie przeglądarki. Możliwe wartości to: "None", "Low", "Medium", "High", "Critical".
ExtensionVersion	Ciąg	Numer wersji określonego rozszerzenia przeglądarki.
IsActivated	Wartość logiczna	Wskazuje, czy rozszerzenie przeglądarki jest aktywne.
RbacGroupId	Liczba całkowita	Identyfikator grupy kontroli dostępu opartej na rolach (RBAC).
RbacGroupName	Ciąg	Grupa kontroli dostępu opartej na rolach (RBAC). Jeśli to urządzenie nie jest przypisane do żadnej grupy RBAC, wartość będzie mieć wartość "Nieprzypisane". Jeśli organizacja nie zawiera żadnych grup RBAC, wartość będzie mieć wartość "Brak".
InstallationTime	Ciąg	Czas instalacji rozszerzenia przeglądarki.
Uprawnienia	Tablica[ciąg]	Zestaw uprawnień żądanych przez określone rozszerzenie przeglądarki.

1.6 Przykłady

1.6.1 Przykład żądania

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

Przykład odpowiedzi 1.6.2

{
    "@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. Eksportowanie oceny rozszerzenia przeglądarki (za pośrednictwem plików)

Opis metody interfejsu API w wersji 2.1

Ograniczenia 2.1.1

Ograniczenia szybkości dla tego interfejsu API to 5 wywołań na minutę i 20 wywołań na godzinę.

2.2 Uprawnienia

Typ uprawnień	Uprawnienie	Nazwa wyświetlana uprawnień
Aplikacja	Software.Read.All	"Odczytywanie informacji o oprogramowaniu do zarządzania zagrożeniami i lukami w zabezpieczeniach"
Delegowane (konto służbowe)	Software.Read	"Odczytywanie informacji o oprogramowaniu do zarządzania zagrożeniami i lukami w zabezpieczeniach"

Adres URL 2.3

GET /api/machines/browserextensionsinventoryExport

Parametry 2.4

sasValidHours: liczba godzin, przez które adresy URL pobierania będą ważne (maksymalnie 24 godziny)

2.5 Właściwości

Uwaga

Pliki są skompresowane gzip & w wielowierszowym formacie JSON.
Adresy URL pobierania są ważne tylko przez 3 godziny. W przeciwnym razie można użyć parametru .
Aby uzyskać maksymalną szybkość pobierania danych, możesz upewnić się, że pobierasz dane z tego samego regionu świadczenia usługi Azure, w którym znajdują się twoje dane.

Właściwość (ID)	Typ danych	Opis	Przykład zwracanej wartości
Eksportowanie plików	array[string]	Lista adresów URL pobierania plików przechowujących bieżącą migawkę organizacji	"[Https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1", "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2"]
GeneratedTime	Ciąg	Czas wygenerowania eksportu.	2021-05-20T08:00:00Z

2.6 Przykłady

2.6.1 Przykład żądania

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

Przykład odpowiedzi 2.6.2

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

Zobacz też

Porada

Chcesz dowiedzieć się więcej? Engage ze społecznością microsoft security w naszej społeczności technicznej: Ochrona punktu końcowego w usłudze Microsoft Defender Tech Community.

Udostępnij za pośrednictwem

Eksportowanie oceny rozszerzeń przeglądarki na urządzenie

1. Eksportowanie oceny rozszerzeń przeglądarki (odpowiedź JSON)

Opis metody interfejsu API 1.1

1.1.1 Ograniczenia

1.2 Uprawnienia

Adres URL 1.3

Parametry 1.4

1.5 Właściwości

1.6 Przykłady

1.6.1 Przykład żądania

Przykład odpowiedzi 1.6.2

2. Eksportowanie oceny rozszerzenia przeglądarki (za pośrednictwem plików)

Opis metody interfejsu API w wersji 2.1

Ograniczenia 2.1.1

2.2 Uprawnienia

Adres URL 2.3

Parametry 2.4

2.5 Właściwości

2.6 Przykłady

2.6.1 Przykład żądania

Przykład odpowiedzi 2.6.2

Zobacz też

Opinia

Dodatkowe zasoby

Udostępnij za pośrednictwem

Eksportowanie oceny rozszerzeń przeglądarki na urządzenie

1. Eksportowanie oceny rozszerzeń przeglądarki (odpowiedź JSON)

Opis metody interfejsu API 1.1

1.1.1 Ograniczenia

1.2 Uprawnienia

Adres URL 1.3

Parametry 1.4

1.5 Właściwości

1.6 Przykłady

1.6.1 Przykład żądania

Przykład odpowiedzi 1.6.2

2. Eksportowanie oceny rozszerzenia przeglądarki (za pośrednictwem plików)

Opis metody interfejsu API w wersji 2.1

Ograniczenia 2.1.1

2.2 Uprawnienia

Adres URL 2.3

Parametry 2.4

2.5 Właściwości

2.6 Przykłady

2.6.1 Przykład żądania

Przykład odpowiedzi 2.6.2

Zobacz też

Inne powiązane

Opinia

Dodatkowe zasoby