Développement à l’aide des autorisations client avec application uniquement dans SharePoint Online

L’expérience du développeur a changé pour les compléments SharePoint hébergés par le fournisseur qui nécessitent une autorisation client avec application uniquement. Cet article vous guide dans la nouvelle expérience de développement et de débogage de ces solutions.

S’applique à : compléments hébergés par un fournisseur pour SharePoint Online

Comprendre le problème

Dans Visual Studio, accédez à Déboguer et démarrez le débogage : le message « Votre administrateur client doit approuver cette application », comme présenté ci-dessous, s’affiche.

Faites-vous confiance au dialogue du complément Mon client ?

La raison pour laquelle vous ne pouvez pas cliquer sur Approuver est que Visual Studio travaille actuellement sur la collection de sites de développement que vous avez spécifiée dans les paramètres de votre projet, mais les autorisations au niveau du client avec application uniquement ne peuvent être octroyées que via l’approbation sur votre site d’administration des clients.

Procédure pas à pas

Étape 1 : Créer un principal de service

Accédez à une collection de sites dans votre client, et générez un nouvel ID client et une clé secrète. (par exemple : https://contoso.sharepoint.com/_layouts/15/appregnew.aspx). Dans cette page, cliquez sur Générer pour les champs ID client et Clé secrète client, puis remplissez les champs restants. Pendant que vous développez le complément, assurez-vous d’utiliser localhost, ainsi que le port comme domaine d’application. Un écran semblable à celui ci-dessous s’affichera.

Créez un principal du service dans la page AppRegNew

Étape 2 : Accorder des autorisations client

Pour effectuer cette étape, vous devez être un administrateur SharePoint Online.

Accédez au Centre d’administration SharePoint (par exemple, https://contoso-admin.sharepoint.com/_layouts/15/appinv.aspx) et accordez les autorisations client

Spécifiez les autorisations de l’application avec XML

Dialogue de confiance de l’application confirmant les modifications d’autorisation

Étape 3 : Mettre à jour votre manifeste et web.config

Dans la solution Visual Studio, mettez à jour le manifeste et web.config avec l’ID client créé à l’étape 1.

Définir l’ID client de l’application dans web.config du complément

Étape 4 : Créer un package de l’application et ajouter le fichier .app au catalogue d’applications

Cliquez avec le bouton droit sur le projet de complément SharePoint et cliquez sur Publier.

Saisissez l’ID Client et la Clé secrète client créés à l’étape 1.

Définir l’ID client et la clé secrète dans la boîte de dialogue de l’identité du complément de l’application dans Visual Studio

Étant donné que vous voulez déboguer le complément, veuillez à fournir https://localhost, ainsi que le port comme présenté ci-dessous.

Définir l’emplacement de https://localhost pour le débogage

Déployez maintenant le complément dans le site de catalogue d’applications.

Étape 5 : Installer votre complément dans votre collection de sites du développeur.

Accédez au site du développeur et ajoutez l’application. Cliquez sur Détails de l’application.

Sélectionner le lien des détails de l’application sur l’application

Si vous avez sélectionné sur la vignette d’application, vous devez sélectionner sur « Découvrir pourquoi » et demander votre application

Demander l’application en terminant la boîte de dialogue

Une fois la demande envoyée, l’état sera « en attente » tant que l’administrateur SharePoint ou l’administrateur du catalogue d’applications n’aura pas approuvé la demande. Pour approuver la demande, accédez au catalogue d’applications, sélectionnez sur Demandes d’applications et approuvez la demande.

Capture d’écran illustrant la boîte de dialogue Approuver ou refuser la demande d’application

Une fois la demande acceptée, le complément peut désormais être installé.

Invite de la boîte de dialogue d’approbation de l’application

Étape 6 : Déboguer votre complément

Dans Visual Studio, cliquez avec le bouton droit sur votre projet Web et sélectionnez Déboguer, puis Démarrer une nouvelle instance. Une fois l’instance démarrée, accédez à votre site et lancez le complément.

Déboguer votre complément dans Visual Studio

Notes

  • Si, pour une quelconque raison, le fichier de votre package d’application est modifié, vous devez le redéployer dans le catalogue d’applications et le réinstaller sur votre collection de sites de développement.
  • Si votre complément est doté d’un récepteur d’événements appinstalled, vous devez vous assurer que vous avez effectué l’étape 6 avant d’exécuter l’étape 5.

Voir aussi