EasyUC
Español
Aurora

Elegir diseño

4.8.7

EasyUC para Microsoft Teams

Acceso a Graph e inicio de sesión del administrador de Teams

Almacene el registro de aplicación para Microsoft Graph e inicie sesión de EasyUC en Teams PowerShell.

EasyUC · Versión 4.8.7

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

Para qué sirve

EasyUC se comunica con Microsoft de dos maneras. A través de Microsoft Graph lee usuarios, presencia y teléfonos de Teams. A través de Teams PowerShell configura el trunk, las rutas de voz y las asignaciones de números. Ambas vías necesitan un permiso en el tenant de Microsoft del cliente.

Para Graph, usted registra una aplicación en el tenant del cliente y almacena su ID de aplicación y su secreto de cliente en EasyUC. El mismo registro de aplicación puede encargarse también del inicio de sesión en Teams PowerShell. EasyUC inicia entonces sesión por sí mismo antes de cada acción y, al guardar un script, la ruta se define en Teams sin intervención.

Sin registro de aplicación queda el inicio de sesión con código de dispositivo: un administrador de Teams confirma el inicio de sesión en el navegador. Esta sesión caduca tras aproximadamente una hora. EasyUC nunca almacena el nombre de usuario ni la contraseña de un administrador.

Requisitos previos

  • Módulo de licencia teams. Sin este módulo no aparece el espacio de trabajo EasyUC Teams.
  • Rol EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) con los subpermisos TENANTS (ROLE_APP_TEAMS_TENANTS) para leer y TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) para modificar.
  • El tenant existe y el Directory (tenant) ID está introducido.
  • Una cuenta con derecho a crear registros de aplicación en el tenant de Microsoft del cliente y a conceder el consentimiento de administrador.
  • Para el inicio de sesión con código de dispositivo: una cuenta con el rol Teams Administrator.
  • El servicio PowerShell de EasyUC está en ejecución. La página del tenant lo muestra en Set up the trunk in Teams.

Paso a paso: preparar el registro de aplicación en Microsoft Entra

  1. Inicie sesión en el Microsoft Entra admin center del cliente y cree una aplicación nueva en los registros de aplicaciones, por ejemplo con el nombre EasyUC.
  2. Anote el ID de directorio (tenant) y el ID de aplicación (cliente). Ambos son GUID; no los confunda.
  3. Conceda a la aplicación los permisos de aplicación de Microsoft Graph User.Read.All (usuarios), Presence.Read.All (presencia) y TeamworkDevice.Read.All (teléfonos de Teams).
  4. Si desea utilizar la sincronización de presencia, añada Presence.ReadWrite.All.
  5. Si EasyUC debe iniciar sesión por sí mismo en Teams PowerShell, añada el permiso de aplicación Organization.Read.All.
  6. Conceda el consentimiento de administrador para todos los permisos.
  7. Para el inicio de sesión de la aplicación en Teams PowerShell, asigne además a la aplicación el rol de directorio Teams Administrator. No añada ningún permiso de API para la “Skype and Teams Tenant Admin API”.
  8. Cree un secreto de cliente y copie su valor. Anote la fecha de caducidad.

Paso a paso: almacenar y probar el acceso a Graph en EasyUC

  1. Abra Teams Tenants, haga clic en el tenant y permanezca en la sección Settings.
  2. Compruebe el Directory (tenant) ID en la parte superior.
  3. Vaya al cuadro Microsoft Graph (user import and presence).
  4. Introduzca el Application (client) ID.
  5. En Client secret, introduzca el valor del secreto.
  6. Haga clic en Save.
  7. Haga clic en Test credentials. Si tiene éxito, muestra „Verbindung steht. Beispielbenutzer: …“ y el encabezado del cuadro muestra Checked.

