Mettre le poste opérateur à disposition comme application Teams

À quoi cela sert

Les standardistes qui travaillent toute la journée dans Microsoft Teams peuvent y ouvrir directement le poste opérateur EasyUC. Pour cela, le poste opérateur est fourni comme application Teams personnelle, interne au tenant. Teams charge la page du poste opérateur comme onglet dans la barre d’applications.

La connexion utilise le compte Teams actif : l’utilisateur clique sur Sign in with Teams, Teams délivre un jeton d’accès pour l’utilisateur déjà connecté, EasyUC le valide et ouvre la session du poste opérateur. Le mot de passe de l’utilisateur n’est pas transmis à EasyUC.

Le package de l’application est un fichier ZIP contenant un manifeste et deux icônes. Il ne contient ni mot de passe, ni secret client, ni jeton. Le nom d’hôte EasyUC, l’ID client et les adresses de la déclaration de confidentialité et des conditions d’utilisation sont des informations publiques.

Prérequis

• Modules de licence acd (poste opérateur) et teams.
• Un nom DNS complet pour EasyUC, par exemple easyuc.kunde.de, avec HTTPS sur le port 443 et une chaîne de certificats reconnue publiquement. Les simples adresses IP et les certificats auto-signés ne conviennent pas pour un onglet Teams.
• Des pages accessibles en HTTPS pour la confidentialité et les conditions d’utilisation.
• Dans le tenant Microsoft du client, le droit de créer une app registration ainsi que de téléverser et de publier une application Teams personnalisée.
• Dans EasyUC, le tenant Teams du client existe et est actif, avec Directory (tenant) ID et Application (client) ID. EasyUC valide le jeton Teams à l’aide de ces deux valeurs.
• Les standardistes sont enregistrés comme standardistes autorisés et associés à leur compte Microsoft (chapitre sur l’attribution des standardistes et des terminaux).
• Le générateur de package de la livraison EasyUC (tools/teams-attendant-app) et Python 3 sur un poste de travail.

Pas à pas : préparer l’app registration pour la connexion Teams

1. Dans le centre d’administration Microsoft Entra, ouvrez Identity → Applications → App registrations et l’app registration dont l’ID d’application est enregistré sur le tenant dans EasyUC. Sinon, créez-en une avec New registration et saisissez son ID sur le tenant.
2. Dans le manifeste de l’application Entra, définissez la valeur requestedAccessTokenVersion sous api sur 2.
3. Sous Expose an API, créez l’Application ID URI sous la forme api://EASYUC-HOSTNAME/CLIENT-ID, par exemple api://easyuc.kunde.de/00000000-0000-0000-0000-000000000000.
4. Créez-y une étendue (scope) déléguée nommée access_as_user, consentement par les administrateurs et les utilisateurs, état activé.
5. Sous Authorized client applications, saisissez les deux clients Teams de Microsoft : 1fec8e78-bce4-4aaf-ab1b-5451cc387264 (Teams bureau et mobile) et 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 (Teams web). Autorisez l’étendue pour les deux.
6. Aucun droit Microsoft Graph ni secret client n’est nécessaire pour cette connexion.

Pas à pas : générer et valider le package de l’application

1. Sur le poste de travail, placez-vous dans le répertoire de la livraison EasyUC.
2. Générez le package : python3 tools/teams-attendant-app/generate-package.py --fqdn easyuc.kunde.de --client-id CLIENT-ID --privacy-url https://www.kunde.de/datenschutz --terms-url https://www.kunde.de/nutzungsbedingungen.
3. Le fichier ZIP se trouve ensuite sous tools/teams-attendant-app/dist/. Il contient exactement manifest.json, color.png et outline.png.
4. Validez le package : python3 tools/teams-attendant-app/validate-package.py suivi du chemin du fichier ZIP.

Pas à pas : téléverser et publier l’application dans Teams

1. Ouvrez le centre d’administration Teams du client.
2. Sélectionnez Teams apps → Manage apps.
3. Ouvrez Actions → Upload new app et téléversez le fichier ZIP.
4. Publiez l’application pour le groupe des standardistes.
5. Si vous le souhaitez, épinglez l’application dans la barre d’applications au moyen d’une politique de configuration.
6. L’utilisateur ouvre l’application EasyUC Attendant dans Teams. Elle apparaît parmi les applications de sa propre organisation.
7. Sur la page Attendant console in Microsoft Teams, l’utilisateur clique sur Sign in with Teams. Le poste opérateur s’ouvre.

Pas à pas : mettre à jour le package

1. Générez le package avec le même ID client et une version supérieure, par exemple --version 4.5.1. L’application conserve ainsi son identité.
2. Validez le nouveau fichier ZIP avec validate-package.py.
3. Téléversez-le dans le centre d’administration Teams comme mise à jour de l’application existante.

Champs et options

Vérifier le résultat et circonscrire les erreurs

• Succès : l’application apparaît dans Teams, l’onglet charge la page de connexion et, après Sign in with Teams, le poste opérateur s’ouvre sans demande de mot de passe.
• L’onglet ne se charge pas : vérifiez le certificat HTTPS et le DNS du nom d’hôte EasyUC, ainsi que l’exactitude du nom d’hôte dans le package.
• Teams signale une ressource erronée : comparez caractère par caractère l’Application ID URI dans Microsoft Entra avec api://EASYUC-HOSTNAME/CLIENT-ID.
• “Sign-in with your Microsoft Teams account failed. Please try again.” Vérifiez l’étendue access_as_user, les deux clients Teams préautorisés et si l’ID de répertoire et l’ID d’application sur le tenant EasyUC appartiennent à cette application Entra.
• “This Microsoft account is not enabled for the attendant console.” L’utilisateur n’est pas un standardiste autorisé ou n’est pas associé à son compte Microsoft.
• “Microsoft sign-in has not been fully configured yet. Please contact your administrator.” Il n’existe pas de tenant actif unique dans EasyUC pour l’ID de répertoire.
• “Microsoft sign-in is not available in this installation.” Le module Teams n’est pas actif.
• “The attendant console could not be initialized in Microsoft Teams. Please reopen it in Teams.” Fermez l’onglet et rouvrez l’application.
• Le téléversement est refusé : contrôlez avec validate-package.py et examinez la politique de gestion des applications du tenant pour les applications personnalisées.