Exportar avaliação de extensões de navegador por dispositivo

Artigo
04/27/2024

Aplica-se a:

Deseja experimentar o Microsoft Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita..

Quer experimentar Gerenciamento de Vulnerabilidades do Microsoft Defender? Saiba mais sobre como você pode se inscrever no Gerenciamento de Vulnerabilidades do Microsoft Defender avaliação de visualização pública.

Retorna todas as extensões de navegador instaladas conhecidas e seus detalhes para todos os dispositivos, por dispositivo.

Chamadas de API diferentes obtêm tipos diferentes de dados. Como a quantidade de dados pode ser grande, há duas maneiras de serem recuperados:

Exportar resposta JSON de avaliação de extensões de navegador A API puxa todos os dados em sua organização como respostas Json. Esse método é melhor para organizações pequenas com menos de 100 K dispositivos. A resposta é paginada, para que você possa usar o campo @odata.nextLink da resposta para buscar os próximos resultados.
Exportar avaliação de extensões de navegador por meio de arquivos Essa solução de API permite extrair quantidades maiores de dados de forma mais rápida e confiável. Portanto, é recomendável para organizações grandes, com mais de 100 K dispositivos. Essa API puxa todos os dados em sua organização como arquivos de download. A resposta contém URLs para baixar todos os dados do Armazenamento do Azure. Essa API permite baixar todos os dados do Armazenamento do Azure da seguinte maneira:
- Chame a API para obter uma lista de URLs de download com todos os dados da organização.
- Baixe todos os arquivos usando as URLs de download e processe os dados como quiser.

Os dados coletados (usando a resposta Json ou por meio de arquivos) são os instantâneo atuais do estado atual. Ele não contém dados históricos. Para coletar dados históricos, os clientes devem salvar os dados em seus próprios armazenamentos de dados.

Observação

A menos que indicado o contrário, todos os métodos de avaliação de exportação listados são exportação completa e por dispositivo (também conhecido como por dispositivo).

1. Exportar avaliação de extensões do navegador (resposta JSON)

1.1 Descrição do método de API

Essa resposta à API contém todos os dados para extensões de navegador instaladas por dispositivo. Retorna uma tabela com uma entrada para cada combinação exclusiva de DeviceId, BrowserName, ExtensionId.

1.1.1 Limitações

O tamanho máximo da página é de 200.000.
As limitações de taxa para essa API são 30 chamadas por minuto e 1000 chamadas por hora.

1.2 Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, consulte Usar APIs Microsoft Defender para Ponto de Extremidade para obter detalhes.

Tipo de permissão	Permissão	Nome da exibição de permissão
Application	Software.Read.All	'Ler informações de software de Gerenciamento de Ameaças e Vulnerabilidades'
Delegado (conta corporativa ou de estudante)	Software.Read	'Ler informações de software de Gerenciamento de Ameaças e Vulnerabilidades'

1.3 URL

GET /api/Machines/BrowserExtensionsInventoryByMachine

1.4 Parâmetros

pageSize (padrão = 50.000): número de resultados em resposta.
$top: número de resultados a serem retornados (não retorna @odata.nextLink e, portanto, não puxa todos os dados)

1.5 Propriedades

Observação

Cada registro é aproximadamente 0,5KB de dados. Você deve levar isso em conta ao escolher o parâmetro pageSize correto para você.
As propriedades definidas na tabela a seguir são listadas em ordem alfabética, por ID da propriedade. Ao executar essa API, a saída resultante não será necessariamente retornada na mesma ordem listada nesta tabela.
Algumas colunas adicionais podem ser retornadas na resposta. Essas colunas são temporárias e podem ser removidas, use apenas as colunas documentadas.

