Obter informações de permissão das extensões do browser

2025-03-07

Aplica-se a:

Microsoft Defender para Ponto de Extremidade
Gerenciamento de Vulnerabilidades do Microsoft Defender (suplemento para o Defender para Endpoint Plano 2 ou a versão autónoma)
Microsoft Defender para o Plano 2 da Cloud

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

Quer experimentar Gerenciamento de Vulnerabilidades do Microsoft Defender? Saiba mais sobre como se pode inscrever na Gerenciamento de Vulnerabilidades do Microsoft Defender avaliação de pré-visualização pública.

Observação

Se for um cliente do Governo norte-americano, utilize os URIs listados no Microsoft Defender para Ponto de Extremidade para clientes do Us Government.

Dica

Para um melhor desempenho, pode utilizar o servidor mais próximo da localização geográfica:

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

Importante

Algumas informações neste artigo estão relacionadas ao produto pré-lançado que pode ser modificado substancialmente antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, com relação às informações aqui fornecidas.

Descrição da API

Obtém uma lista de todas as permissões pedidas por uma extensão de browser específica. Esta é uma descrição de dados estáticos e seria utilizada principalmente para melhorar os dados devolvidos pela API de avaliação exportar extensões do browser.

Ao combinar estas APIs, poderá ver uma descrição das permissões pedidas pelas extensões do browser que surgem nos resultados da avaliação Exportar extensões do browser .

Suporta consultas OData V4.
Operadores suportados pelo OData:
$filter em: id, name, description, cvssV3, publishedOn, severitye updatedOn propriedades.
$top com o valor máximo de 10 000.
$skip.
Veja exemplos em Consultas OData com Microsoft Defender para Ponto de Extremidade.

Permissões

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

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

Solicitação HTTP

GET api/browserextensions/permissionsinfo

Cabeçalhos de solicitação

Nome	Tipo	Descrição
Autorização	Cadeia de caracteres	{token} de portador. Obrigatório.

Corpo da solicitação

Vazio

Resposta

Se for bem-sucedido, este método devolve 200 OK com a lista de todas as permissões pedidas por uma extensão do browser no corpo.

Exemplo

Exemplo de solicitação

Este é um exemplo da solicitação.

GET https://api.securitycenter.microsoft.com/api/browserextensions/permissionsinfo

Exemplo de resposta

Veja a seguir um exemplo da resposta.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#BrowserExtension",
    "value": [
{
  "value": [
    {
      "key": "audioCapture",
      "permissionName": "Capture audio from attached mic or webcam",
      "description": "Capture audio from attached mic or webcam. Could be used to listen in on use."
    },
    {
      "key": "app.window.fullscreen.overrideEsc",
      "permissionName": "Prevent escape button from exiting fullscreen",
      "description": "Can prevent escape button from exiting fullscreen."
    },
    {
      "key": "browsingData",
      "permissionName": "Clear browsing data",
      "description": "Clears browsing data which could result in a forensics/logging issues."
    },
    {
      "key": "content_security_policy",
      "permissionName": "Can manipulate default Content Security Policy (CSP)",
      "description": "CSP works as a block/allow listing mechanism for resources loaded or executed by your extensions. Can manipulate default CSP."
    }

            ]
}
    ]

Confira também