Administración

Enduser Setup: registro en vivo y sincronización con la herramienta externa

Siga la comunicación con la herramienta externa de pedidos y transfiera a ella el inventario de configuraciones.

EasyUC · Versión 4.8.7

En EasyUC: EasyUC Cisco → Administration → CUCM & Provisioning → Enduser Setup → Config Clusters → Live Log / Sync to external tool

Para qué sirve

El Enduser Setup funciona junto con una herramienta externa que gestiona los pedidos de telefonía. Dos ayudas hacen que este acoplamiento sea trazable. El Live Log muestra todo lo que la herramienta externa envía a EasyUC, lo que EasyUC hace con ello y cada respuesta que vuelve a la herramienta. Usted ve un pedido desde su recepción, pasando por el procesamiento, hasta la respuesta.

La Sync to external tool funciona en sentido contrario. EasyUC revisa cada clúster de CUCM del Enduser Setup: qué usuario tiene una configuración (Jabber, teléfono de escritorio, perfil de dispositivo) en qué clúster, y a qué ubicación y empresa pertenece. EasyUC envía este inventario como JSON, por lotes, a una dirección que usted indica. Así la herramienta externa conoce el inventario antes de lanzar pedidos. Durante este proceso el CUCM solo se lee.

Requisitos previos

Rol ROLE_APP_ADMIN. La interfaz muestra el menú Administration solo con este rol.
El módulo cucm está activado. Sin este módulo, la interfaz bloquea la página.
Hay al menos un clúster configurado en Config Clusters.
Para la sincronización: la dirección de la herramienta externa que acepta JSON por HTTPS y la autenticación que se exige allí.
El sistema EasyUC puede alcanzar esta dirección en la red.

Paso a paso: leer el registro en vivo

Seleccione el espacio de trabajo EasyUC Cisco en la cabecera.
Abra Administration → CUCM & Provisioning → Enduser Setup → Config Clusters.
Haga clic en Live Log, en la parte superior. Se abre la página External tool: live log & sync.
Deje la vista en Live para ver las entradas nuevas de inmediato, o deténgala con Paused.
Acote la lista con los filtros: dirección (Inbound, hacia EasyUC, Outbound), canal (Public API, Task, Webhook, Sync), estado (Success, Warning, Error, Info), Request ID y texto de búsqueda.
Haga clic en una entrada. La vista de detalle muestra los datos enviados, la respuesta, la sección What EasyUC did y los Headers.
Haga clic en el ID de solicitud de una entrada para ver todos los pasos de este pedido en Timeline of this order.
Use Load older entries para retroceder en el historial y Clear view para ordenar la vista.

Paso a paso: configurar y probar el destino de sincronización

En la página External tool: live log & sync, haga clic en Sync to external tool.
En la sección External tool (sync target), marque Sync target active.
Introduzca la URL of the external tool.
En Authentication, seleccione None, Basic Auth o Bearer Token e introduzca el Username y la contraseña, o el token.
Introduzca Users per batch.
Deje marcada la opción Verify TLS certificate y decida sobre Also send users without configuration.
Haga clic en Save.
Haga clic en Test connection. La página informa Connection works o Connection failed con el estado HTTP y la duración.

Paso a paso: iniciar la sincronización

En la sección Sync CUCM enduser configurations, haga clic primero en Dry run (build inventory only).
Siga la ejecución en Sync runs. Para cada clúster, la página muestra el progreso y después los contadores de usuarios, configuraciones, Jabber, teléfonos de escritorio y perfiles de dispositivo.
Haga clic en Download inventory (JSON) en la ejecución y revise el archivo.
Haga clic en Sync all CUCM enduser configs to the external tool para enviar el inventario completo, o en Send user base only para enviar los usuarios sin configuraciones.
Compruebe el contador batches sent en la ejecución y las transferencias individuales en el registro en vivo con el canal Sync.

Campos y opciones

Campos y opciones
Campo / acción	Significado y uso
Sync target active	Activa la transferencia. Valor predeterminado: desactivado. Sin un destino activo, una sincronización solo genera el inventario para su descarga.
URL of the external tool	Dirección a la que EasyUC envía el inventario. Los mensajes llevan el tipo `easyuc.enduser_config_sync`.
Authentication	None (predeterminado), Basic Auth con nombre de usuario y contraseña, o Bearer Token. Un secreto almacenado no se muestra. El campo muestra entonces unchanged.
Users per batch	Número de usuarios por mensaje. Valor predeterminado 250, permitido de 10 a 2000.
Verify TLS certificate	Valor predeterminado: activado. EasyUC verifica el certificado del destino.
Also send users without configuration	Valor predeterminado: activado. Transfiere también los usuarios que no tienen ningún dispositivo en ningún clúster.
Dry run	Genera el inventario sin enviar nada.
Contadores de la ejecución	Users, with configuration, configurations, Jabber, desk phones, device profiles y, cuando corresponda, without location mapping y batches sent.

Comprobar el resultado y acotar errores

Una prueba de conexión correcta muestra Connection works con el estado HTTP y la duración en milisegundos.
Sync runs enumera el número, el estado, el tipo, la hora y el usuario que lo inició para cada ejecución. Una ejecución de prueba está marcada como tal.
Contador without location mapping mayor que cero: estas configuraciones no coinciden con ninguna ubicación del Enduser Setup. Añada la asignación de ubicación en Config Clusters.
Un clúster aparece marcado en rojo: EasyUC no pudo leerlo. El mensaje de error se muestra junto a él. Revise la conexión con el CUCM.
Connection failed: revise la dirección, la accesibilidad, el certificado y la autenticación. El estado HTTP mostrado ayuda a acotar la causa.
El registro en vivo permanece vacío y muestra No communication yet: la herramienta externa todavía no ha enviado ninguna solicitud, o los filtros son demasiado restrictivos.
Las respuestas a los pedidos vuelven a la herramienta a través del webhook de la tarea de Enduser. Aparecen en el registro en vivo bajo el canal Webhook.