Connecteur Sharepoint Online

Configuration du connecteur

Le connecteur SharePoint Online permet de synchroniser les fichiers et documents stockés dans les bibliothèques d'un ou plusieurs sites SharePoint vers Wikit Semantics. L'accès se fait via une application enregistrée dans Azure AD, à laquelle est accordée une autorisation ciblée (Sites.Selected) sur le ou les sites SharePoint à synchroniser.

Nom du champ	Format / Type	Obligatoire	Commentaire
ID d'application (client)	Identifiant	✅	Identifiant de l'application Azure AD inscrite pour Wikit Connect, disponible sur la page "Vue d'ensemble" de l'inscription d'application
ID de l'annuaire (locataire)	Identifiant	✅	Identifiant du tenant Azure AD, disponible sur la même page "Vue d'ensemble"
Secret client	Mot de passe / Token	✅	Valeur du secret client généré dans "Certificats & secrets" (et non son id)
ID du site	Identifiant	✅	Identifiant du site SharePoint à synchroniser, récupéré via l'API _api/site/id
Chemins à inclure	Liste de textes	➖	Limite la synchronisation aux dossiers listés. Format attendu : Nom-de-la-bibliotheque/Nom-du-dossier
Chemins à exclure	Liste de textes	➖	Exclut les dossiers listés de la synchronisation. Format attendu : Nom-de-la-bibliotheque/Nom-du-dossier
Récupérer les dossiers système	Oui / Non	➖	À activer pour récupérer les dossiers de type pièces jointes. Par défaut, tous les dossiers système sont récupérés : il faudra exclure des chemins pour éviter de récupérer des fichiers inutiles

💡 Les champs marqués ✅ sont obligatoires pour que le connecteur puisse fonctionner.

Configuration à réaliser

Il est nécessaire d'avoir une application dans Azure et voici comment procéder :

1. Inscrire une application dans Azure

• se connecter avec un compte admin à https://x@x@x.azure.com
• dans la barre de recherche, tapez : inscription d'application
• vous arrivez sur un page comme ci-dessous :

• cliquez sur Nouvelle inscription

• renseignez un nom pour votre application, exemple : Wikit-sync-sharepoint puis valider

  

2. Noter l'ID d'application et l'ID de l'annuaire

Vous pouvez déjà noter les informations sur la page "Vue d'ensemble" qui seront à transmettre à votre contact Wikit :

• ID d'application (client) ✏️
• ID de l'annuaire (locataire) ✏️

3. Créer un secret client

Nous allons créer un secret pour votre application, qui sera à transmettre à votre interlocuteur chez Wikit.

Pour cela, cliquer sur Gérer puis sur "certificats & secrets", puis sur "Nouveau secret client", vous pouvez rajouter une description et gérer la date d'expiration.

⚠︎ Attention à bien noter la date de fin du secret, une fois ce token expiré la synchronisation de votre SharePoint ne pourra plus fonctionner, il faudra penser à partager le nouveau avec l'équipe Wikit avant l'expiration de celui-ci.

⚠︎ Attention à bien transmettre la valeur du secret et non l'id

4. Autoriser l'application à accéder à SharePoint (Sites.Selected)

Nous allons maintenant autoriser l'application à récupérer des informations sur votre SharePoint. Pour cela nous allons nous rendre dans "Api autorisées" et cliquer sur "ajouter une autorisation" puis "Autorisations d'application", chercher site et sélectionner "Sites.Selected" valider en cliquant sur "Ajouter des autorisations" enfin, vous pouvez "Accorder un consentement d'administrateur" en cliquant sur le bouton du même nom.

5. Cibler le site à partager avec Wikit via le Graph Explorer

Cette autorisation nécessite une configuration supplémentaire pour cibler le site à partager avec Wikit, pour cela, il va falloir faire une requête dans le graph explorer de Microsoft.

lien direct vers la requête ⇒ https://developer.microsoft.com/en-us/graph/graph-explorer

Il va falloir donner une autorisation supplémentaire à votre compte en cliquant sur "Consent to permissions".

⚠️ Le compte utilisé doit avoir un accès au SharePoint ciblé. Microsoft propose plusieurs autorisations Sites.Selected. Il faut être bien vigilant à ce que ce soit l'autorisation Dans Microsoft Graph et non SharePoint !

Chercher sites.FullControl.All et sur Consent.

Une fois qui vous avez les permissions nécessaires, vous pouvez changer les informations, dans l'URL siteId dans le body de la requête id et displayName.

⚠️ bien penser à changer {siteId} avec votre siteId

⚠️ remplacer dans l'encadré, id de votre application par l'id de votre application

	Methode: POST 
URL: "https://graph.microsoft.com/v1.0/sites/{siteId}/permissions"

Body: {
    "roles": [
        "read"
    ],
    "grantedToIdentities": [
        {
            "application": {
                "id": "id de votre application",
                "displayName": "API Wikit"
            }
        }
    ]
}

Vous pouvez enlever la permission sites.FullControl.All de votre compte.

6. Retrouver l'ID du site SharePoint

Pour récupérer l'id du site :

https://wikitai.sharepoint.com/sites/{slug-du-site}/_api/site/id

Le slug du site est disponible dans l'URL SharePoint quand on est sur celui-ci.

Voici un exemple :

https://wikitai.sharepoint.com/sites/{slug-du-site}/...

7. Transmettre les informations à l'équipe Wikit

Une fois toutes ces étapes faites, vous pouvez communiquer à l'équipe Wikit les informations suivantes :

• l'id de l'application
• l'id de l'annuaire (tenant)
• le secret
• l'id du site

8. Configurer les chemins à inclure/exclure dans Wikit Connect

Pour la configuration des champs : Chemins à inclure, Chemins à exclure, il faut utiliser le format Nom-de-la-bibliotheque/Nom-du-dossier.

Fonctionnement du connecteur

• Dossiers système : pour récupérer les dossiers type pièces jointes, il faut activer l'option "récupérer les dossiers système". ⚠️ Il faut faire attention, par défaut, on récupère tous les dossiers de type système, il faudra exclure des chemins pour éviter de récupérer des fichiers inutiles.
• Multi-site : pour le multi-site, on récupère tous les sous-sites.