EasyUC
Français
Aurora

Choisir le thème

4.8.7

EasyUC pour Microsoft Teams

Accès Graph et connexion de l’administrateur Teams

Enregistrer l’app registration pour Microsoft Graph et connecter EasyUC à Teams PowerShell.

EasyUC · Version 4.8.7

Dans EasyUC : EasyUC Teams → Teams → Teams Tenants → tenant → Settings → Microsoft Graph / Set up the trunk in Teams

À quoi cela sert

EasyUC communique avec Microsoft de deux manières. Par Microsoft Graph, il lit les utilisateurs, la présence et les téléphones Teams. Par Teams PowerShell, il configure le trunk, les routes vocales et les attributions de numéros. Les deux voies nécessitent une autorisation dans le tenant Microsoft du client.

Pour Graph, vous enregistrez une application dans le tenant du client et saisissez son ID d’application et son secret client dans EasyUC. La même app registration peut aussi servir à la connexion à Teams PowerShell. EasyUC se connecte alors lui-même avant chaque action, et l’enregistrement d’un script définit la route dans Teams sans intervention.

Sans app registration, il reste la connexion par code d’appareil : un administrateur Teams confirme la connexion dans le navigateur. Cette session expire au bout d’environ une heure. EasyUC n’enregistre jamais le nom d’utilisateur ni le mot de passe d’un administrateur.

Prérequis

  • Module de licence teams. Sans ce module, l’espace de travail EasyUC Teams n’apparaît pas.
  • Rôle EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) avec les sous-droits TENANTS (ROLE_APP_TEAMS_TENANTS) pour la lecture et TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) pour la modification.
  • Le tenant existe et le Directory (tenant) ID est saisi.
  • Un compte autorisé à créer des app registrations dans le tenant Microsoft du client et à accorder le consentement administrateur.
  • Pour la connexion par code d’appareil : un compte avec le rôle Teams Administrator.
  • Le service PowerShell d’EasyUC fonctionne. La page du tenant l’indique sous Set up the trunk in Teams.

Pas à pas : préparer l’app registration dans Microsoft Entra

  1. Connectez-vous au centre d’administration Microsoft Entra du client et créez une nouvelle application sous les app registrations, par exemple sous le nom EasyUC.
  2. Notez l’ID d’annuaire (tenant) et l’ID d’application (client). Les deux sont des GUID ; ne les confondez pas.
  3. Accordez à l’application les droits d’application Microsoft Graph User.Read.All (utilisateurs), Presence.Read.All (présence) et TeamworkDevice.Read.All (téléphones Teams).
  4. Si vous souhaitez utiliser la synchronisation de présence, ajoutez Presence.ReadWrite.All.
  5. Si EasyUC doit se connecter lui-même à Teams PowerShell, ajoutez le droit d’application Organization.Read.All.
  6. Accordez le consentement administrateur pour tous les droits.
  7. Pour la connexion d’application à Teams PowerShell, attribuez en plus à l’application le rôle d’annuaire Teams Administrator. N’ajoutez pas de droit d’API pour la « Skype and Teams Tenant Admin API ».
  8. Créez un secret client et copiez sa valeur. Notez la date d’expiration.

Pas à pas : enregistrer et tester l’accès Graph dans EasyUC

  1. Ouvrez Teams Tenants, cliquez sur le tenant et restez dans la section Settings.
  2. Vérifiez le Directory (tenant) ID en haut.
  3. Allez à l’encadré Microsoft Graph (user import and presence).
  4. Saisissez l’Application (client) ID.
  5. Sous Client secret, saisissez la valeur du secret.
  6. Cliquez sur Save.
  7. Cliquez sur Test credentials. En cas de succès, le message „Verbindung steht. Beispielbenutzer: …“ s’affiche et l’en-tête de l’encadré indique Checked.

