Pour indexer et sĂ©curiser correctement les contenus SharePoint et OneDrive dans Outmind, certaines permissions Microsoft Graph doivent ĂȘtre accordĂ©es au connecteur.
Ces permissions sont des permissions dâapplication (Application permissions).
Elles doivent donc ĂȘtre validĂ©es par un administrateur du tenant Microsoft 365.
đ Que sont les permissions dâapplication ?
Contrairement aux permissions dĂ©lĂ©guĂ©es classiques (liĂ©es Ă un utilisateur connectĂ©), les permissions dâapplication permettent Ă Outmind dâaccĂ©der aux ressources du tenant de maniĂšre sĂ©curisĂ©e et automatisĂ©e.
đ Elles ne sont pas liĂ©es Ă un compte Microsoft particulier.
Elles permettent notamment :
de lire et découvrir les sites SharePoint
de lire et télécharger les documents et leurs métadonnées
de reconstruire les permissions dâaccĂšs des utilisateurs et groupes pour chaque document
Ces permissions sont indispensables pour garantir que les droits appliqués dans Outmind reflÚtent correctement ceux définis dans Microsoft 365.
đ Permissions requises
Sites.Read.All
RĂŽle
Cette permission permet Ă Outmind de lire les contenus SharePoint du tenant.
Elle est utilisée pour :
lire la liste des sites SharePoint
lire les drives/document libraries associés
suivre les modifications via les endpoints delta
récupérer les permissions appliquées aux fichiers et dossiers
Endpoints utilisés
/sites/sites/{site_id}/drives/drives/{drive_id}/root/delta/drives/{drive_id}/items/{item_id}/permissions
Pourquoi cette permission est nécessaire
Sans cette permission :
les sites SharePoint ne peuvent pas ĂȘtre listĂ©s
les documents ne peuvent pas ĂȘtre indexĂ©s
les synchronisations delta ne fonctionnent pas
les permissions des fichiers ne peuvent pas ĂȘtre reconstruites
đ Cette permission est donc indispensable au fonctionnement du connecteur SharePoint.
Group.Read.All
RĂŽle
Cette permission permet de résoudre les groupes Microsoft 365 / Azure AD utilisés dans les permissions SharePoint.
LorsquâOutmind rĂ©cupĂšre les permissions dâun fichier ou dossier, Microsoft Graph peut retourner une entitĂ© de groupe reprĂ©sentĂ©e par un groupId.
Outmind doit ensuite interroger Microsoft Graph pour récupérer les identifiants de sécurité associés au groupe.
Endpoint utilisé
/groups/{groupId}
Données récupérées
Notamment :
securityIdentifieronPremisesSecurityIdentifier
Pourquoi cette permission est nécessaire
Les permissions SharePoint sont souvent attribuĂ©es via des groupes plutĂŽt quâutilisateur par utilisateur.
đ Sans cette permission, Outmind ne peut pas reconstruire correctement les droits dâaccĂšs hĂ©ritĂ©s des groupes Azure AD / Microsoft 365.
User.Read.All
RĂŽle
Cette permission permet de résoudre les utilisateurs présents dans les permissions SharePoint.
Lorsquâune permission contient un userId, Outmind doit rĂ©cupĂ©rer les informations associĂ©es Ă cet utilisateur.
Endpoint utilisé
/users/{userId}
avec le select suivant :
?$select=businessPhones,displayName,familyName,givenName,id,jobTitle,mail,mobilePhone,preferredLanguage,officeLocation,securityIdentifier,surname,userPrincipalName,onPremisesSecurityIdentifier
Données récupérées
Notamment :
displayNamemailuserPrincipalNamesecurityIdentifieronPremisesSecurityIdentifier
Pourquoi cette permission est nécessaire
đ Cette permission permet dâassocier correctement les permissions SharePoint aux utilisateurs Microsoft 365 concernĂ©s.
Sans cela, les droits utilisateurs ne peuvent pas ĂȘtre reconstruits correctement dans Outmind.
đĄïž SĂ©curitĂ© et pĂ©rimĂštre dâaccĂšs
Outmind utilise ces permissions uniquement pour :
indexer les contenus SharePoint autorisés
reconstruire les permissions dâaccĂšs
synchroniser les modifications des documents
appliquer la sécurité documentaire dans la recherche et les assistants IA
đ Les permissions rĂ©cupĂ©rĂ©es servent exclusivement au contrĂŽle dâaccĂšs des contenus indexĂ©s.
đ Synchronisation des permissions
Lors des synchronisations delta, Outmind :
détecte les nouveaux contenus ou modifications
récupÚre les permissions du fichier ou dossier
résout les utilisateurs et groupes associés
met Ă jour les droits dâaccĂšs dans lâindex
Cela garantit que :
un utilisateur ne voit que les documents auxquels il a accĂšs dans Microsoft 365
les changements de permissions sont répercutés automatiquement
đ Documentation Microsoft
Référence générale des permissions
Microsoft Graph permissions reference https://learn.microsoft.com/en-us/graph/permissions-reference
Documentation des endpoints utilisés
Get drive item permissions https://learn.microsoft.com/en-us/graph/api/driveitem-list-permissions?view=graph-rest-1.0&tabs=http
