L'objectif de ce document est de faire apparaître une icône épinglée sur la barre de navigation de l'application Microsoft Teams pour un site SharePoint que nous souhaitons mettre à la disposition de tous les utilisateurs de Teams ou de personnes spécifiques. Peu importe qu'ils soient membres d'une équipe ou d'un canal. La solution fournira aux nouveaux utilisateurs un accès au propre portail d'un client pour la formation des équipes avant même qu'ils aient rejoint ou créé leur première équipe.
1 Contrôles de l'application Teams dans la console d'administration
2 Contrôler qui peut télécharger des applications personnalisées
3 Vérification des politiques appliquées à un utilisateur
4 Contrôle des autorisations pour les applications Teams
5 Création de l'application
6 Tester l'application
7 Emballage de l'application
8 Téléchargement de l'application
9 Mise à disposition de l'application
10 Solution finale
Contrôles de l'application Teams dans la console d'administration
Les applications apparaissant dans la barre d'applications Teams sont contrôlées à partir de la console d'administration Teams dans le locataire. Applications Teams > Configurer les politiques.
Attention ! Ne pas préparer correctement votre locataire à l'avance pour télécharger une application personnalisée entraînera le message suivant plus loin dans ce document.
Attention ! Ne pas préparer votre locataire à autoriser uniquement certaines personnes à télécharger des applications personnalisées permettra à tout le monde de télécharger des applications dans votre magasin d'applications.
Contrôler qui peut télécharger des applications personnalisées
- Sur la page Stratégies de configuration d'application, créez une nouvelle stratégie personnalisée.
Nous avons choisi le nom " Politique de téléchargement d'applications ", mais vous pouvez tous utiliser ce qui a du sens. Dans la nouvelle politique, activez la possibilité de télécharger des applications personnalisées si votre identifiant d'utilisateur est attribué à cette politique.
- Ignorez tous les autres paramètres et cliquez sur « Enregistrer »
- Sur l'écran de la politique, sélectionnez la nouvelle politique et cliquez sur " Gérer les utilisateurs "
- Sur la page Utilisateurs gérés, saisissez les noms des utilisateurs auxquels vous souhaitez attribuer cette stratégie.
- Tous les utilisateurs qui ne font pas partie de cette politique obtiendront l'erreur suivante en tentant de télécharger une application.
Attention ! Après avoir enregistré ces paramètres de stratégie, leur mise en vigueur peut prendre des heures.
Vérification des politiques appliquées à un utilisateur
- Accédez à l'onglet " Utilisateurs " dans le centre d'administration Teams
- Recherchez un utilisateur auquel vous venez d'appliquer la stratégie à l'étape précédente, puis cochez la case à côté de l'utilisateur. Cela vous permettra de voir combien de politiques s'appliquent à cet utilisateur.
- Vous pouvez ensuite sélectionner l'option « Modifier les paramètres » pour modifier les paramètres de stratégie de l'utilisateur.
- Localisez l' option " Politique de configuration de l'application " et cliquez sur le menu déroulant.
- Vous verrez toutes les politiques de configuration d'application actuelles contrôlant l'accès de cet utilisateur aux applications Teams.
Contrôle des autorisations pour les applications Teams
- Dans la console d'administration Teams, recherchez l' onglet " Politiques d'autorisations " sous " Applications Teams ".
- Cliquez sur le bouton « Paramètres de l'application à l'échelle de l'organisation » pour vérifier les autorisations actuelles d'utilisation des applications Teams dans votre locataire.
Attention ! Si l'administrateur de votre locataire a défini les options ci-dessous en vert sur " Désactivé ", vous ne pouvez pas mener à bien cette mission de documents consistant à ajouter et à utiliser une application personnalisée dans Teams.
- Ensuite, nous devons vérifier l'autorisation de l'application au niveau de la politique si les paramètres précédents semblaient être activés.
- Dans les " Politiques d'autorisation d'application ", sélectionnez la " Politique globale (par défaut à l'échelle de l'organisation) pour ses paramètres en cochant la politique et en cliquant sur " Modifier "
- Le meilleur scénario est que la case en vert est définie sur toutes les applications et que les utilisateurs sont en dessous de cette politique. C'est la valeur par défaut et aucune autre politique ne les empêche d'accéder à ces paramètres.
Avertissement! Si l'administrateur a modifié l'autorisation des applications par défaut à autre chose que " Autoriser toutes les applications ", nous devrons ajouter notre application personnalisée à la fin de ce document et l'application " Teams Apps Studio " depuis le début pour leur permettre d'être vus par les utilisateurs dans Teams.
- À ce stade, notre application de portail n'a pas été créée, nous ne pouvons donc pas la mettre sur liste blanche tant que nous n'avons pas terminé les étapes de ce document et téléchargé l'application personnalisée dans le catalogue d'applications de locataire.
- Assurez-vous de sauvegarder toutes les modifications que vous avez apportées et de laisser le temps aux modifications de politiques de prendre effet.
Création de l'application
Maintenant que nos politiques d'application et d'autorisations sont préparées, nous sommes prêts à créer l'application personnalisée pour afficher l'icône liée à notre portail SharePoint dans la barre de navigation de l'application Teams.
- Connectez-vous à la version Web de Teams ou à la version de bureau en tant qu'utilisateur que nous avons ajouté à la « Politique de téléchargement d'application »
- Dans Teams, cliquez sur l'icône App Store dans la barre de navigation de l'application à gauche de Teams.
- Lorsque le magasin s'ouvre, tapez " App Studio " pour localiser l'application que nous devons installer pour que cet utilisateur crée notre application personnalisée.
- Cliquez sur le bouton " Ajouter " pour installer l'application
- Après l'ouverture de l'application App Studio, cliquez sur " Manifest Editor "
- Dans l'onglet de l'éditeur de manifeste, recherchez « Créer une nouvelle application »
- Ensuite, vous verrez l'écran suivant avec de nombreux champs que nous devons remplir. Nous les prendrons une section à la fois.
- Détails de l'application Attention ! Ne mettez pas « Microsoft » dans le nom. Si vous rendez le " nom court " trop long, il sera tronqué et affichera une ellipse à côté du nom.
Dans la section d'identification, vous devez cliquer sur le bouton « Générer » pour générer une clé unique pour cette application. Vous devez renseigner le « Nom du package ». Vous pouvez utiliser n'importe quel nom en suivant simplement le format indiqué ci-dessus. La « version » doit également être définie.
- Descriptif Attention ! Ne mettez pas « Microsoft » dans le nom
- Informations sur le développeur
Les informations sur le développeur identifient simplement qui a créé l'application et un site Web pour en savoir plus sur le développeur. Je suggérerais de créer un lien vers une page où les gens peuvent en savoir plus sur le développement et le but de l'application. Dans cet exemple, nous pointons simplement vers le site SharePoint qui lance le site Learning Pathways dans un locataire.
L'URL de la « Déclaration de confidentialité » pointe vers la déclaration de confidentialité de Microsoft puisque cet exemple utilise le portail Microsoft Learning Pathways. Les « Conditions d'utilisation » renvoient simplement à la documentation du portail des parcours d'apprentissage. Il est recommandé que ces URL ne pointent pas vers des sites hébergés en externe. Lors de nos tests de cette application plus tard, nous verrons les avertissements suivants.
Vous aurez besoin d'au moins deux logos de la page de marque. Ils doivent être de la taille exacte indiquée dans leur description. Vous avez maintenant complété toutes les options de l' onglet « Apps Details ». Passez maintenant à l' onglet " Onglets " sous " Capacités ".
- Cliquez sur « Ajouter un onglet personnel »
- Dans l'onglet Nom, choisissez un nom qui apparaîtra sur la page Web du portail, comme indiqué ci-dessous.
- Définissez n'importe quel nombre sur l'identifiant de l'entité.
- L'« URL du contenu » renvoie à notre portail Learning Pathways.
- L'« URL du site Web » qui renvoie à notre portail Learning Pathways Cliquez sur Enregistrer.
- Authentification unique de l'application Web
- L'ID d'application AAD dans cet exemple est pour un site SharePoint. Le numéro officiel est 00000003-0000-0ff1-ce00-000000000000. N'utilisez aucun autre numéro pour cet exemple.
- L'« URL de la ressource » doit avoir le nom unique de votre locataire à la place de mon « m365x360288 ». Appuyez sur Enregistrer après avoir rempli les champs.
- Nous avons maintenant terminé la configuration de notre application personnalisée.
Tester l'application
- Sous l'en-tête « Terminer » dans l'application App Studio, sélectionnez « Tester et distribuer »
- Ensuite, vous verrez l'écran suivant avec une série d'avertissements. Ne vous inquiétez pas des avertissements dans cet exemple de cas d'utilisation. Dans un environnement de production, vous souhaiterez suivre les instructions pour les transférer vers des URL internes.
- Si vous n'avez pas saisi correctement les éléments, vous verrez l'avertissement suivant.
- Si vous avez tout fait correctement, le programme d'installation de l'application apparaîtra prêt à être testé. Ajoutez-le à vos équipes. Avant de cliquer sur ajouter, passez en revue les informations sur le sujet . Vous verrez comment les informations ont été utilisées ci-dessus.
- Après l'installation de l'application, elle chargera le portail des parcours d'apprentissage s'il fonctionne.
Emballage de l'application
- Revenez à l'application App Studio en cliquant sur l'ellipse dans la barre de navigation de l'application.
- La fenêtre suivante s'ouvrira et affichera l'application « App Studio » et l'application « Contoso Learning » que nous venons de tester pour ajouter à notre équipe d'utilisateurs. Cliquez sur l'icône « App Studio » pour relancer l'application. Sélectionnez l'« éditeur de manifeste »
- Recherchez sous « Applications récemment créées » l'application « Contoso Learning » et cliquez dessus.
- Cliquez sur l' onglet « Tester et distribuer »
- Cliquez sur le bouton « Télécharger » pour empaqueter l'application pour l'importation.
- Vous verrez une fenêtre contextuelle indiquant que le package a été exporté et son nom de fichier.
- L'emplacement sera le dossier des téléchargements sur le PC. N'oubliez pas cet emplacement pour le téléchargement dans le portail d'applications des locataires.
Téléchargement de l'application
- Retournez dans Teams et recherchez l'icône " Apps " dans la barre de navigation de l'application.
- Si votre ID utilisateur dispose de l'autorisation appropriée pour télécharger une application personnalisée, vous pouvez cliquer sur « Télécharger une application personnalisée » en bas de la liste. Clique dessus. Cliquez ensuite pour télécharger vers votre locataire. Vous ne savez pas pourquoi il s'agit d'un double-clic Naviguez jusqu'au dossier des téléchargements pour localiser notre package et cliquez sur " Ouvrir "
- Si vous n'avez pas réussi à utiliser un compte figurant dans la « Politique d'importation d'applications » que nous avons créée, vous verrez l'erreur suivante.
- En cas de succès, l'application apparaîtra désormais dans le catalogue d'applications des locataires
- Searching for this app in the app catalog and clicking add will install the app under the ellipse as it did on the test install. STOP! We are not going to install the app that way. Instead, we are going to pin the app to the App Navigation Bar using our “App Setup Policy”.
Making the App available
- Locate the App Setup Policy we created earlier and check the box. Then click “Edit”
- Under “Pinned apps” click “Add apps”
- Browse for the “Learning” app and select it and click “Add” The click the “Add” button at the bottom to close out the screen.
- You will now see the app on how I will appear on the App Navigation Bar. The default is at the bottom you can highlight the app and move it up. If you are satisfied with the position click “Save”
Final Solution
- Now we wait for the policy settings to sync on Microsoft 365 backend systems before we will see the results of our work. We will not see our new app show up on the App Navigation Bar for about 2 hours.
- Click on the New App Icon and see the finished project.