Pas à pas : se connecter à Teams PowerShell avec l’app registration

  1. Sur la page du tenant, dans la section Settings, allez à l’encadré Set up the trunk in Teams.
  2. Contrôlez la ligne PowerShell service reachable. Elle est suivie des versions du module MicrosoftTeams et de PowerShell.
  3. Si elle indique “An app registration is stored: EasyUC signs in by itself before every action (app sign-in, unattended).”, vous n’avez rien d’autre à faire. L’indicateur d’état affiche Signs in automatically.
  4. Pour tester, cliquez sur Sign in with the app registration.
  5. Cliquez sur Check connection. En cas de succès, Signed in s’affiche avec App sign-in (unattended).

Pas à pas : se connecter avec un administrateur Teams par code d’appareil

  1. Dans l’encadré Set up the trunk in Teams, cliquez sur Sign in with a Teams admin.
  2. EasyUC affiche un code et une adresse. Cliquez sur Copy code.
  3. Cliquez sur Open sign-in page, connectez-vous en tant qu’administrateur Teams et saisissez le code.
  4. Laissez la page du tenant ouverte. Elle interroge le service toutes les trois secondes, pendant cinq minutes au maximum.
  5. Après confirmation, elle affiche Signed in avec Device code (expires), le compte et l’heure d’expiration.
  6. Terminez le trunk, les routes vocales et les attributions de numéros pendant la session. Sign out y met fin plus tôt.

Champs et options

Champ / actionSignification et utilisation
Application (client) IDGUID de l’app registration dans le tenant du client.
Client secretValeur du secret client. Si un secret est enregistré, le champ affiche “stored - leave empty to keep”. Le secret n’est jamais affiché.
Remove stored secretMarque le secret enregistré pour suppression. Il est supprimé lors du prochain Save.
Test credentialsLit des utilisateurs de l’annuaire à titre de test et enregistre le résultat avec un horodatage. États dans l’en-tête : Checked, Rejected, Not checked yet, Credentials missing.
Sign in with the app registrationConnexion à Teams PowerShell avec l’ID d’application et le secret client. N’apparaît que si les deux sont enregistrés. En pratique, elle n’expire pas.
Sign in with a Teams adminConnexion d’un administrateur par code d’appareil. Expire au bout d’environ une heure.
Check connectionRelit l’état de la connexion.
Sign outMet fin à la session auprès de Teams PowerShell. Le trunk n’est pas affecté.
Status pillSigned in, Signs in automatically, Waiting for confirmation, Not signed in, Sign-in expired ou Service not reachable.

Vérifier le résultat et circonscrire les erreurs

  • Succès Graph : la section Users du tenant affiche les utilisateurs de l’annuaire, la section Phones affiche l’inventaire.
  • Succès PowerShell : dans l’encadré Set up the trunk in Teams, Show what would happen et Update routes sont utilisables, et la section Number plan charge les numéros de téléphone.
  • „Es sind noch keine vollständigen Graph-Zugangsdaten hinterlegt (Verzeichnis-ID, Anwendungs-ID und Secret).“ L’une des trois informations manque. Enregistrez avant de tester.
  • “The directory (tenant) ID above is also required.” Saisissez le GUID dans les paramètres du tenant.
  • État Rejected : vérifiez le secret client et sa date d’expiration, les droits d’application et le consentement administrateur dans le bon tenant.
  • „Verbindung steht, das Verzeichnis liefert aber keine Benutzer.“ La connexion fonctionne, mais User.Read.All manque ou n’a pas reçu de consentement.
  • „Der PowerShell-Dienst ist nicht erreichbar - ohne ihn kann der Trunk nur von Hand in Teams angelegt werden.“ Vérifiez dans EasyUC Manager que le service PowerShell du module Teams fonctionne.
  • “The device code sign-in has expired” Connectez-vous de nouveau ou enregistrez une app registration.
  • „Die Anmeldung wurde nicht bestaetigt. Bitte erneut starten.“ Les cinq minutes se sont écoulées. Relancez la connexion.
  • „Die Anmeldung steht, aber dem Konto fehlen die Rechte. Der App-Registrierung muss die Verzeichnisrolle „Teams-Administrator“ zugewiesen sein.“ Attribuez le rôle dans Microsoft Entra.
  • Un test Graph réussi ne prouve pas les droits pour Teams PowerShell, et inversement. Contrôlez séparément les deux voies.

Chapitres associés