Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Detecta los permisos mínimos necesarios para llamar a las solicitudes de API de SharePoint Client-Side modelo de objetos (CSOM) registradas.
Definición de instancia del complemento
{
"name": "MinimalCsomPermissionsPlugin",
"enabled": true,
"pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
"configSection": "minimalCsomPermissionsPlugin"
}
Ejemplo de configuración
{
"minimalCsomPermissionsPlugin": {
"$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.29.2/minimalcsompermissionsplugin.schema.json",
"typesFilePath": "./api-specs"
}
}
Propiedades de configuración
Propiedad | Descripción | Predeterminado |
---|---|---|
typesFilePath |
Ruta de acceso al archivo que enumera los permisos necesarios para llamar a las API de CSOM de SharePoint | ~appFolder/config/spo-csom-types.json |
Opciones de línea de comandos
Ninguno
Observaciones
El MinimalCsomPermissionsPlugin
complemento detecta qué permisos necesita la aplicación cliente como mínimo para llamar al conjunto de API de CSOM de SharePoint. Para detectar estos permisos mínimos, el complemento usa información sobre los permisos para las API de CSOM de SharePoint ubicadas en el archivo de tipos CSOM de SharePoint especificado.
Archivo de tipos CSOM de SharePoint
MinimalCsomPermissionsPlugin
usa un archivo de tipos CSOM para determinar qué permisos mínimos necesita la aplicación cliente para llamar al conjunto específico de API de CSOM. El archivo de tipos CSOM es un archivo JSON que contiene información sobre los tipos CSOM de SharePoint y sus permisos. En el ejemplo siguiente se muestra un archivo de tipos CSOM de ejemplo:
{
"$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.29.2/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": [
]
}
}
}
El archivo consta de tres partes principales:
types
returnTypes
actions
La types
sección contiene una lista de tipos de CSOM de SharePoint y sus identificadores. Esta sección se incluye para facilitar la legibilidad, ya que es más fácil de entender Microsoft.SharePoint.Client.RequestContext.Current
que 3747adcd-a3c3-41b9-bfab-4a64dd2f1e0a.Current
.
La returnTypes
sección contiene una lista de tipos de valor devuelto para los métodos de la actions
sección . El complemento usa esta información al analizar las solicitudes de CSOM para atravesar la jerarquía de las API de CSOM.
La actions
sección contiene una lista de acciones que se pueden realizar mediante las API de CSOM de SharePoint. Para cada acción, enumera los permisos delegados y de aplicación que una aplicación cliente puede usar para realizar esta acción. Los permisos se ordenan de forma ascendente por su privilegio, de modo que los permisos con menos privilegios se enumeran primero.
A partir de hoy, el archivo de tipos CSOM que incluimos con proxy de desarrollo está incompleto. Estamos trabajando junto con nuestra comunidad para documentar más tipos. Mientras tanto, puede actualizarlo para incluir los tipos y permisos que necesita si falta la información que necesita. A continuación, puede usar su propio archivo de tipos. Le animamos a contribuir con los cambios a la comunidad para que todos podamos beneficiarnos de ellos mediante la creación de una solicitud de incorporación de cambios en el repositorio de ejemplos del proxy de desarrollo. Extraemos periódicamente los cambios más recientes del repositorio al repositorio de proxy de desarrollo para que pueda beneficiarse de los cambios más recientes sin tener que actualizar la instalación del proxy de desarrollo.