Paso a paso: iniciar sesión en Teams PowerShell con el registro de aplicación

  1. En la página del tenant, en la sección Settings, vaya al cuadro Set up the trunk in Teams.
  2. Compruebe la línea PowerShell service reachable. A continuación figuran las versiones del módulo MicrosoftTeams y de PowerShell.
  3. Si indica “An app registration is stored: EasyUC signs in by itself before every action (app sign-in, unattended).”, no necesita hacer nada más. La etiqueta de estado muestra Signs in automatically.
  4. Para probar, haga clic en Sign in with the app registration.
  5. Haga clic en Check connection. Si tiene éxito, muestra Signed in con App sign-in (unattended).

Paso a paso: iniciar sesión con un administrador de Teams mediante código de dispositivo

  1. En el cuadro Set up the trunk in Teams, haga clic en Sign in with a Teams admin.
  2. EasyUC muestra un código y una dirección. Haga clic en Copy code.
  3. Haga clic en Open sign-in page, inicie sesión como administrador de Teams e introduzca el código.
  4. Deje abierta la página del tenant. Consulta cada tres segundos, como máximo durante cinco minutos.
  5. Tras la confirmación muestra Signed in con Device code (expires), la cuenta y la hora de caducidad.
  6. Complete el trunk, las rutas de voz y las asignaciones de números dentro de la sesión. Sign out la finaliza antes de tiempo.

Campos y opciones

Campo / acciónSignificado y uso
Application (client) IDGUID del registro de aplicación en el tenant del cliente.
Client secretValor del secreto de cliente. Si hay uno almacenado, el campo muestra “stored - leave empty to keep”. El secreto nunca se muestra.
Remove stored secretMarca el secreto almacenado para su eliminación. Se elimina con el siguiente Save.
Test credentialsLee usuarios del directorio como prueba y almacena el resultado con una marca de tiempo. Estados en el encabezado: Checked, Rejected, Not checked yet, Credentials missing.
Sign in with the app registrationInicio de sesión en Teams PowerShell con ID de aplicación y secreto de cliente. Solo aparece cuando ambos están almacenados. En la práctica no caduca.
Sign in with a Teams adminInicio de sesión de un administrador con código de dispositivo. Caduca tras aproximadamente una hora.
Check connectionVuelve a leer el estado del inicio de sesión.
Sign outFinaliza la sesión en Teams PowerShell. El trunk no se ve afectado.
Status pillSigned in, Signs in automatically, Waiting for confirmation, Not signed in, Sign-in expired o Service not reachable.

Comprobar el resultado y acotar errores

  • Éxito de Graph: la sección Users del tenant muestra los usuarios del directorio y la sección Phones muestra el inventario.
  • Éxito de PowerShell: en el cuadro Set up the trunk in Teams se pueden utilizar Show what would happen y Update routes, y la sección Number plan carga números de teléfono.
  • „Es sind noch keine vollständigen Graph-Zugangsdaten hinterlegt (Verzeichnis-ID, Anwendungs-ID und Secret).“ Falta uno de los tres datos. Guarde antes de probar.
  • “The directory (tenant) ID above is also required.” Introduzca el GUID en los ajustes del tenant.
  • Estado Rejected: compruebe el secreto de cliente y su fecha de caducidad, los permisos de aplicación y el consentimiento de administrador en el tenant correcto.
  • „Verbindung steht, das Verzeichnis liefert aber keine Benutzer.“ El inicio de sesión funciona, pero falta User.Read.All o no tiene consentimiento.
  • „Der PowerShell-Dienst ist nicht erreichbar - ohne ihn kann der Trunk nur von Hand in Teams angelegt werden.“ Compruebe en EasyUC Manager que el servicio PowerShell del módulo Teams está en ejecución.
  • “The device code sign-in has expired” Inicie sesión de nuevo o almacene un registro de aplicación.
  • „Die Anmeldung wurde nicht bestaetigt. Bitte erneut starten.“ Han transcurrido los cinco minutos. Inicie de nuevo el inicio de sesión.
  • „Die Anmeldung steht, aber dem Konto fehlen die Rechte. Der App-Registrierung muss die Verzeichnisrolle „Teams-Administrator“ zugewiesen sein.“ Asigne el rol en Microsoft Entra.
  • Una prueba correcta de Graph no demuestra que existan derechos para Teams PowerShell, y viceversa. Compruebe ambas vías por separado.

Capítulos relacionados