Configurer Microsoft 365 pour votre environnement
Il existe deux façons de connecter Microsoft 365 à votre environnement AI-School. Choisissez d’abord la voie qui convient à votre organisation.
| Voie | Quand | Ce que vous faites |
|---|---|---|
| Application centrale AI-School (par défaut) | Connexions personnelles avec Outlook Mail, Outlook Agenda, Teams et SharePoint/OneDrive. | Un administrateur Entra accorde le consentement organisationnel via Connecter Microsoft 365. Ensuite, vous autorisez les intégrations comme à l’étape 5 de cet article. Aucune application propre, secret client ni Identity Provider n’est nécessaire. |
| Votre propre application Entra | Vous voulez importer de façon centralisée des dossiers SharePoint dans la base de connaissances, vos collaborateurs se connectent déjà avec Microsoft via une application propre, ou vous voulez gérer vous-même l’application. | Suivez cet article à partir de l’étape 1. |
Si votre organisation se connecte déjà avec Microsoft via une application propre (le champ Microsoft ID de l’environnement est renseigné), alors toutes les connexions utilisent cette application propre. La voie centrale ne s’applique alors pas.
Votre propre application Entra
Avec une application Microsoft Entra propre, votre organisation peut utiliser la même application pour se connecter avec Microsoft et pour Outlook, Teams et SharePoint. Vous déterminez centralement quelles intégrations et actions d’écriture sont disponibles. Les utilisateurs activent ensuite seulement leurs connexions personnelles dans Préférences → Tools → Connexions.
Les intégrations personnelles fonctionnent avec les modèles pris en charge d’OpenAI, Claude, Gemini et Mistral. Le modèle choisi doit pouvoir utiliser des outils. Pour les connexions personnelles, l’accès suit les droits de l’utilisateur Microsoft connecté. Le consentement organisationnel n’inscrit pas automatiquement tous les collaborateurs et ne donne pas à l’IA un accès autonome à toutes les boîtes aux lettres. La base de connaissances SharePoint centrale utilise des droits d’application distincts et les droits de base de connaissances existants, comme décrit plus loin dans cet article.
De quoi avez-vous besoin ?
- Une organisation Microsoft 365 avec Microsoft Entra ID et des comptes ayant accès aux services souhaités.
- Un administrateur autorisé à enregistrer une application et à accorder le consentement organisationnel pour les droits Microsoft Graph choisis. Un rôle d’abonnement Azure ne suffit pas ; votre rôle Entra doit autoriser ce consentement.
- Des droits d’administration dans le bon environnement AI pour rendre les intégrations disponibles.
- Un administrateur de plateforme qui peut configurer le Microsoft Identity Provider pour cet environnement AI dans Google Cloud Identity Platform.
- Une app registration dans votre propre annuaire Microsoft, avec un secret client et les deux URL de redirection du bon branding.
La connexion avec Microsoft et l’accès aux données Microsoft sont deux fonctions distinctes. Une connexion Microsoft qui fonctionne ne signifie pas encore qu’Outlook, Teams ou SharePoint est configuré.
1. Enregistrez une seule application d’organisation
Ouvrez le centre d’administration Microsoft Entra et allez dans App registrations → New registration. Utilisez un nom reconnaissable, par exemple AI-School – nom_de_votre_organisation. Pour une organisation propre, choisissez Accounts in this organizational directory only (Single tenant).
Conservez les informations suivantes depuis Overview :
| Donnée | À quoi sert-elle ? |
|---|---|
| Directory (tenant) ID | L’annuaire Microsoft de votre organisation ; il ira dans le champ Microsoft ID de l’environnement AI. |
| Application (client) ID | L’application enregistrée ; elle ira dans le Microsoft Identity Provider. |
Ces deux IDs sont différents. Ne renseignez pas l’ID client ni l’ID de locataire Firebase dans Microsoft ID.
2. Configurez les bonnes URL de redirection
Allez dans Authentication → Add a platform → Web. Ajoutez pour votre branding les deux URL ci-dessous, exactement comme affichées. La première traite la connexion ; la seconde traite le consentement pour les intégrations de compte de travail.
| Branding | Se connecter avec Microsoft | Intégrations de compte de travail |
|---|---|---|
| AI-School | https://ai-school-pro.firebaseapp.com/__/auth/handler | https://europe-west1-ai-school-pro.cloudfunctions.net/completeConnectorOAuth |
| AI-Corporate | https://ai-corporate.firebaseapp.com/__/auth/handler | https://europe-west1-ai-corporate.cloudfunctions.net/completeConnectorOAuth |
| AI-Public | https://ai-public-pro.firebaseapp.com/__/auth/handler | https://europe-west1-ai-public-pro.cloudfunctions.net/completeConnectorOAuth |
Utilisez les URL du branding sur lequel votre environnement fonctionne. Le nom de votre organisation ou l’ID de locataire n’ont pas besoin d’être saisis dans ces URL. L’URL du site web, l’URL du tableau de bord et l’URL .web.app ne remplacent pas ces callbacks. Enregistrez-les comme Web, même si vous utilisez l’intégration depuis un navigateur. Vous n’avez pas besoin d’activer l’émission implicite de jetons ni le flux de client public pour cela.
3. Créez un secret client et attribuez des droits
Allez dans Certificates & secrets → Client secrets → New client secret. Choisissez une durée appropriée et conservez la Value en lieu sûr dès qu’elle est visible. Transmettez la valeur via le canal sécurisé convenu pour la gestion de la plateforme ; le Secret ID n’est pas le secret client. Surveillez la date d’expiration et remplacez le secret avant cette date, y compris dans le Identity Provider.
Ensuite, allez dans API permissions → Add a permission → Microsoft Graph → Delegated permissions. N’ajoutez que les droits correspondant aux intégrations et actions que votre organisation proposera.
| Intégration | Droits de lecture | Droits supplémentaires pour l’écriture |
|---|---|---|
| Profil / base | User.Read; le flux de connexion demande aussi openid, profile, email et offline_access | Aucun |
| Outlook Mail | Mail.Read | Brouillons : Mail.ReadWrite. Envoi : Mail.Send. |
| Outlook Agenda | Calendars.Read | Écriture : Calendars.ReadWrite. |
| Microsoft Teams | Chat.Read, ChannelMessage.Read.All | Publication : Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send. |
| SharePoint / OneDrive | Sites.Read.All, Files.Read.All | Cette intégration de compte de travail n’offre pas d’actions d’écriture ici. |
Mail.ReadWrite ne donne pas le droit d’envoyer ; pour cela, Mail.Send est nécessaire séparément. La publication Teams écrit des messages texte dans un canal Teams choisi, pas des messages de chat privé. Pour cette intégration, utilisez Delegated permissions, pas Application permissions. Même pour les droits avec All dans le nom, l’accès délégué reste limité par les droits de l’utilisateur.
Cliquez sur Grant admin consent for votre organisation et vérifiez que les droits choisis apparaissent comme accordés. Ainsi, les collaborateurs peuvent utiliser l’accès approuvé sans devoir accorder eux-mêmes des droits organisationnels. Microsoft peut toutefois encore demander une nouvelle connexion, MFA ou un nouveau consentement, selon votre politique.
4. Reliez l’application à l’environnement AI à deux endroits
Demandez à l’administrateur de plateforme de sélectionner le bon environnement et d’effectuer ces réglages :
- Dans Admin → Environnement → Tenant : activez la méthode de connexion Microsoft et saisissez le Directory (tenant) ID dans Microsoft ID.
- Dans Google Cloud → Identity Platform → le tenant concerné → Identity providers → Microsoft : activez le provider et saisissez l’Application (client) ID ainsi que la Value du secret client de la même application Entra.
Le Identity Provider appartient au tenant Firebase/Identity Platform de votre environnement AI, pas à une autre organisation ni à l’environnement Admin général. L’intégration de compte de travail réutilise l’application de ce provider. Le secret client ne doit pas figurer dans les préférences utilisateur, les messages de chat ni les champs d’environnement ordinaires.
Fournissez à l’administration de plateforme le nom de l’organisation, le branding, le Directory ID, le client ID, la valeur du secret via le canal sécurisé, la date d’expiration et les intégrations/droits souhaités. Un ID d’application seul ne suffit pas.
5. Autorisez les intégrations et actions d’écriture
Ouvrez environnement d’administration de votre organisation → Tools → MCP. Activez l’intégration Microsoft 365 dans Suite-snelkoppelingen. Les lignes Microsoft deviennent visibles ; lorsque toute la suite est désactivée, ces lignes restent masquées.
Choisissez pour chaque intégration si elle est disponible. Dans la colonne Schrijfacties, choisissez séparément :
- Outlook Mail → Concepten : créer et modifier des brouillons.
- Outlook Mail → Verzenden : envoyer effectivement un brouillon existant.
- Outlook Agenda → Schrijven : créer et modifier des rendez-vous.
- Microsoft Teams → Posten : publier des messages texte dans un canal Teams choisi.
Cliquez sur Opslaan. Une action d’écriture ne fonctionne que si l’intégration et le droit d’administration correspondant sont tous deux activés, que Microsoft a accordé les droits nécessaires et que l’utilisateur a personnellement activé la connexion. L’utilisateur ne reçoit aucun formulaire supplémentaire de droits d’écriture pour cela.
Les réglages doivent aussi être pris en charge par le backend de votre branding. Cette extension d’écriture a été publiée et testée de manière ciblée le 7 octobre 2026 pour OnderwijsSupport sur AI-Corporate. Cela ne signifie pas automatiquement que la même extension est déjà disponible pour AI-School, AI-Public ou tout autre environnement. Demandez une confirmation à l’administration de plateforme lorsque les actions d’écriture sont absentes.
6. Vérifiez la configuration
Demandez à un utilisateur de se connecter au bon environnement AI et d’activer l’intégration souhaitée selon Utiliser les intégrations Microsoft. Vérifiez que Microsoft affiche le nom de votre propre application Entra.
Testez d’abord un brouillon reconnaissable et un rendez-vous sans participants. Vérifiez les éléments enregistrés dans Outlook. Testez ensuite l’envoi avec un destinataire de test convenu et la publication Teams dans un canal de test convenu. Un rendez-vous avec participants peut envoyer des invitations ou des mises à jour. Une commande d’envoi acceptée n’est pas encore une livraison confirmée.
Lors d’une extension des droits, la connexion tente de renouveler les jetons. Si Microsoft exige une nouvelle connexion ou un nouveau consentement, demandez à l’utilisateur de reconnecter la connexion existante. Il n’est pas nécessaire de créer une deuxième application ni un réglage utilisateur séparé.
Dépannage
| Problème | Vérification |
|---|---|
AADSTS50011 / mismatch de redirection | Les deux callbacks doivent être enregistrés exactement comme Web, pour le bon branding. |
| Un autre nom d’application apparaît au consentement | Le bon environnement AI, le Directory ID et le Microsoft Identity Provider spécifique au tenant ; reconnectez ensuite. |
| La connexion fonctionne, mais pas l’intégration | Vérifier aussi le callback du connecteur, les droits Graph et le consentement organisationnel. |
| La lecture fonctionne, l’écriture non | Vérifier le droit d’administration, le droit Graph délégué correspondant, le consentement accordé et la disponibilité du backend. |
| Secret client invalide ou expiré | La Value, pas le Secret ID ; mettre aussi à jour le nouveau secret dans le Identity Provider. |
| L’intégration est absente chez l’utilisateur | Vérifier la disponibilité dans Tools, les droits utilisateur pour les connexions et l’environnement AI sélectionné. |
Plus d’informations
- Gérer les Tools
- Utiliser les intégrations Microsoft
- Microsoft : enregistrer une application
- Microsoft : URL de redirection
- Microsoft Graph : vue d’ensemble des droits
Base de connaissances SharePoint centrale : configurer Microsoft
Un dossier lié de façon centralisée fonctionne via l’application d’organisation, sans que chaque collaborateur active une connexion SharePoint personnelle. Pour cela, deux consentements distincts sont nécessaires : un droit d’application avec consentement admin, et un grant read sur exactement le dossier (ou le site) que l’application peut lire. Une connexion Microsoft fonctionnelle ou le seul consentement admin ne donne pas encore accès.
Il existe deux méthodes. Choisissez une méthode par dossier lié ; l’environnement AI ne bascule jamais automatiquement vers l’autre.
| Grant de dossier (recommandé) | Grant de site | |
|---|---|---|
| Droit d’application | Files.SelectedOperations.Selected | Sites.Selected |
| Grant sur | Le dossier choisi dans une bibliothèque de documents | L’ensemble du site |
| Ce que l’application peut lire | Ce dossier et les sous-dossiers qui héritent du grant | Toutes les bibliothèques et tous les dossiers du site |
| Organisation SharePoint existante | Conservée ; pas besoin d’un site distinct | De préférence un site distinct pour les connaissances partagées |
| Conséquence dans SharePoint | L’héritage des autorisations du dossier est rompu (voir ci-dessous) | Aucune conséquence sur l’héritage |
1. Vérifiez l’application d’organisation
Utilisez la même single-tenant app registration que pour la connexion Microsoft dans votre environnement AI. Une application existante peut être étendue ; une deuxième application d’intégration n’est pas nécessaire. Vérifiez dans Microsoft Entra → App registrations → votre app → Overview le Directory (tenant) ID et l’Application (client) ID. Utilisez ci-dessous l’ID client, pas l’Object ID.
Le Directory ID doit se trouver dans Admin → Environnement → Tenant → Microsoft ID. L’ID client et la Value d’un secret client valide doivent se trouver dans le Microsoft Identity Provider de cet environnement AI précis. Cette configuration est gérée par l’administration de plateforme. Un secret expiré empêche également l’import central ; surveillez la date d’expiration et remplacez le secret à temps.
La connexion serveur centrale utilise client_credentials et ne demande pas d’URL de redirection supplémentaire. Les redirections Web existantes pour la connexion et les intégrations personnelles de compte de travail restent nécessaires ; utilisez les URL propres au branding du tableau précédent de cet article.
2. Ajoutez le droit d’application et accordez le consentement admin
- Ouvrez API permissions → Add a permission → Microsoft Graph → Application permissions.
- Recherchez Files.SelectedOperations.Selected (grant de dossier) ou Sites.Selected (grant de site), sélectionnez le droit et cliquez sur Add permissions.
- Demandez à un administrateur Entra habilité d’exécuter Grant admin consent for votre organisation.
- Vérifiez que le droit, type Application, apparaît comme accordé.
L’application de base de connaissances n’a besoin que de droits de lecture. Ne lui attribuez pas le droit d’application Sites.Read.All, Files.Read.All, Sites.ReadWrite.All, Files.ReadWrite.All ou Sites.FullControl.All. De tels droits larges donnent accès en dehors du dossier choisi et masquent un grant de dossier manquant ou révoqué. Si vous choisissez le grant de dossier, supprimez aussi un Sites.Selected ajouté auparavant ainsi que le grant de site associé, afin que le grant de dossier soit la seule limite. La liste des sources dans AI-School avertit lorsque l’application dispose de tels droits supplémentaires.
Les droits délégués pour les connexions personnelles Outlook, Teams et SharePoint peuvent rester sur la même application. Ils ne remplacent pas le droit d’application pour la base de connaissances centrale.
3. Donnez à l’application un accès en lecture au dossier ou au site
Cette action d’administration peut se faire avec Microsoft Graph Explorer. Utilisez un compte administrateur dans le même annuaire Microsoft, avec SharePoint Administrator ou un rôle administratif supérieur approprié et l’accès au site concerné. Un rôle d’abonnement Azure ou la simple propriété de l’application ne suffit pas.
- Connectez le compte administrateur à Graph Explorer et vérifiez l’organisation affichée.
- Ouvrez votre menu de profil → Consent to permissions, recherchez Sites.FullControl.All et choisissez Consent. Il s’agit d’un droit d’administration delegated permettant à Graph Explorer de gérer les grants ; ne l’ajoutez pas comme droit d’application sur l’application de base de connaissances. Utilisez un consentement lié au compte lorsque le consentement organisationnel pour tous les utilisateurs n’est pas nécessaire.
- Recherchez l’ID du lecteur (drive ID) et l’ID d’élément (item ID) du dossier. Dès que l’URL du dossier est saisie, le formulaire de liaison d’AI-School affiche la requête GET prête à l’emploi. Vous pouvez aussi la composer vous-même : encodez l’URL du dossier en base64url (sans
=à la fin) et faites-la précéder deu!.
GET https://graph.microsoft.com/v1.0/shares/u!GECODEERDE-MAP-URL/driveItem?$select=id,name,webUrl,parentReference
Dans la réponse, id est l’ID d’élément du dossier et parentReference.driveId est l’ID du lecteur de la bibliothèque (commence par b!). Vérifiez name et webUrl : il doit s’agir du dossier que vous souhaitez partager. Si la requête de partage ne fonctionne pas, utilisez la bibliothèque et le chemin :
GET https://graph.microsoft.com/v1.0/sites/uworganisatie.sharepoint.com:/sites/uwsite:/drives?$select=id,name,webUrl
GET https://graph.microsoft.com/v1.0/drives/DRIVE-ID/root:/Pad/Naar/Map?$select=id,name,webUrl
- Vérifiez d’abord les grants existants sur le dossier. Si votre client ID s’y trouve déjà avec le rôle
read, vous n’avez pas besoin de créer un deuxième grant.
GET https://graph.microsoft.com/v1.0/drives/DRIVE-ID/items/MAP-ID/permissions
- Si le grant est absent, choisissez POST sur la même adresse et saisissez dans Request Body le JSON suivant.
CLIENT-ID-VAN-UW-APPest l’Application (client) ID de votre application d’intégration, pas l’application Graph Explorer. Utilisez uniquement le rôleread.
{
"roles": ["read"],
"grantedToV2": {
"application": {
"id": "CLIENT-ID-VAN-UW-APP"
}
}
}
- Choisissez Run query. Un ajout réussi renvoie 201 Created. Vérifiez dans la réponse le rôle
readet l’ID client, et conservez l’ID d’autorisation (id) pour un contrôle ou une révocation ultérieurs. - Répétez cela uniquement pour chaque autre dossier que vous souhaitez volontairement relier. Chaque dossier relié a son propre grant.
Microsoft rompt l’héritage des autorisations sur le dossier sur lequel vous placez un grant d’application. Les autorisations utilisateur existantes du dossier sont copiées à ce moment-là, mais les modifications ultérieures des autorisations du site ou de la bibliothèque parent ne s’appliquent plus automatiquement à ce dossier. Après l’attribution, vérifiez donc les autorisations utilisateur du dossier et gérez-les désormais sur le dossier lui-même. Tenez compte de la limite Microsoft d’autorisations uniques par bibliothèque. Ne rétablissez pas l’héritage des autorisations sur le dossier : le grant de l’application disparaîtrait aussi.
Sous-dossiers et fichiers avec leurs propres autorisations. Les sous-dossiers et fichiers qui héritent des autorisations du dossier choisi sont couverts par le grant. Si un sous-dossier ou un fichier a ses propres autorisations (héritage rompu) sans l’application, celle-ci ne peut pas le lire. AI-School ignore entièrement un tel sous-dossier et en indique le nombre dans la liste des sources ; les documents qui en avaient été importés auparavant sont retirés. Un dossier voisin ou une autre bibliothèque n’est jamais lisible.
Grant de site (alternative)
Si vous utilisez Sites.Selected, recherchez l’ID du site avec GET https://graph.microsoft.com/v1.0/sites/uworganisatie.sharepoint.com:/sites/uwsite?$select=id,displayName,webUrl, vérifiez les grants existants avec GET .../sites/SITE-ID/permissions et, si nécessaire, ajoutez le grant avec POST sur la même adresse :
{
"roles": ["read"],
"grantedToIdentities": [
{
"application": {
"id": "CLIENT-ID-VAN-UW-APP",
"displayName": "NAAM-VAN-UW-INTEGRATIE-APP"
}
}
]
}
Un grant de site donne à l’application un accès en lecture à l’ensemble du site. AI-School n’importe que le dossier choisi, mais ce filtre n’est pas une limite d’autorisation Microsoft.
4. Reliez le dossier et vérifiez le résultat
Ouvrez Gestion → Base de connaissances → Ajouter → Dossiers SharePoint → Relier un dossier. Saisissez la vraie URL du dossier, depuis la barre d’adresse de la bibliothèque ou de OneDrive (pas un lien d’invitation), et, sous Accès Microsoft de l’application de l’organisation, choisissez l’autorisation de dossier (grant de dossier) ou l’autorisation de site (grant de site). Pour un grant de dossier, saisissez l’ID du lecteur et l’ID d’élément de l’étape 3. AI-School ne lit alors que ce dossier et vérifie que l’URL du dossier correspond aux ID ; en cas d’écart, la liaison est refusée. Un dossier dans OneDrive for Business peut aussi être relié, mais il appartient à un seul collaborateur : si ce collaborateur part, le dossier disparaît, et avec lui la source de connaissances. Pour des connaissances durables, utilisez de préférence un site SharePoint. Choisissez la portée, le public cible et le statut de publication selon le guide de la base de connaissances.
Vérifiez avec Actualiser que les documents ont été traités sans erreur. Utilisez Synchroniser maintenant pour un nouveau contrôle, puis posez une question de chat concrète sur un document importé. Vérifiez que la réponse mentionne la bonne source centrale de connaissances.
Le grant détermine quel dossier l’application peut lire. Les utilisateurs qui reçoivent les documents importés sont déterminés par les droits de la base de connaissances dans AI-School (école, public cible, services). Les droits SharePoint individuels ne sont pas repris. Ne reliez donc un contenu restreint de section ou d’équipe qu’avec un public cible de base de connaissances tout aussi restreint.
5. Révoquer le grant
Supprimez le grant avec DELETE sur https://graph.microsoft.com/v1.0/drives/DRIVE-ID/items/MAP-ID/permissions/PERMISSION-ID (grant de site : .../sites/SITE-ID/permissions/PERMISSION-ID). La révocation du consentement admin bloque l’application pour tous les grants à la fois.
Lors du contrôle suivant, AI-School n’a plus accès au dossier. Tous les documents de cette source ne sont alors plus proposés, y compris dans les réponses du chat, et la liste des sources indique que Microsoft refuse l’accès. Cela ne se produit pas immédiatement : le contrôle automatique s’exécute toutes les 15 minutes pour 20 sources au maximum par cycle ; avec davantage de sources, cela prend donc plus de temps. Utilisez Synchroniser maintenant ou Déconnecter pour un effet immédiat. Il en va de même pour un dossier déplacé ou supprimé.
| Problème | Vérification côté Microsoft |
|---|---|
| La connexion fonctionne, mais pas le dossier central | Le droit d’application doit être de type Application et disposer du consentement admin ; vérifiez aussi le grant distinct sur le dossier ou le site. |
| « Microsoft refuse l’accès au dossier » | Bon annuaire Microsoft, ID du lecteur, ID du dossier, client ID et grant read ; le dossier a-t-il été déplacé, supprimé ou remis en héritage des autorisations ? |
| Liaison refusée alors que le grant existe | L’URL du dossier ne correspond pas aux ID saisis. Copiez à nouveau l’URL depuis la bibliothèque et vérifiez webUrl dans la réponse Graph. |
| Avertissement concernant des droits supplémentaires | Supprimez les droits d’application larges et, pour un grant de dossier, Sites.Selected avec le grant de site. |
| Sous-dossiers ignorés | Ces sous-dossiers ont leurs propres autorisations sans l’application. Faites-leur hériter des autorisations ou accordez-leur volontairement leur propre grant read. |
403 lors de l’action d’administration dans Graph Explorer | Sites.FullControl.All délégué, consentement accordé, rôle d’administrateur et accès au site. N’ajoutez pas de droit large à l’application d’intégration comme solution. |
| « L’application de l’organisation n’a pas pu se connecter à Microsoft » | Demandez à l’administration de plateforme de mettre à jour la nouvelle Value du secret dans le bon Microsoft Identity Provider ; vérifiez le consentement admin. |
Pour OnderwijsSupport sur AI-Corporate, la connexion centrale avec grant de site a été publiée et testée le 14 octobre 2026. Le grant de dossier est disponible dès que la version concernée est publiée. La disponibilité sur AI-School, AI-Public ou un autre environnement doit être confirmée par l’administration de plateforme.
Documentation Microsoft : Selected permissions, ajouter un grant sur un dossier, encoder une URL de partage et ajouter un grant de site.