MinimalCsomİzinlerEklentisi

Kaydedilen SharePoint Client-Side Nesne Modeli (CSOM) API isteklerini çağırmak için gereken en düşük izinleri algılar.

Eklenti örneği tanımı

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

Yapılandırma örneği

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

Yapılandırma özellikleri

Mülkiyet	Açıklama	Varsayılan
typesFilePath	SharePoint CSOM API'lerini çağırmak için gereken izinleri listeleyen dosyanın yolu	~appFolder/config/spo-csom-types.json

Komut satırı seçenekleri

Hiç kimse

Açıklamalar

Eklenti, MinimalCsomPermissionsPlugin istemci uygulamasının SharePoint CSOM API'leri kümesini çağırmak için en azından hangi izinlere ihtiyacı olduğunu algılar. Bu en düşük izinleri algılamak için eklenti, belirtilen SharePoint CSOM türleri dosyasında bulunan SharePoint CSOM API'lerinin izinleri hakkındaki bilgileri kullanır.

SharePoint CSOM türleri dosyası

, MinimalCsomPermissionsPlugin istemci uygulamasının belirli CSOM API'leri kümesini çağırmak için gereken en düşük izinleri belirlemek için bir CSOM türleri dosyası kullanır. CSOM türleri dosyası, SharePoint CSOM türleri ve izinleri hakkında bilgi içeren bir JSON dosyasıdır. Aşağıdaki örnekte örnek bir CSOM türleri dosyası gösterilmektedir:

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

Dosya üç ana bölümden oluşur:

• types
• returnTypes
• actions

types bölümünde SharePoint CSOM türlerinin ve kimliklerinin listesi yer alır. Daha kolay anlaşılabildiğinden Microsoft.SharePoint.Client.RequestContext.Current3747adcd-a3c3-41b9-bfab-4a64dd2f1e0a.Currentbu bölüm okunabilirlik için eklenmiştir.

bölümü, returnTypes bölümündeki yöntemlerin dönüş türlerinin actions listesini içerir. Eklenti, CSOM API'lerinin hiyerarşisinde gezinmek için CSOM isteklerini ayrıştırırken bu bilgileri kullanır.

bölümü, actions SharePoint CSOM API'leri kullanılarak gerçekleştirilebilecek eylemlerin listesini içerir. Her eylem için, bir istemci uygulamasının bu eylemi gerçekleştirmek için kullanabileceği temsilci ve uygulama izinlerini listeler. İzinler ayrıcalıklarına göre artan düzende sıralanır, böylece önce en az ayrıcalıklı izinler listelenir.

Bugün itibarıyla, Geliştirme Proxy'si ile eklediğimiz CSOM türleri dosyası tamamlanmamıştır. Topluluğumuzla birlikte çalışarak daha fazla türü belgeleyeceğiz. Bu arada, ihtiyacınız olan bilgiler eksikse ihtiyacınız olan türleri ve izinleri içerecek şekilde güncelleştirebilirsiniz. Daha sonra kendi tür dosyanızı kullanabilirsiniz. Geliştirme Ara Sunucusu örnekleri deposunda bir çekme isteği oluşturarak hepimizin yararlanabilmesi için değişikliklerinizi topluluğa geri göndermenizi öneririz. Dev Proxy yüklemenizi güncelleştirmenize gerek kalmadan en son değişikliklerden yararlanabilmeniz için en son değişiklikleri depodan Dev Proxy deposuna düzenli olarak çekiyoruz.