Microsoft Teams

Le tableau de bord Microsoft Teams dans Citrix Director offre une visibilité sur les appels Microsoft Teams pour tous les utilisateurs, ainsi que des détails sur les participants et des métriques indiquant les performances des appels. Le tableau de bord permet de :

  • Évaluer le résumé de l’utilisation de Microsoft Teams
  • Filtrer et afficher les détails des appels Microsoft Teams pour la durée sélectionnée
  • Évaluer les appels individuels à l’aide de métriques de performance

Tableau de bord Microsoft Teams

Conditions préalables

Ajoutez l’interface de programmation d’applications (API) Microsoft Graph à la liste d’autorisation dans Citrix Director :

  • Pour que Director puisse accéder aux enregistrements d’appels, assurez-vous que l’accès Internet sortant est disponible sur toutes les machines où Director est installé. Plus précisément, assurez-vous que l’URL https://graph.microsoft.com est accessible.
  • Si vous utilisez un serveur proxy, assurez-vous que l’URL de l’API Microsoft Graph : https://graph.microsoft.com est accessible.

Mise en route

Connexion à l’API Microsoft Graph

Les détails des appels Microsoft sont récupérés depuis l’API Microsoft Graph. Pour que Citrix Director puisse accéder à l’API, une application doit être créée dans Microsoft Entra ID avec les autorisations requises. L’URL de l’API Graph doit également être ajoutée à la liste d’autorisation dans Director.

Effectuez les étapes suivantes pour établir la connexion :

Étape 1 : Enregistrement de l’application dans Microsoft Entra ID

  1. Accédez à Inscriptions d’applications -> Nouvelle inscription dans Microsoft Entra ID.

    Nouvelle inscription

  2. Effectuez les étapes requises pour l’inscription de l’application.
  3. Après l’inscription, copiez l’ID client et l’ID de locataire de l’application.

Étape 2 : Ajout des autorisations Microsoft Graph dans Microsoft Entra ID

  1. Accédez à Autorisations d’API -> Ajouter une autorisation.
  2. Sélectionnez Microsoft Graph puis Autorisations d’application.

    Microsoft Graph

  3. Ajoutez des autorisations à CallRecords.Read.All et User.Read.All

    Autorisations Microsoft Graph

  4. Cliquez sur Accorder le consentement administrateur pour MSFT. Cette action nécessite un administrateur général Entra ID.

    Accorder le consentement administrateur

Étape 3 : Création d’un secret client

  1. Dans Microsoft Entra ID, accédez à Certificats et secrets -> Secrets client -> Nouveau secret client. Vous pouvez également réutiliser un secret existant.

    Nouveau secret client

  2. Indiquez un nom et une date d’expiration pour le secret. Assurez-vous que le secret est renouvelé avant son expiration pour maintenir la connexion.
  3. Copiez le secret client pour l’utiliser dans l’interface utilisateur de Director.

Pour plus d’informations, consultez la documentation Azure officielle si vous rencontrez des problèmes.

Étape 4 : Terminer la connexion sur Director

  1. Dans Director, accédez à Paramètres -> Connecter les applications de communication en temps réel.

    Paramètres

  2. Cliquez sur Créer une connexion et saisissez l’ID d’application, l’ID de répertoire et le secret client copiés lors de l’enregistrement de l’application.

    Créer une connexion

    La connexion est établie avec succès si des informations d’identification valides et les autorisations nécessaires pour récupérer les détails des appels sont disponibles.

    Récupérer les détails

  3. Vous pouvez Modifier et Supprimer la connexion en cliquant sur l’ellipse à la fin de la ligne.

Tableau de bord Microsoft Teams

Accédez à l’onglet Communications en temps réel dans l’interface utilisateur de Director. Le tableau de bord Microsoft Teams est renseigné avec les données collectées à partir de la connexion Microsoft Graph établie. Les détails des appels sont disponibles environ 15 minutes après la fin de l’appel.

Historique des appels

