PluginAutorizzazioniMinimaliCsom

Rileva le autorizzazioni minime necessarie per chiamare le richieste dell'API CSOM (Object Model) di SharePoint Client-Side registrate.

Definizione dell'istanza del plug-in

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

Esempio di configurazione

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

Proprietà di configurazione

Proprietà	Descrizione	Predefinito
typesFilePath	Percorso del file che elenca le autorizzazioni necessarie per chiamare le API CSOM di SharePoint	~appFolder/config/spo-csom-types.json

Opzioni della riga di comando

Nessuno

Osservazioni:

Il MinimalCsomPermissionsPlugin plug-in rileva le autorizzazioni necessarie almeno per chiamare il set di API CSOM di SharePoint. Per rilevare queste autorizzazioni minime, il plug-in usa informazioni sulle autorizzazioni per le API CSOM di SharePoint presenti nel file di tipi CSOM di SharePoint specificato.

File di tipi CSOM di SharePoint

MinimalCsomPermissionsPlugin usa un file di tipi CSOM per determinare quali autorizzazioni minime l'applicazione client deve chiamare il set specifico di API CSOM. Il file dei tipi CSOM è un file JSON che contiene informazioni sui tipi CSOM di SharePoint e sulle relative autorizzazioni. L'esempio seguente mostra un file di tipi CSOM di esempio:

{
  "$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": [
      ]
    }
  }
}

Il file è costituito da tre parti principali:

• types
• returnTypes
• actions

La types sezione contiene un elenco di tipi CSOM di SharePoint e i relativi ID. Questa sezione è inclusa per la leggibilità perché è più facile da comprendere Microsoft.SharePoint.Client.RequestContext.Current rispetto 3747adcd-a3c3-41b9-bfab-4a64dd2f1e0a.Currenta .

La returnTypes sezione contiene un elenco di tipi restituiti per i metodi nella actions sezione . Il plug-in usa queste informazioni durante l'analisi delle richieste CSOM per attraversare la gerarchia delle API CSOM.

La actions sezione contiene un elenco di azioni che possono essere eseguite usando le API CSOM di SharePoint. Per ogni azione, elenca le autorizzazioni delegate e dell'applicazione che un'applicazione client può usare per eseguire questa azione. Le autorizzazioni vengono ordinate in ordine crescente in base al privilegio, in modo che le autorizzazioni con privilegi minimi siano elencate per prime.

A partire da oggi, il file dei tipi CSOM incluso con Dev Proxy è incompleto. Stiamo lavorando insieme alla nostra community per documentare più tipi. Nel frattempo, è possibile aggiornarlo per includere i tipi e le autorizzazioni necessari se mancano le informazioni necessarie. È quindi possibile usare il proprio file di tipi. È consigliabile contribuire alle modifiche apportate alla community in modo che tutti possano trarre vantaggio da tali modifiche creando una richiesta pull nel repository di esempi di Dev Proxy. Le modifiche più recenti vengono estratte regolarmente dal repository al repository Dev Proxy in modo da poter trarre vantaggio dalle modifiche più recenti senza dover aggiornare l'installazione del proxy di sviluppo.