Configurer un connecteur SharePoint

💡 Ce cours ne décrit que ce qui est propre à ce connecteur. Pour la mécanique commune à tous les connecteurs — créer un connecteur, importer une ressource, planifier des mises à jour automatiques, suivre un import — consultez le cours Créer et gérer un connecteur de catalogue.

Pour importer des fichiers depuis SharePoint, le connecteur s'authentifie auprès de Microsoft Graph grâce à une application enregistrée dans votre annuaire Microsoft Entra ID. Vous devez donc, depuis le portail Azure, déclarer cette application et lui accorder un accès en lecture à vos sites SharePoint.

Connectez-vous au portail Azure, puis ouvrez la section Gérer Microsoft Entra ID en cliquant sur son bouton Vue.

Depuis la vue d'ensemble de l'annuaire, ajoutez une nouvelle application via le bouton Inscription d'application.

Donnez un nom à l'application [1], par exemple connecteur-data-fair, puis validez les conditions d'utilisation de la plateforme Microsoft en cliquant sur « S'inscrire » [2].

Une fois l'application créée, sa page Vue d'ensemble affiche les identifiants nécessaires à la configuration du connecteur :

1. l'ID d'application (client) ;
2. l'ID de l'annuaire (locataire).

La section Certificats & secrets [3], accessible depuis le menu de gauche, permet quant à elle de générer le secret client.

Dans l'onglet « Certificats & secrets » de l'application, générez un secret :

1. cliquez sur « Nouveau secret client » ;
2. saisissez une description et choisissez une durée de validité ;
3. copiez immédiatement la valeur du secret : elle ne sera plus jamais affichée une fois la page quittée.

Cette valeur est celle à renseigner dans le champ Secret client du connecteur.

Le connecteur a besoin d'un accès en lecture à vos sites SharePoint. Dans l'onglet « API autorisées » de l'application :

1. cliquez sur « Ajouter une autorisation », puis choisissez Microsoft Graph ;
2. sélectionnez le type « Autorisations d'application » (et non « Autorisations déléguées », l'application fonctionnant sans utilisateur connecté) ;
3. recherchez « Sites » et cochez l'autorisation « Sites.Read.All » (lecture sur tous les sites) ;
4. validez avec « Ajouter des autorisations ».

Selon la politique de votre organisation, un administrateur devra peut-être accorder le consentement de l'annuaire pour cette autorisation.

Vous disposez à présent des quatre informations nécessaires à la configuration du connecteur : l'ID d'application (client), le Secret client, l'ID de l'annuaire (locataire) et l'URL du site SharePoint.

Dans le formulaire de création du connecteur, renseignez les champs suivants :

1. l'ID d'application (client) : l'ID client de l'application enregistrée dans le portail Azure ;
2. le Secret client : la valeur du secret généré dans l'onglet « Certificats & secrets » de l'application ;
3. l'ID de l'annuaire (locataire) : accessible depuis Microsoft Entra ID ou la vue d'ensemble de l'application ;
4. l'URL du site ou du catalogue SharePoint auquel vous souhaitez accéder — visible dans la barre d'adresse de votre navigateur lorsque vous naviguez sur ce site (le préfixe https:// est facultatif).

Le champ Site ID n'est pas à renseigner : il est déduit automatiquement de l'URL du site lors de la création du connecteur.

À la création, la connexion au site SharePoint est testée avec les identifiants fournis : si l'un d'eux est invalide, ou si les autorisations accordées à l'application sont insuffisantes, la création est bloquée.

L'import des fichiers depuis SharePoint suit ensuite la mécanique commune à tous les connecteurs de catalogues distants : parcours des ressources disponibles, sélection, puis import. Retrouvez cette mécanique détaillée dans les autres cours de la liste, par exemple celui du connecteur SFTP.

Si vous avez des remarques sur ce cours, n'hésitez pas à nous les communiquer.