L’affichage tabulaire fournit les détails suivants pour tous les appels.

Nom de la colonne Description
ID d’appel Un identifiant unique pour chaque appel.
Type d’appel Indique si l’appel est pair à pair ou un appel de groupe.
Modalité Indique les modes utilisés pendant l’appel, tels que l’audio, la vidéo ou le partage d’écran.
Heure de début La date et l’heure de début de l’appel.
Heure de fin La date et l’heure de fin de l’appel.
Durée (mm: ss) Durée de l’appel en minutes et secondes.

Cliquez sur les appels individuels dans le tableau pour afficher les détails d’échec et de performance par utilisateur.

Appel individuel(/fr-fr/citrix-virtual-apps-desktops/2507-ltsr/media/individual-calls.png)

Lors d’un appel de groupe, lorsqu’un utilisateur se déconnecte et se reconnecte, cela est considéré comme une session distincte. Cette considération permet d’identifier des problèmes spécifiques, tels qu’une latence plus élevée lorsqu’il est connecté à un réseau particulier.

Chaque ligne du tableau des détails de l’appel contient les informations suivantes :

Nom de la colonne Description
Heure de début La date et l’heure du début de l’appel ou du segment du participant.
Temps d’aller-retour (moy.) Temps d’aller-retour moyen pour les paquets de données.
Taux de perte de paquets (moy.) Pourcentage moyen de paquets perdus pendant l’appel.
Gigue (moy.) Variation moyenne du délai des paquets reçus.
Phase d’échec Indique la phase à laquelle un échec d’appel s’est produit, par exemple, pendant la configuration ou au milieu de l’appel.
Heure de fin Date et heure de fin de l’appel ou du segment du participant.
Appelant Nom du participant à l’appel.
Estimation de la bande passante (moy.) Bande passante moyenne estimée utilisée pendant l’appel.

Vous pouvez filtrer les utilisateurs de deux manières : par nom d’utilisateur Citrix ou par nom d’utilisateur Microsoft Teams. Vous pouvez basculer entre ces options à l’aide des boutons radio situés en haut de la page.

  • Nom d’utilisateur Citrix : Lorsque vous commencez à saisir un nom d’utilisateur, le système suggère des utilisateurs correspondants. Vous pouvez ensuite sélectionner le compte spécifique pour afficher les détails.
  • Nom d’utilisateur Microsoft Teams : Utilisez cette option si l’adresse e-mail ou le nom d’utilisateur principal (UPN) associé au compte Microsoft Teams diffère de l’ID de compte Citrix. Lorsque vous utilisez cette méthode, vous devez saisir l’adresse e-mail complète et valide.

nom d'utilisateur

Dépannage

  • Pourquoi l’intégration a-t-elle échoué avec l’erreur « API Azure bloquée. Pour créer une connexion, ajoutez l’API Azure à votre liste d’autorisation » ?

    API Azure bloquée

    Solution : Assurez-vous d’avoir suivi les prérequis et d’avoir ajouté le point de terminaison de l’API Microsoft Graph à votre liste d’autorisation.

  • Pourquoi l’erreur « API Microsoft Graph bloquée » s’affiche-t-elle lorsque j’affiche les appels ?

    API Microsoft bloquée(/fr-fr/citrix-virtual-apps-desktops/2507-ltsr/media/microsoft-graph-api-blocked.png)

    Solution : Assurez-vous d’avoir suivi les prérequis et d’avoir ajouté le point de terminaison de l’API Microsoft Graph à votre liste d’autorisation.

  • Pourquoi l’écran Connexions affiche-t-il “Autorisations d’application requises manquantes dans Microsoft Entra ID” ?

    Autorisations manquantes(/fr-fr/citrix-virtual-apps-desktops/2507-ltsr/media/missing-required-application-permissions.png)

    Solution : Vérifiez que les autorisations d’application CallRecords.Read.All et User.Read.All sont attribuées à l’application Entra ID.

Microsoft Teams