MinimalCsomEngedélyekBővítmény

Minimális engedélyeket észlel a rögzített SharePoint Client-Side Objektummodell (CSOM) API-kérések meghívásához.

Beépülő modulpéldány definíciója

{
  "name": "MinimalCsomPermissionsPlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
  "configSection": "minimalCsomPermissionsPlugin"
}

Példa konfigurációra

{
  "minimalCsomPermissionsPlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/minimalcsompermissionsplugin.schema.json",
    "typesFilePath": "./api-specs"
  }
}

Konfigurációs tulajdonságok

Ingatlan	Leírás	Alapértelmezett
typesFilePath	A SharePoint CSOM API-k meghívásához szükséges engedélyeket tartalmazó fájl elérési útja	~appFolder/config/spo-csom-types.json

Parancssori beállítások

Egyik sem

Megjegyzések

A MinimalCsomPermissionsPlugin beépülő modul észleli, hogy az ügyfélalkalmazásnak milyen engedélyekre van szüksége legalább a SharePoint CSOM API-k meghívásához. A minimális engedélyek észleléséhez a beépülő modul a megadott SharePoint CSOM-típusok fájljában található SharePoint CSOM API-k engedélyeiről használ információkat.

SharePoint CSOM-típusok fájlja

A MinimalCsomPermissionsPlugin CSOM-típusok fájlja határozza meg, hogy az ügyfélalkalmazásnak milyen minimális engedélyekkel kell meghívnia az adott CSOM API-kat. A CSOM-típusok fájlja egy JSON-fájl, amely információkat tartalmaz a SharePoint CSOM-típusokról és azok engedélyeiről. Az alábbi példa egy CSOM-típusfájlt mutat be:

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/minimalcsompermissions.types.schema.json",
  "types": {
    "268004ae-ef6b-4e9b-8425-127220d84719": "Microsoft.Online.SharePoint.TenantAdministration.Tenant",
    "3747adcd-a3c3-41b9-bfab-4a64dd2f1e0a": "Microsoft.SharePoint.Client.RequestContext"
  },
  "returnTypes": {
    "Microsoft.SharePoint.Client.RequestContext.Current.Site": "Microsoft.SharePoint.Client.Site"
  },
  "actions": {
    "Microsoft.SharePoint.Client.RequestContext.Current": {
      "delegated": [
        "AllSites.Read",
        "AllSites.Write",
        "AllSites.Manage",
        "AllSites.FullControl"
      ],
      "application": []
    },
    "Microsoft.SharePoint.Client.Site.setProperty": {
      "delegated": [
        "AllSites.FullControl"
      ],
      "application": []
    },
    "Microsoft.Online.SharePoint.TenantAdministration.Tenant.ctor": {
      "delegated": [
        "AllSites.Read",
        "AllSites.Write",
        "AllSites.Manage",
        "AllSites.FullControl"
      ],
      "application": [
      ]
    },
    "Microsoft.Online.SharePoint.TenantAdministration.Tenant.query": {
      "delegated": [
        "AllSites.Write",
        "AllSites.Manage",
        "AllSites.FullControl"
      ],
      "application": [
      ]
    },
    "Microsoft.Online.SharePoint.TenantAdministration.Tenant.GetSitePropertiesFromSharePointByFilters": {
      "delegated": [
        "AllSites.FullControl"
      ],
      "application": [
      ]
    }
  }
}

A fájl három fő részből áll:

• types
• returnTypes
• actions

A types szakasz a SharePoint CSOM-típusok és azok azonosítóinak listáját tartalmazza. Ez a szakasz az olvashatóság kedvéért jelenik meg, mert könnyebben érthető Microsoft.SharePoint.Client.RequestContext.Current , mint 3747adcd-a3c3-41b9-bfab-4a64dd2f1e0a.Currenta .

A returnTypes szakasz a szakasz metódusainak actions visszatérési típusait tartalmazza. A beépülő modul ezeket az információkat használja a CSOM-kérések elemzésekor a CSOM API-k hierarchiájának bejárásához.

A actions szakasz a SharePoint CSOM API-k használatával végrehajtható műveletek listáját tartalmazza. Minden műveletnél felsorolja azokat a delegált és alkalmazásengedélyeket, amelyekkel az ügyfélalkalmazás végrehajthatja ezt a műveletet. Az engedélyek növekvő sorrendbe vannak rendezve a jogosultságuk szerint, így a legkevésbé kiemelt engedélyek jelennek meg először.

A dev proxyval együtt tartalmazott CSOM-típusok fájlja a mai napon nem teljes. Együttműködünk a közösségünkkel, hogy több típust dokumentáljunk. Addig is frissítheti, hogy tartalmazza a szükséges típusokat és engedélyeket, ha a szükséges információk hiányoznak. Ezután használhatja a saját típusok fájlját. Javasoljuk, hogy járuljon hozzá a módosításokhoz a közösséghez, hogy mindannyian kihasználhassuk őket. Ehhez hozzon létre egy lekéréses kérelmet a Dev Proxy-minták adattárában. Rendszeresen lekérjük a legújabb módosításokat az adattárból a Dev Proxy-adattárba, hogy a dev proxy telepítésének frissítése nélkül is kihasználhassa a legújabb módosításokat.