Connecter des applications hébergées par un fournisseur à SharePoint Online

Comment connecter des applications hébergées par un fournisseur à SharePoint Online.

Auth0 peut grandement simplifier le processus d’authentification pour les applications SharePoint. Auth0 obtiendra un Jeton d’accès que vous pourrez ensuite utiliser pour appeler les API SharePoint.

Vous n’aurez besoin d’aucune bibliothèque spéciale. Vous pouvez utiliser n’importe lequel des SDK pris en charge par Auth0.

​

Étape 1. Enregistrez votre application dans Auth0

Enregistrez simplement une nouvelle application dans Auth0 comme vous le feriez normalement : Applications > NEW. Consultez l’un des SDK disponibles pour obtenir des instructions détaillées. Gardez le client_id à portée de main, car vous en aurez besoin à l’étape suivante.

​

Étape 2. Créez un package pour votre application

Vous devez obtenir un ID client et un Secret client pour votre application. Il existe plusieurs façons d’enregistrer votre application selon l’usage prévu.

Enregistrer des compléments SharePoint (Microsoft Docs) explique les différentes façons d’enregistrer votre application dans SharePoint. Dans cette étape du didacticiel, vous utiliserez la méthode la plus simple : l’auto-enregistrement dans un locataire précis (le vôtre).

​

Ouvrez SharePoint Online

L’URL du tableau de bord est la suivante : https://{your Office365 tenant}.sharepoint.com/_layouts/15/appregnew.aspx

​

Générez un ID client et un secret client :

​

Remplissez les informations dans le formulaire :

Puisqu’Auth0 se trouve entre votre application et l’infrastructure d’Office 365, vous devez utiliser cette URL pour l’application :

Domaine de l’application :

URI de redirection:

• connection est simplement le nom que vous utiliserez pour la connexion dans Auth0 (par exemple, “sharepoint”).
• client_id identifie votre application dans Auth0 (créée à l’étape 1).
• redirect_uri correspond à l’emplacement dans votre application où vos utilisateurs seront redirigés une fois le processus terminé. Si vous ne le précisez pas, ce sera toujours l’URL de rappel de l’application définie dans Auth0 (il peut s’agir de localhost)

​

Empaquetez l’application et téléversez-la dans SharePoint :

Remplissez les informations dans le manifeste de votre application dans Visual Studio :

Notez que le Query string sera exactement le même que le URI de redirection que vous avez saisi précédemment. Cliquez ensuite avec le bouton droit sur le projet, puis sélectionnez Publish :

Créez un profil de publication (vous devrez saisir le même ID client et le même Secret client obtenus dans le tableau de bord SharePoint).

Cliquez sur Package et téléversez le fichier obtenu dans SharePoint.

​

Étape 3. Créez la connexion dans Auth0

La dernière étape de l’intégration consiste à ajouter une connexion SharePoint dans Auth0.

Vous aurez besoin de :

• Connection Name. Il s’agit d’un nom arbitraire. Il doit correspondre à ce que vous avez saisi à l’étape 2.
• ID client & Secret client. Ils doivent aussi correspondre à ce que vous avez saisi à l’étape 2.
• Test SharePoint Site Url. Il s’agit de l’URL du site SharePoint utilisée pour tester la connexion (par exemple, lorsque vous cliquez sur le bouton « Try » dans le tableau de bord). Elle n’est jamais utilisée à l’exécution, car les utilisateurs suivront toujours le lien vers votre site depuis SharePoint.

Les utilisateurs installeront votre application à partir de l’Office Marketplace. Lorsqu’ils cliqueront sur le lien, ils seront redirigés vers Auth0, qui négociera le jeton d’accès pour vous, puis vers votre application. Votre application recevra un User Profile qui ressemblera à ceci :

Les propriétés suivantes seront incluses : cacheKey, refresh_token, host et site. Elles vous permettront d’appeler les API SharePoint (comme les listes).