Connecteur Sharepoint Online

Prérequis connecteur indexation

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

• 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

  

• 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) ✏️

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

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.

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.

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

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}/...

Configuration du connecteur

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

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.

Pour le multi site on récupère tous les sous sites.