Propriedade (ID)	Tipo de dados	Descrição
BrowserName	string	Nome do navegador em que a extensão está instalada.
DeviceId	cadeia de caracteres	Identificador exclusivo para o dispositivo.
DeviceName	cadeia de caracteres	FQDN (nome de domínio totalmente qualificado) do dispositivo.
ExtensionDescription	string	Descrição de uma extensão de navegador específica.
ExtensionId	string	Identificador exclusivo para uma extensão de navegador específica.
ExtensionName	string	Nome de uma extensão de navegador específica.
ExtensionRisk	string	O nível de risco mais alto gerado pela extensão do navegador. Os valores possíveis são: "Nenhum", "Baixo", "Médio", "Alto", "Crítico".
ExtensionVersion	string	Número de versão de uma extensão de navegador específica.
IsActivated	Booliano	Indica se uma extensão do navegador está ativa.
RbacGroupId	inteiro	A ID do grupo RBAC (controle de acesso baseado em função).
RbacGroupName	cadeia de caracteres	O grupo RBAC (controle de acesso baseado em função). Se esse dispositivo não for atribuído a nenhum grupo RBAC, o valor será "Não atribuído". Se a organização não contiver nenhum grupo RBAC, o valor será "Nenhum".
InstallationTime	string	A hora em que a extensão do navegador foi instalada.
Permissões	Matriz[cadeia de caracteres]	O conjunto de permissões solicitadas por uma extensão de navegador específica.

1.6 Exemplos

1.6.1 Exemplo de solicitação

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

1.6.2 Exemplo de resposta

{
    "@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. Exportar avaliação de extensão do navegador (por meio de arquivos)

Descrição do método de API 2.1

Limitações 2.1.1

As limitações de taxa para essa API são 5 chamadas por minuto e 20 chamadas por hora.

2.2 Permissões

Tipo de permissão	Permissão	Nome da exibição de permissão
Application	Software.Read.All	'Ler informações de software de Gerenciamento de Ameaças e Vulnerabilidades'
Delegado (conta corporativa ou de estudante)	Software.Read	'Ler informações de software de Gerenciamento de Ameaças e Vulnerabilidades'

2.3 URL

GET /api/machines/browserextensionsinventoryExport

Parâmetros 2.4

sasValidHours: o número de horas pelas quais as URLs de download serão válidas (máximo de 24 horas)

2.5 Propriedades

Observação

Os arquivos são compactados gzip & no formato JSON multiline.
As URLs de download são válidas apenas por 3 horas. Caso contrário, você pode usar o parâmetro.
Para obter a velocidade máxima de download de seus dados, você pode ter certeza de que está baixando da mesma região do Azure que seus dados residem.

Propriedade (ID)	Tipo de dados	Descrição	Exemplo de um valor retornado
Exportar arquivos	array[string]	Uma lista de URLs de download para arquivos que contêm o instantâneo atual da organização	"[Https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1", "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2"]
GeneratedTime	string	O tempo em que a exportação foi gerada.	2021-05-20T08:00:00Z

2.6 Exemplos

2.6.1 Exemplo de solicitação

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

Exemplo de resposta 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"
}

Confira também

Dica

Você deseja aprender mais? Engage com a comunidade de Segurança da Microsoft em nossa Comunidade Tecnológica: Microsoft Defender para Ponto de Extremidade Tech Community.

Compartilhar via

Exportar avaliação de extensões de navegador por dispositivo

1. Exportar avaliação de extensões do navegador (resposta JSON)

1.1 Descrição do método de API

1.1.1 Limitações

1.2 Permissões

1.3 URL

1.4 Parâmetros

1.5 Propriedades

1.6 Exemplos

1.6.1 Exemplo de solicitação

1.6.2 Exemplo de resposta

2. Exportar avaliação de extensão do navegador (por meio de arquivos)

Descrição do método de API 2.1

Limitações 2.1.1

2.2 Permissões

2.3 URL

Parâmetros 2.4

2.5 Propriedades

2.6 Exemplos

2.6.1 Exemplo de solicitação

Exemplo de resposta 2.6.2

Confira também

Comentários

Recursos adicionais

Compartilhar via

Exportar avaliação de extensões de navegador por dispositivo

1. Exportar avaliação de extensões do navegador (resposta JSON)

1.1 Descrição do método de API

1.1.1 Limitações

1.2 Permissões

1.3 URL

1.4 Parâmetros

1.5 Propriedades

1.6 Exemplos

1.6.1 Exemplo de solicitação

1.6.2 Exemplo de resposta

2. Exportar avaliação de extensão do navegador (por meio de arquivos)

Descrição do método de API 2.1

Limitações 2.1.1

2.2 Permissões

2.3 URL

Parâmetros 2.4

2.5 Propriedades

2.6 Exemplos

2.6.1 Exemplo de solicitação

Exemplo de resposta 2.6.2

Confira também

Outros relacionados

Comentários

Recursos adicionais