Table of Contents

Connecteur SharePoint Online

Déposer dans SharePoint, par Microsoft Graph, le courriel et les pièces jointes de chaque dépôt.

Important

Exemple à adapter, non fonctionnel en l'état. Dans cette version, l'adresse Graph de la session de téléversement est mal formée (.../v1.0/sites{hôte}/..., sans barre oblique après sites) : le dossier est créé, puis le téléversement des fichiers échoue. Corrigez le connecteur, ou reprenez sa logique dans un gestionnaire, et testez-le avant tout usage.

Identifiant sharepoint
Adresse https://<serveur>/api/webhook/sharepoint

Réglages et secrets

Où Clé Effet
Connector:sharepoint SiteUrl Adresse du site. Seul son nom d'hôte est utilisé : le chemin du site est ignoré, et les fichiers vont dans la bibliothèque par défaut du site racine.
Connector:sharepoint DocumentLibrary Lue par aucun code dans cette version.
Connectors.sharepoint.Secrets TenantId, ClientId, ClientSecret Inscription d'application Microsoft Entra ID, avec un secret client.
Connectors.sharepoint.Secrets PrivateAESKey Obligatoire, au format <clé>_<IV> : la même que dans la configuration de SESAR. Le gabarit ne la prévoit pas à cet endroit. Sans elle, l'initialisation du connecteur échoue.

L'inscription d'application doit avoir une permission d'application Microsoft Graph sur les fichiers ou les sites, avec le consentement d'un administrateur. Choisissez la permission la plus restreinte qui convient, par exemple Sites.Selected avec un accès accordé au seul site cible.

Ce qu'il fait

  1. Il obtient un jeton pour Microsoft Graph (https://graph.microsoft.com/.default), par le flux d'identifiants client.
  2. Il crée un dossier nommé d'après l'objet du dépôt.
  3. Il lit le courriel du dépôt (EmailSent.html dans le dossier du dépôt sur le serveur de SESAR), en le déchiffrant au besoin avec PrivateAESKey, puis en fait un fichier EmailSent.eml qu'il téléverse.
  4. Il déchiffre chaque pièce jointe chiffrée par SESAR et la téléverse sous son nom d'origine, par blocs de 10 Mio.
  5. Il supprime les copies déchiffrées.

Le connecteur lit les fichiers aux chemins du manifeste : l'application doit tourner sur une machine qui a accès au stockage de SESAR.

Limites à corriger avant usage

  • L'adresse de la session de téléversement est mal formée.
  • Les réponses de Microsoft Graph ne sont pas vérifiées : le connecteur répond « Manifest Processed » même si un envoi a échoué.
  • Les blocs de téléversement se chevauchent d'un octet, ce qui compromet les fichiers de plus de 10 Mio.
  • En cas d'exception, les copies déchiffrées du courriel et des pièces jointes restent sur le disque du serveur de SESAR.
  • Le chemin du site et DocumentLibrary sont ignorés.

Tester

POST /api/connectors/sharepoint/test vérifie seulement qu'un jeton peut être obtenu, sans appeler SharePoint.