Contrats de collecte — Microsoft SharePoint (sur site)
01Comment lire cette page #sec_10d0227f
Chaque ressource que REVIEWIT sait collecter pour Microsoft SharePoint (sur site) a un contrat publié. Il se lit comme une référence d'API : ce que REVIEWIT appelle sur le service collecté et par quelle voie, ce que le contrat exige pour que la collecte s'exécute, et les données que REVIEWIT conserve. REVIEWIT ne fait que des lectures.
- Appels : les requêtes que REVIEWIT adresse au service collecté, toutes en lecture.
- Exigences : chacune doit être satisfaite. Sa nature dit ce qu'elle demande : un droit à accorder à l'identifiant, une condition d'administration (un réglage ou une attribution chez le fournisseur que le jeton ne porte pas, constaté par un appel réel en lecture), ou l'appartenance de l'identifiant à la ferme SharePoint de la connexion. La règle dit combien d'options il faut : « requise » pour l'unique option, « une au choix » quand une seule suffit (elles sont rangées de la plus étroite à la plus large : préférez la première), « toutes », ou « N au choix parmi M ».
- Conditions de fonctionnement : ce que REVIEWIT constate avant chaque collecte, au-delà des exigences.
- Fraîcheur : l'âge maximal des vérifications sur lesquelles le verdict s'appuie, fixé par chaque contrat (ici : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel). REVIEWIT ne vérifie pas encore cette solution : cette durée s'appliquera à ses vérifications dès qu'il les fera.
- Données conservées : les champs que REVIEWIT garde de chaque objet ; le rôle dit ce que la revue en fait.
Le verdict de chaque ressource, pour votre connexion, se lit sur sa fiche. Une ressource que la connexion ne collecte pas peut toujours être alimentée par l'import d'un rapport (« Importer un rapport »).
02Comment REVIEWIT vérifie les exigences #sec_62891b78
Pour Microsoft SharePoint (sur site), les droits du compte de service ne se lisent dans aucun jeton : le contrat exige qu'ils soient constatés par un appel réel, en lecture. REVIEWIT ne fait pas encore cet appel pour Microsoft SharePoint (sur site) : ni l'authentification du compte de service ni ses droits ne sont constatés. Les ressources s'affichent « Non vérifié » ; elles peuvent toujours être alimentées par l'import d'un rapport (« Importer un rapport »).
03Les voies d'appel #sec_bd6da6ea
Une voie dit quel jeton REVIEWIT obtient pour l'identifiant : qui le délivre et pour quelle audience. Les adresses appelées figurent dans les appels de chaque ressource ; un chemin qui commence par « / » s'appelle sur l'audience du jeton de sa voie.
| Voie | Jeton délivré par | Audience du jeton | Authentification de l'identifiant |
|---|---|---|---|
| sp-onprem.server.reviewit.agent | aucun jeton : authentification Windows (Active Directory) du compte de service | https://{farm} | mot de passe du compte de service (Active Directory) |
Une voie sur site ne délivre aucun jeton : le compte de service s'authentifie par Windows (Active Directory) auprès du serveur, et c'est cette authentification que REVIEWIT constate.
Dans ces adresses, {farm} est l'adresse de la ferme SharePoint.
04SharePoint OnPremise · Sites #sec_35b75973
sp-onprem.sharepoint.sites:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie sp-onprem.server.reviewit.agent
Collections de sites de la ferme SharePoint et leurs attributions de rôle
{site} désigne l'adresse d'une collection de sites, telle que l'énumération la rend (Path).
Appels
- GET https://{farm}/_api/search/query?querytext='contentclass:STS_Site'&selectproperties='Title,Path,SiteId'&rowlimit=500 (énumération des collections de sites de la ferme)
- GET {site}/_api/site
- GET {site}/_api/web?$select=Id,Title,Url,Created,LastItemModifiedDate
- GET {site}/_api/web/roleassignments?$expand=Member,RoleDefinitionBindings
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | stratégie d'application web « Lecture totale » (Full Read) accordée au compte de service dans l'Administration centrale |
| Appartenance | requise | l'identifiant appartient à la ferme SharePoint de la connexion |
Conditions de fonctionnement
- le compte de service s'authentifie (authentification Windows, Active Directory)
- le service https://{farm} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| Id | clé de l'objet | entier | oui |
| Title | affiché pour reconnaître l'objet | texte | oui |
| Url | affiché pour reconnaître l'objet | texte | non |
| Owners | accès soumis à la revue | liste d'identités | non |
| Members | accès soumis à la revue | liste d'identités | non |
| Admin | accès soumis à la revue | liste d'identités | non |
| Guests | accès soumis à la revue | liste d'identités | non |
| Type | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastModified | contexte, sans effet sur la revue | date et heure | non |
| LastActivityDate | évalué par les politiques REVIEWIT (date de dernière activité) | date et heure | non |
| Size | contexte, sans effet sur la revue | entier | non |
05SharePoint OnPremise · Subsites #sec_8322202c
sp-onprem.sharepoint.subsites:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie sp-onprem.server.reviewit.agent
Sous-sites de la ferme SharePoint et l'héritage de leurs permissions
{site} désigne l'adresse d'une collection de sites (énumération de la ressource Sites) ; {web} celle d'un sous-site, telle que /_api/web/webs la rend (Url).
Appels
- GET {site}/_api/web/webs?$select=Id,Title,Url,HasUniqueRoleAssignments (récursif, pour chaque collection de sites, hors site racine)
- GET {web}/_api/web/roleassignments?$expand=Member,RoleDefinitionBindings
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | stratégie d'application web « Lecture totale » (Full Read) accordée au compte de service dans l'Administration centrale |
| Appartenance | requise | l'identifiant appartient à la ferme SharePoint de la connexion |
Conditions de fonctionnement
- le compte de service s'authentifie (authentification Windows, Active Directory)
- le service https://{farm} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| Id | clé de l'objet | entier | oui |
| Title | affiché pour reconnaître l'objet | texte | oui |
| Url | affiché pour reconnaître l'objet | texte | non |
| Owners | accès soumis à la revue | liste d'identités | non |
| Members | accès soumis à la revue | liste d'identités | non |
| Visitors | accès soumis à la revue | liste d'identités | non |
| Guests | accès soumis à la revue | liste d'identités | non |
| Type | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastModified | évalué par les politiques REVIEWIT (date de dernière activité) | date et heure | non |
| ParentId | contexte, sans effet sur la revue | texte | non |
| InheritsPermissions | contexte, sans effet sur la revue | booléen | non |
| Size | contexte, sans effet sur la revue | entier | non |
06Pour aller plus loin #sec_330f1291
- Comprendre une connexion de collecte
- Référence des droits par ressource
- Lire un verdict