Ce guide vous guidera à travers les étapes essentielles de l’installation et de la configuration de l’AddOn Matrix42 TeamViewer. Que vous soyez un professionnel de l’informatique qui met en œuvre cette intégration ou un utilisateur final à la recherche de ses avantages, ce document est votre ressource de référence.
Commençons par optimiser vos capacités d’assistance et de collaboration à distance avec l'AddOn Matrix42 TeamViewer.
Installation
- Téléchargez l’AddOn sous forme de fichier Zip et placez-le sur le serveur d’applications.
- Connectez-vous à votre plateforme Matrix42 ServiceManagement.
- Une fois que vous vous êtes connecté avec succès, accédez à la section Administration.
- Dans le menu d’administration, localisez et sélectionnez l’option Extensions. À partir de là, choisissez Packages installés pour passer aux étapes suivantes.
- Cliquez sur l’option Installer le package et sélectionnez le fichier ZIP à télécharger.
- Une fois le téléchargement terminé, cliquez sur Démarrer l’installation pour lancer le processus d’implémentation de l’extension.
Vous pouvez finaliser le processus en cliquant sur le bouton Terminer.
L’installation est terminée et nous pouvons maintenant procéder à la configuration.
Configuration
Créer une nouvelle application
Pour procéder à la configuration, nous devons d’abord créer une nouvelle application du côté de TeamViewer.
Veuillez vous connecter avec un compte d’entreprise ou un compte de service sur le portail TeamViewer (https://login.teamviewer.com).
Pour accéder à la section souhaitée, procédez comme suit :
1. Cliquez sur l’icône Utilisateur dans le coin supérieur droit.
2. Sélectionnez Editer le profil.
3. Cliquez sur Applications.
4. Créez une nouvelle application.
Veuillez suivre ces étapes pour indiquer un nom et une description, ainsi que pour l’URL de redirection.
1. Entrez un nom pour la configuration.
2. Ajoutez une description.
3. Pour l’URL de redirection, vous pouvez utiliser https://www.tap.de.
Les autorisations suivantes doivent être configurées dans l’application :
Gestion des sessions (Session management)
- Créer des sessions (Create sessions)
- Voir toutes les sessions (Create sessions)
- Modifier ses propres sessions (Edit own sessions)
- Afficher ses propres sessions (View own sessions)
Gestion de groupe (Group management)
- Groupes de lecture (Read groups)
Rapports de connexion (Connection reporting)
- Lire les entrées de connexion (Read connection entries)
Ordinateurs et contacts (Computers & Contacts)
- Voir les entrées (View entries)
Journalisation des événements (Event logging)
- Autoriser la demande de tous les journaux d’événements (Allow requesting all event logs)
Groupes d’appareils (Device Groups)
- Opérations de lecture (Read operations)
Surveillance Web (Web Monitoring)
- Obtenir des données (Get data)
Surveillance (Monitoring)
- Obtenir des données (Get data)
Après l’enregistrement, vous trouverez maintenant l’URL de redirection, l’ID client et la clé secrète client dans l’application.
🚨 Note importante : Ne partagez jamais ces informations avec quelqu’un que vous ne connaissez pas ou en qui vous n’avez pas entièrement confiance !
Les étapes de configuration de TeamViewer sont terminées. Maintenant, nous pouvons procéder à la configuration dans Matrix42 Service Management.
Créer un nouveau formulaire de configuration TeamViewer
Dans le module Service Desk, vous trouverez désormais l’option Configuration TeamViewer dans la section Configurations. Pour créer une nouvelle configuration, veuillez sélectionner Ajouter un formulaire de configuration TeamViewer dans ce menu.
Dans la configuration de Matrix42 Service Management, il vous suffit de remplir les champs qui ont déjà été configurés dans l’application TeamViewer. Ces champs incluent ClientID, ClientSecret et URL de redirection.
De plus, vous avez la possibilité de choisir ou de modifier un nom pour la configuration. Par défaut, il est pré-rempli par défaut.
De plus, vous sélectionnerez le mode de synchronisation, qui comprend :
- Synchronisation héritée : Cette option permet de synchroniser les « anciens » groupes.
- Synchronisation de groupe : Cette option synchronise les « nouveaux » groupes d’appareils.
Veuillez sélectionner le mode approprié en fonction de vos besoins.
Il suffit d’enregistrer (et non pas FAIT (Done)) votre configuration TeamViewer, puis :
Cliquez sur le bouton URL d’autorisation OAuth2 et un nouvel onglet s’ouvrira, vous redirigeant vers TeamViewer, où vous serez invité à vous authentifier avec vos informations d’identification .
N’oubliez pas de vous connecter avec le compte de service ou le compte d’utilisateur de l’entreprise que vous avez utilisé pour créer l’application à l’étape précédente.
Une fois que vous vous êtes authentifié, cliquez sur Autoriser les autorisations de l’application.
Lors de l’authentification, vous serez redirigé vers l’URL de redirection qui a été configurée dans l’application TeamViewer. À ce stade, assurez-vous de copier la valeur du paramètre "code".
Insérez le code dans la configuration TeamViewer.
Maintenant, la configuration TeamViewer peut être enregistrée et terminée.
Sur l’écran d’aperçu, vous verrez une action intitulée obtenir un jeton TeamViewer. S’il n’apparaît pas immédiatement, essayez de rafraîchir la page. Cliquez sur cette action pour obtenir le jeton TeamViewer et actualiser le jeton.
Un workflow, en particulier W_Team_getToken-UIActionWF 1.14, est déclenché et lancé. Après cela, vous pouvez actualiser la page une fois. Une fois l’exécution réussie du workflow, une coche verte apparaît.
Vous pouvez identifier le jeton en passant votre souris dessus.
À ce stade, vous avez terminé avec succès la configuration de TeamViewer.
Facultatif : Synchronisation de l’ID TeamViewer pour une session sans utilisateur distant
Si vous souhaitez lancer immédiatement des sessions sans utilisateur distant via TeamViewer, vous devez exécuter manuellement l’activation du moteur "TeamViewer_Sync Assets - EA". Par la suite, il s’exécutera automatiquement via un planificateur.
Cette activation déclenche un workflow pour synchroniser tous les ID TeamViewer dans Matrix42 Service Management. Le planificateur exécutera ce processus tous les jours à 00h00 (minuit).
Pour effectuer cette action :
- Accédez à la section Administration.
- Sélectionnez Services et processus, puis localisez l’activation du moteur nommée TeamViewer_Sync Assets - EA.
- Cliquez sur Activer pour lancer le processus.
Sessions assistées
Initier une session assistée
Dans le module Service Desk, vous rencontrerez une action appelée TeamViewer Créer une session à distance (TeamViewer Create Remote Session).
📌 Note : L’action TeamViewer Créer une session à distance n’est accessible que dans les cas suivants :
- Vous, en tant qu’utilisateur actuellement connecté, êtes désigné comme la partie responsable.
- Aucun code TeamViewer n’a été généré pour cette activité particulière.
Une fois que vous avez cliqué sur l’action TeamViewer Créer une session à distance :
1. Une nouvelle écriture de journal est générée.
2. Un lien client sera envoyé à l’initiateur d’activité.
3. Les boutons suivants sont créés :
- Join Session as Supporter (Rejoindre la session en tant que support) : Utilise TeamViewer installé.
- Join Session as Supporter From Browser (Rejoindre la session en tant que supporter à partir du navigateur) : Lance le TeamViewer WebClient.
Lorsque l’activité est fermée ou que la période « Valid_until » de la session expire, un CoRu (Custom Report Run) est déclenché pour récupérer tous les journaux de session de TeamViewer, le cas échéant.
S’il n’y a pas eu de session, l’entrée de journal ressemble à ceci :
Séances sans utilisateur distant
Lancer une session sans utilisateur distant
Dans le module Service Desk, vous rencontrerez une action nommée Connect to Asset (Se connecter à la ressource).
Veuillez noter que l’action TeamViewer Create Remote Session (TeamViewer Créer une session à distance) n’est disponible que dans les conditions suivantes :
- Une ressource est associée au ticket, et cette ressource possède un ID TeamViewer.
Après l’exécution de l’action Connect to Asset (Se connecter à la ressource), une tentative d’établissement de la connexion via start.teamviewer.com/TEAMVIEWER_ID sera effectuée. Au cours de ce processus, vous aurez la possibilité de choisir de démarrer TeamViewer installé ou de télécharger TeamViewer s’il n’est pas déjà installé.
📌 Note : Cette flexibilité permet aux utilisateurs d’utiliser leur installation TeamViewer existante pour la connexion ou de télécharger l’application si elle n’est pas encore disponible sur leur système.
Les journaux TeamViewer peuvent être enregistrés dans le journal via l’action TeamViewer Request Sessions.
- Voici une capture d’écran lorsqu’une entrée est trouvée :
- Voici une capture d’écran lorsqu’aucune entrée n’est trouvée :
📌 Note : Ces actions vous permettent de capturer et de documenter les informations de session TeamViewer dans le journal à des fins de référence et de suivi.