Passer au contenu principal
Cette page contient le guide de configuration et les informations de référence pour le connecteur source Microsoft SharePoint. Tutoriel Vidéo
Le connecteur source Microsoft SharePoint extrait les données d’une bibliothèque de documents SharePoint et d’un dossier spécifiés. S’il est configuré avec l’option récursive, il inclura tous les sous-dossiers dans la synchronisation. Tous les fichiers du dossier spécifié et des sous-dossiers seront pris en compte.

​
Prérequis

  • ID de Tenant - Identifiant du tenant Azure AD
  • ID Client - Identifiant de l’application Azure AD
  • Secret Client - Secret de l’application Azure AD
  • Nom du Site - Nom du site SharePoint
  • Chemin du Dossier - URL vers le dossier que vous souhaitez synchroniser

​
Guide de Configuration

Le connecteur source Microsoft SharePoint prend en charge l’authentification via le flux d’identifiants client OAuth au niveau de l’application (équivalent Microsoft à l’approche de compte de service de Google).

​
Étape 1 : Créer une Application Azure AD

  1. Connectez-vous au Portail Azure
  2. Cliquez sur l’icône de menu en haut à gauche et sélectionnez Azure Active Directory
  3. Sélectionnez Inscriptions d’applications
  4. Cliquez sur Nouvelle inscription
  5. Enregistrez une application :
    • Nom : Entrez un nom pour votre application
    • Types de comptes pris en charge : Sélectionnez Comptes dans ce répertoire organisationnel uniquement
    • Cliquez sur Inscrire
  6. Enregistrez l’ID d’application (client) et l’ID de répertoire (tenant) qui seront utilisés pour l’authentification

​
Étape 2 : Générer un Secret Client

  1. Depuis la page de votre application enregistrée, sélectionnez Certificats et secrets
  2. Cliquez sur Nouveau secret client
  3. Fournissez une description et sélectionnez une période d’expiration (par exemple, 1 an)
  4. Cliquez sur Ajouter
  5. IMPORTANT : Copiez immédiatement la valeur du secret client généré - vous ne pourrez plus la voir par la suite

​
Étape 3 : Attribuer les Permissions API

  1. Depuis la page de votre application enregistrée, sélectionnez Permissions API
  2. Cliquez sur Ajouter une permission
  3. Sélectionnez Microsoft Graph
  4. Sélectionnez Permissions d’application
  5. Ajoutez les permissions suivantes :
    • Sites.Read.All
    • Files.Read.All
  6. Cliquez sur Ajouter des permissions
  7. Cliquez sur Accorder le consentement administrateur pour [votre organisation] pour activer les permissions

​
Étape 4 : Configurer le Connecteur SharePoint dans l’Admin Paradigm

  1. Naviguez vers la section Datasource dans votre interface d’administration Paradigm
  2. Créez une nouvelle source de données de type SharePoint
  3. Ajoutez vos identifiants dans les champs requis :
    • tenant_id : Votre identifiant de tenant Azure AD
    • client_id : Votre identifiant d’application Azure AD
    • client_secret : Votre secret d’application Azure AD
    • site_name : Nom de votre site SharePoint
    Le nom du site est essentiellement le titre de votre site SharePoint
  4. Cliquez sur Nouvel import pour configurer une nouvelle configuration d’import.
    1. Dans les Critères de filtre, spécifiez les éléments suivants :
      • folder_path : Collez l’URL du dossier SharePoint que vous souhaitez synchroniser.
      // devrait ressembler à quelque chose comme ça :
<https://mysharepointtenant.sharepoint.com/sites/CommunicationSiteParadigmTest/Shared%20Documents/Forms/AllItems.aspx?id=%2Fsites%2FCommunicationSiteParadigmTest%2FShared%20Documents%2F0%20%2D%20Folder%20level%200&viewid=4ac924c4%2D7e2f%2D58ce%2D8d2b%2D96aedd9a5e25>
      (Pour synchroniser une bibliothèque de documents entière, définissez “root” dans le folder_path)
      • recursive : Activez ou désactivez la synchronisation des sous-dossiers (par défaut True)
    2. Espace de travail : Sélectionnez où les fichiers apparaîtront
    3. Fréquence : Définissez la fréquence de synchronisation
    4. Priorité : Définissez l’importance relative par rapport aux autres configurations d’import
  5. Cliquez sur ENREGISTRER et attendez que les tests se terminent.
Vous êtes prêt ! ✅

​
Fonctionnalités Clés du Connecteur SharePoint

​
Synchronisation Incrémentale

Le connecteur utilise l’API delta de Microsoft pour synchroniser efficacement uniquement les fichiers modifiés entre les exécutions. Cette approche :
  • Réduit les exigences de bande passante et de traitement
  • Capture tous les changements de fichiers (créations, mises à jour, suppressions)
  • Maintient l’état entre les exécutions de synchronisation via un jeton delta

​
Authentification et Accès

  • Utilise l’authentification au niveau de l’application (non spécifique à l’utilisateur)
  • Capture les changements effectués par tous les utilisateurs dans le site SharePoint
  • Gère automatiquement le renouvellement des jetons pour un fonctionnement continu

​
Limites et Considérations

  • Le connecteur respecte les limites de documents configurées (DATASOURCES_MAX_DOC_PER_IMPORT)
  • Vérifie les limites de taille de fichier avant la connexion (MAX_DOCUMENT_SIZE)
  • Filtre par types MIME pris en charge
  • L’option récursive détermine si les sous-dossiers sont inclus (par défaut oui)

​
Dépannage

Si vous rencontrez des problèmes de connexion :
  1. Vérifiez que toutes les identifiants (tenant_id, client_id, client_secret) sont corrects
  2. Assurez-vous que l’application a reçu le consentement administrateur pour les permissions requises
  3. Confirmez que le site_name est correct et accessible à l’application
  4. Vérifiez que le folder_path existe dans le site spécifié
  5. Pour des messages d’erreur spécifiques, consultez la page de session d'import pour des informations détaillées
Pour des problèmes persistants, veuillez contacter l’équipe de développement avec des messages d’erreur spécifiques et des horodatages.
⌘I