Contratos de recolección — Microsoft SharePoint (local)
01Cómo leer esta página #sec_10d0227f
Cada recurso que REVIEWIT puede recolectar para Microsoft SharePoint (local) tiene un contrato publicado. Se lee como una referencia de API: lo que REVIEWIT llama en el servicio recolectado y por qué medio, lo que el contrato exige para que la recolección se ejecute, y los datos que REVIEWIT conserva. REVIEWIT solo realiza lecturas.
- Llamadas: las solicitudes que REVIEWIT envía al servicio recolectado, todas en lectura.
- Exigencias: cada una debe satisfacerse. Su naturaleza indica lo que solicita: un derecho a conceder al identificador, una condición de administración (una configuración o asignación en el proveedor que el token no incluye, comprobada por una llamada real en lectura), o la pertenencia del identificador a la granja SharePoint de la conexión. La regla indica cuántas opciones se necesitan: « requerida » para la única opción, « una a elección » cuando una sola es suficiente (están ordenadas de la más estrecha a la más amplia: prefiera la primera), « todas », o « N a elección entre M ».
- Condiciones de funcionamiento: lo que REVIEWIT comprueba antes de cada recolección, más allá de los requisitos.
- Frescura: la edad máxima de las comprobaciones sobre las que se basa el veredicto, fijada por cada contrato (aquí: comprobaciones de menos de 24 h; los derechos deben comprobarse mediante una llamada real). REVIEWIT aún no verifica esta solución: esta duración se aplicará a sus comprobaciones tan pronto como las realice.
- Datos conservados: los campos que REVIEWIT guarda de cada objeto; el rol indica qué hace la revisión con ellos.
El veredicto de cada recurso, para su conexión, se lee en su ficha. Un recurso que la conexión no recolecta siempre puede ser alimentado por la importación de un informe (« Importar un informe »).
02Cómo REVIEWIT verifica los requisitos #sec_62891b78
Para Microsoft SharePoint (local), los derechos de la cuenta de servicio no se leen en ningún token: el contrato exige que se comprueben mediante una llamada real, en lectura. REVIEWIT aún no realiza esta llamada para Microsoft SharePoint (local): ni la autenticación de la cuenta de servicio ni sus derechos se comprueban. Los recursos aparecen como « No verificado »; siempre pueden ser alimentados por la importación de un informe (« Importar un informe »).
03Las vías de llamada #sec_bd6da6ea
Una vía indica qué token obtiene REVIEWIT para el identificador: quién lo emite y para qué audiencia. Las direcciones llamadas aparecen en las llamadas de cada recurso; un camino que comienza con « / » se llama sobre la audiencia del token de su vía.
| Vía | Token emitido por | Audiencia del token | Autenticación del identificador |
|---|---|---|---|
| sp-onprem.server.reviewit.agent | ningún token: autenticación Windows (Active Directory) de la cuenta de servicio | https://{farm} | contraseña de la cuenta de servicio (Active Directory) |
Una vía local no emite ningún token: la cuenta de servicio se autentica mediante Windows (Active Directory) en el servidor, y es esta autenticación la que REVIEWIT comprueba.
En estas direcciones, {farm} es la dirección de la granja SharePoint.
04SharePoint OnPremise · Sitios #sec_35b75973
sp-onprem.sharepoint.sites:collect · revisión 2 del contrato, publicado el 18 octubre 2026 · vía sp-onprem.server.reviewit.agent
Colecciones de sitios de la granja SharePoint y sus asignaciones de rol
{site} designa la dirección de una colección de sitios, tal como la enumeración la devuelve (Path).
Llamadas
- GET https://{farm}/_api/search/query?querytext='contentclass:STS_Site'&selectproperties='Title,Path,SiteId'&rowlimit=500 (enumeración de las colecciones de sitios de la granja)
- GET {site}/_api/site
- GET {site}/_api/web?$select=Id,Title,Url,Created,LastItemModifiedDate
- GET {site}/_api/web/roleassignments?$expand=Member,RoleDefinitionBindings
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerida | estrategia de aplicación web « Lectura total » (Full Read) concedida a la cuenta de servicio en la Administración central |
| Pertenencia | requerida | el identificador pertenece a la granja SharePoint de la conexión |
Condiciones de funcionamiento
- la cuenta de servicio se autentica (autenticación Windows, Active Directory)
- el servicio https://{farm} responde
Frescura: comprobaciones de menos de 24 h; los derechos deben comprobarse mediante una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| Id | clave del objeto | entero | sí |
| Title | mostrado para reconocer el objeto | texto | sí |
| Url | mostrado para reconocer el objeto | texto | no |
| Owners | acceso sujeto a la revisión | lista de identidades | no |
| Members | acceso sujeto a la revisión | lista de identidades | no |
| Admin | acceso sujeto a la revisión | lista de identidades | no |
| Guests | acceso sujeto a la revisión | lista de identidades | no |
| Type | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastModified | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastActivityDate | evaluado por las políticas REVIEWIT (fecha de última actividad) | fecha y hora | no |
| Size | contexto, sin efecto sobre la revisión | entero | no |
05SharePoint OnPremise · Subsites #sec_8322202c
sp-onprem.sharepoint.subsites:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía sp-onprem.server.reviewit.agent
Subsitios de la granja SharePoint y la herencia de sus permisos
{site} designa la dirección de una colección de sitios (enumeración del recurso Sitios); {web} la de un subsitio, tal como /_api/web/webs la muestra (Url).
Llamadas
- GET {site}/_api/web/webs?$select=Id,Title,Url,HasUniqueRoleAssignments (recursivo, para cada colección de sitios, excepto el sitio raíz)
- GET {web}/_api/web/roleassignments?$expand=Member,RoleDefinitionBindings
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | política de aplicación web « Lectura total » (Full Read) concedida al cuenta de servicio en la Administración central |
| Pertenencia | requerido | el identificador pertenece a la granja SharePoint de la conexión |
Condiciones de funcionamiento
- la cuenta de servicio se autentifica (autenticación Windows, Active Directory)
- el servicio https://{farm} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| Id | clave del objeto | entero | sí |
| Title | mostrado para reconocer el objeto | texto | sí |
| Url | mostrado para reconocer el objeto | texto | no |
| Owners | acceso sujeto a la revisión | lista de identidades | no |
| Members | acceso sujeto a la revisión | lista de identidades | no |
| Visitors | acceso sujeto a la revisión | lista de identidades | no |
| Guests | acceso sujeto a la revisión | lista de identidades | no |
| Type | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastModified | evaluado por las políticas REVIEWIT (fecha de última actividad) | fecha y hora | no |
| ParentId | contexto, sin efecto sobre la revisión | texto | no |
| InheritsPermissions | contexto, sin efecto sobre la revisión | booleano | no |
| Size | contexto, sin efecto sobre la revisión | entero | no |
06Para ir más allá #sec_330f1291
- Comprender una conexión de recolección
- Referencia de permisos por recurso
- Leer un veredicto