Contratti di raccolta — Microsoft SharePoint (on-premise)
01Come leggere questa pagina #sec_10d0227f
Ogni risorsa che REVIEWIT può raccogliere per Microsoft SharePoint (on-premise) ha un contratto pubblicato. Si legge come una riferimento API: ciò che REVIEWIT chiama sul servizio raccolto e attraverso quale mezzo, ciò che il contratto richiede affinché la raccolta si esegua e i dati che REVIEWIT conserva. REVIEWIT esegue solo letture.
- Chiamate: le richieste che REVIEWIT invia al servizio raccolto, tutte in lettura.
- Requisiti: ciascuno deve essere soddisfatto. La sua natura indica cosa richiede: un diritto da concedere all'identificativo, una condizione di amministrazione (un'impostazione o un'assegnazione presso il fornitore che il token non porta, verificata da una chiamata reale in lettura) o l'appartenenza dell'identificativo alla farm SharePoint della connessione. La regola indica quante opzioni sono necessarie: « obbligatoria » per l'unica opzione, « una a scelta » quando una sola è sufficiente (sono ordinate dalla più ristretta alla più ampia: preferire la prima), « tutte » o « N a scelta tra M ».
- Condizioni di funzionamento: ciò che REVIEWIT verifica prima di ogni raccolta, oltre ai requisiti.
- Freschezza: l'età massima delle verifiche su cui si basa il verdetto, fissata da ogni contratto (qui: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale). REVIEWIT non verifica ancora questa soluzione: questa durata si applicherà alle sue verifiche non appena le eseguirà.
- Dati conservati: i campi che REVIEWIT conserva di ogni oggetto; il ruolo indica cosa ne fa la revisione.
Il verdetto di ogni risorsa, per la vostra connessione, si legge sulla sua scheda. Una risorsa che la connessione non raccoglie può comunque essere alimentata dall'import di un rapporto (« Importare un rapporto »).
02Come REVIEWIT verifica i requisiti #sec_62891b78
Per Microsoft SharePoint (on-premise), i diritti dell'account di servizio non vengono letti in nessun token: il contratto richiede che vengano verificati mediante una chiamata effettiva di lettura. REVIEWIT non effettua ancora questa chiamata per Microsoft SharePoint (on-premise): né l'autenticazione dell'account di servizio né i suoi diritti vengono verificati. Le risorse vengono visualizzate come « Non verificato »; possono comunque essere alimentate dall'importazione di un rapporto (« Importa un rapporto »).
03I percorsi di chiamata #sec_bd6da6ea
Un percorso indica quale token REVIEWIT ottiene per l'identificatore: chi lo rilascia e per quale audience. Gli indirizzi chiamati sono indicati nelle chiamate di ogni risorsa; un percorso che inizia con « / » si chiama sull'audience del token del suo percorso.
| Percorso | Token rilasciato da | Audience del token | Autenticazione dell'identificatore |
|---|---|---|---|
| sp-onprem.server.reviewit.agent | nessun token: autenticazione Windows (Active Directory) dell'account di servizio | https://{farm} | password dell'account di servizio (Active Directory) |
Un percorso locale non rilascia alcun token: l'account di servizio si autentica tramite Windows (Active Directory) presso il server, ed è questa autenticazione che REVIEWIT verifica.
In questi indirizzi, {farm} è l'indirizzo della farm SharePoint.
04SharePoint OnPremise · Siti #sec_35b75973
sp-onprem.sharepoint.sites:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via sp-onprem.server.reviewit.agent
Collezioni di siti della farm SharePoint e loro assegnazioni di ruolo
{site} indica l'indirizzo di una collezione di siti, come la rende l'enumerazione (Path).
Chiamate
- GET https://{farm}/_api/search/query?querytext='contentclass:STS_Site'&selectproperties='Title,Path,SiteId'&rowlimit=500 (enumerazione delle collezioni di siti della farm)
- GET {site}/_api/site
- GET {site}/_api/web?$select=Id,Title,Url,Created,LastItemModifiedDate
- GET {site}/_api/web/roleassignments?$expand=Member,RoleDefinitionBindings
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | strategia di applicazione web « Lettura completa » (Full Read) concessa al conto di servizio nell'Amministrazione centrale |
| Appartenenza | richiesto | l'identificativo appartiene alla farm SharePoint della connessione |
Condizioni di funzionamento
- il conto di servizio si autentica (autenticazione Windows, Active Directory)
- il servizio https://{farm} risponde
Frescura: verifiche inferiori a 24 h; i diritti devono essere constatati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| Id | chiave dell'oggetto | intero | sì |
| Title | visualizzato per riconoscere l'oggetto | testo | sì |
| Url | visualizzato per riconoscere l'oggetto | testo | no |
| Owners | accesso soggetto alla revisione | lista di identità | no |
| Members | accesso soggetto alla revisione | lista di identità | no |
| Admin | accesso soggetto alla revisione | lista di identità | no |
| Guests | accesso soggetto alla revisione | lista di identità | no |
| Type | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastModified | contesto, senza effetto sulla revisione | data e ora | no |
| LastActivityDate | valutato dalle politiche REVIEWIT (data dell'ultima attività) | data e ora | no |
| Size | contesto, senza effetto sulla revisione | intero | no |
05SharePoint OnPremise · Sottositi #sec_8322202c
sp-onprem.sharepoint.subsites:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via sp-onprem.server.reviewit.agent
Sottositi della farm SharePoint e l'eredità delle loro autorizzazioni
{site} indica l'indirizzo di una raccolta di siti (enumrazione della risorsa Siti) ; {web} quello di un sottosito, come /_api/web/webs lo restituisce (Url).
Chiamate
- GET {site}/_api/web/webs?$select=Id,Title,Url,HasUniqueRoleAssignments (ricorsivo, per ogni raccolta di siti, escluso il sito radice)
- GET {web}/_api/web/roleassignments?$expand=Member,RoleDefinitionBindings
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | strategia di applicazione web « Lettura totale » (Full Read) concessa all'account di servizio nell'Amministrazione centrale |
| Appartenenza | richiesto | l'identificativo appartiene alla farm SharePoint della connessione |
Condizioni di funzionamento
- l'account di servizio si autentica (autenticazione Windows, Active Directory)
- il servizio https://{farm} risponde
Aggiornamento : verifiche inferiori a 24 h ; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| Id | chiave dell'oggetto | intero | sì |
| Title | visualizzato per riconoscere l'oggetto | testo | sì |
| Url | visualizzato per riconoscere l'oggetto | testo | no |
| Owners | accesso soggetto alla revisione | lista di identità | no |
| Members | accesso soggetto alla revisione | lista di identità | no |
| Visitors | accesso soggetto alla revisione | lista di identità | no |
| Guests | accesso soggetto alla revisione | lista di identità | no |
| Type | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastModified | valutato dalle politiche REVIEWIT (data dell'ultima attività) | data e ora | no |
| ParentId | contesto, senza effetto sulla revisione | testo | no |
| InheritsPermissions | contesto, senza effetto sulla revisione | booleano | no |
| Size | contesto, senza effetto sulla revisione | intero | no |
06Per andare oltre #sec_330f1291
- Comprendere una connessione di raccolta
- Riferimento dei diritti per risorsa
- Leggere un verdetto