Hae selainlaajennusten käyttöoikeustiedot

Tärkeää

Jotkin tämän artikkelin tiedot liittyvät tuotteen ennakkojulkaisuversioon, jota voidaan muuttaa huomattavasti ennen kaupallista julkaisua. Microsoft ei anna mitään takuita tässä annettujen tietojen suhteen.

Ohjelmointirajapinnan kuvaus

Hakee luettelon kaikista tietyn selainlaajennuksen pyytämistä käyttöoikeuksista. Tämä on staattinen tietojen kuvaus, ja sitä käytetään pääasiassa parantamaan selainlaajennusten arvioinnin ohjelmointirajapinnan palauttamia tietoja.

Yhdistämällä nämä ohjelmointirajapinnat näet kuvauksen selainlaajennusten pyytämistä käyttöoikeuksista, jotka tulevat esiin Vie selainlaajennusten arvioinnin tuloksissa.

Tukee OData V4 -kyselyitä. Tuetut OData-operaattorit:

• $filter seuraavissa ominaisuuksissa:
  • id
  • name
  • description
  • cvssV3
  • publishedOn
  • severity
  • updatedOn
• $top suurin arvo on 10 000.
• $skip

Katso esimerkkejä OData-kyselyistä, joissa on Microsoft Defender for Endpoint.

Käyttöoikeudet

Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja ja käyttöoikeuksien valitseminen on artikkelissa Microsoft Defender for Endpoint ohjelmointirajapintoja.

Käyttöoikeustyyppi	Lupaa	Käyttöoikeuden näyttönimi
Sovellus	Software.Read.All	Lue uhkien ja haavoittuvuuden hallinnan ohjelmistotiedot
Delegoitu (työpaikan tai oppilaitoksen tili)	Software.Read	Lue uhkien ja haavoittuvuuden hallinnan ohjelmistotiedot

HTTP-pyyntö

GET api/browserextensions/permissionsinfo

Pyynnön otsikot

Nimi	Kirjoita	Kuvaus
Lupa	Merkkijono	Haltija {token}. Pakollinen.

Pyynnön leipäteksti

Tyhjä

Vastaus

Jos tämä menetelmä onnistuu, se palauttaa arvon 200 OK ja sisältää luettelon kaikista selainlaajennuksen pyytämistä käyttöoikeuksista leipätekstissä.

Esimerkki

Esimerkkipyyntö

Tässä on esimerkki pyynnöstä.

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

Vastausesimerkki

Tässä on esimerkki vastauksesta.

{
    "@odata.context": "https://api.security.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."
    }

            ]
}
    ]