Proporcionar la consola de operador como aplicación de Teams

Para qué sirve

Los operadores que trabajan todo el día en Microsoft Teams pueden abrir allí mismo la consola de operador de EasyUC. Para ello, la consola de operador se proporciona como una aplicación de Teams personal e interna del tenant. Teams carga la página de la consola de operador como una pestaña en la barra de aplicaciones.

El inicio de sesión utiliza la cuenta de Teams activa: el usuario hace clic en Sign in with Teams, Teams emite un token de acceso para el usuario que ya ha iniciado sesión, EasyUC lo valida y abre la sesión de la consola de operador. La contraseña del usuario no se transmite a EasyUC.

El paquete de la aplicación es un archivo ZIP con un manifiesto y dos iconos. No contiene contraseñas, secretos de cliente ni tokens. El nombre de host de EasyUC, el ID de cliente y las direcciones de la declaración de privacidad y de las condiciones de uso son datos públicos.

Requisitos previos

• Módulos de licencia acd (consola de operador) y teams.
• Un nombre DNS completo para EasyUC, por ejemplo easyuc.kunde.de, con HTTPS en el puerto 443 y una cadena de certificados de confianza pública. Las direcciones IP simples y los certificados autofirmados no son adecuados para una pestaña de Teams.
• Páginas accesibles de privacidad y condiciones de uso a través de HTTPS.
• En el tenant de Microsoft del cliente, el derecho a crear un registro de aplicación y a cargar y publicar una aplicación personalizada de Teams.
• En EasyUC existe el tenant de Teams del cliente y está activo, con Directory (tenant) ID y Application (client) ID. EasyUC valida el token de Teams con estos dos valores.
• Los operadores están registrados como operadores habilitados y asignados a su cuenta de Microsoft (capítulo sobre la asignación de operadores y dispositivos).
• El generador de paquetes de la entrega de EasyUC (tools/teams-attendant-app) y Python 3 en una estación de trabajo.

Paso a paso: preparar el registro de aplicación para el inicio de sesión de Teams

1. En el Microsoft Entra admin center, abra Identity → Applications → App registrations y el registro de aplicación cuyo ID de aplicación está almacenado en el tenant en EasyUC. Si no existe, cree uno con New registration e introduzca su ID en el tenant.
2. En el manifiesto de la aplicación de Entra, establezca el valor requestedAccessTokenVersion en api con 2.
3. En Expose an API, cree el URI de ID de aplicación con la forma api://EASYUC-HOSTNAME/CLIENT-ID, por ejemplo api://easyuc.kunde.de/00000000-0000-0000-0000-000000000000.
4. Cree allí un ámbito delegado con el nombre access_as_user, consentimiento de administradores y usuarios, estado habilitado.
5. En Authorized client applications, introduzca los dos clientes de Teams de Microsoft: 1fec8e78-bce4-4aaf-ab1b-5451cc387264 (Teams para escritorio y móvil) y 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 (Teams web). Autorice el ámbito para ambos.
6. Para este inicio de sesión no se necesita ningún permiso de Microsoft Graph ni ningún secreto de cliente.

Paso a paso: generar y validar el paquete de la aplicación

1. En la estación de trabajo, cambie al directorio de la entrega de EasyUC.
2. Genere el paquete: 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. El archivo ZIP se encuentra entonces en tools/teams-attendant-app/dist/. Contiene exactamente manifest.json, color.png y outline.png.
4. Valide el paquete: python3 tools/teams-attendant-app/validate-package.py seguido de la ruta del archivo ZIP.

Paso a paso: cargar y publicar la aplicación en Teams

1. Abra el Teams admin center del cliente.
2. Seleccione Teams apps → Manage apps.
3. Abra Actions → Upload new app y cargue el archivo ZIP.
4. Publique la aplicación para el grupo de operadores.
5. Opcionalmente, ancle la aplicación en la barra de aplicaciones mediante una política de configuración.
6. El usuario abre la aplicación EasyUC Attendant en Teams. Aparece entre las aplicaciones de la propia organización del usuario.
7. En la página Attendant console in Microsoft Teams, el usuario hace clic en Sign in with Teams. Se abre la consola de operador.

Paso a paso: actualizar el paquete

1. Genere el paquete con el mismo ID de cliente y una versión superior, por ejemplo --version 4.5.1. De este modo, la aplicación conserva su identidad.
2. Valide el nuevo archivo ZIP con validate-package.py.
3. Cárguelo en el Teams admin center como actualización de la aplicación existente.

Campos y opciones

Comprobar el resultado y acotar errores

• Éxito: la aplicación aparece en Teams, la pestaña carga la página de inicio de sesión y, tras Sign in with Teams, la consola de operador se abre sin solicitar contraseña.
• La pestaña no se carga: compruebe el certificado HTTPS y el DNS del nombre de host de EasyUC, y si el nombre de host del paquete es exactamente correcto.
• Teams indica un recurso incorrecto: compare, carácter por carácter, el URI de ID de aplicación en Microsoft Entra con api://EASYUC-HOSTNAME/CLIENT-ID.
• “Sign-in with your Microsoft Teams account failed. Please try again.” Compruebe el ámbito access_as_user, los dos clientes de Teams preautorizados y si el ID de directorio y el ID de aplicación del tenant de EasyUC pertenecen a esta aplicación de Entra.
• “This Microsoft account is not enabled for the attendant console.” El usuario no es un operador habilitado o no está asignado a su cuenta de Microsoft.
• “Microsoft sign-in has not been fully configured yet. Please contact your administrator.” En EasyUC no hay un tenant activo único para el ID de directorio.
• “Microsoft sign-in is not available in this installation.” El módulo Teams no está activo.
• “The attendant console could not be initialized in Microsoft Teams. Please reopen it in Teams.” Cierre la pestaña y abra de nuevo la aplicación.
• La carga se rechaza: compruebe con validate-package.py y revise la política de gestión de aplicaciones del tenant para aplicaciones personalizadas.