Saltar al contenido
MoftgateMoftgate Docs
Guía del producto

mg Desktop

Aplicación de escritorio de Moftgate Center: gestione dispositivos, alertas, scripts y automatizaciones con los mismos perfiles y tokens que el CLI mg.

Qué es mg Desktop#

Moftgate Desktop es la contraparte gráfica del CLI mg. Es una aplicación independiente para Windows y macOS que se comunica con su Center mediante la misma API, de modo que las operaciones que un ingeniero realiza en el terminal quedan disponibles para un operador que prefiere una ventana: listar dispositivos, triar alertas, ejecutar scripts y seguir ejecuciones de automatización.

Las dos herramientas no son mundos separados. Moftgate Desktop reutiliza el propio cliente del CLI: las mismas definiciones de perfil, el mismo almacén de tokens y el mismo flujo de aprobación del navegador. Un perfil creado con mg profile create aparece en la aplicación, e iniciar sesión desde cualquiera de los dos lados sirve para ambos.

PantallaEquivalente en CLIQué hace allí
Devicesmg device list / inspect / exportBuscar, filtrar por estado y SO, ordenar, inspeccionar un dispositivo, exportar CSV.
Alertsmg alert list / inspect / resolveFiltrar alertas, leer el detalle, resolver con confirmación.
Scriptsmg script list / runEjecutar un script guardado o un comando ad hoc en un dispositivo, grupo o etiqueta.
Automation Runsmg run list / inspect / cancel / retrySeguir ejecuciones, cancelar una en curso, reintentar una fallida.
Profiles & Authmg profile … / mg auth …Añadir perfiles de Center, iniciar sesión desde el navegador, cerrar sesión.
La pantalla Devices con el selector de perfil y la insignia de sesión en la cabecera y el menú de secciones a la izquierda.
Ventana principal de Moftgate Desktop
Cerrar imagen
Una aplicación de escritorio independiente
No es una página dentro de la consola de Moftgate. Se instala en la estación de trabajo de un administrador y no se despliega en los endpoints gestionados.

Descarga e instalación#

Instalador de mg Desktop

Esta plataforma está en verificación final y se publicará próximamente.

Próximamente
  1. 1
    Instale la aplicación

    En Windows ejecute el instalador (se publica también un MSI para despliegue por GPO o Intune). En macOS abra el .dmg y arrastre Moftgate Desktop a Aplicaciones. No se instala ningún agente ni servicio adicional: es una herramienta de operador para una estación de gestión.

  2. 2
    Añada un perfil para su Center

    Abra Profiles & Auth y haga clic en New profile. Introduzca un nombre y la URL de su Center, por ejemplo https://center.example.local. Marque Skip TLS certificate verification solo para un Center on-premises que aún use un certificado autofirmado.

  3. 3
    Inicie sesión desde el navegador

    Haga clic en Sign in en la tarjeta del perfil. El navegador abre la misma página de aprobación que usa el CLI; tras aprobar, el token se guarda localmente y la tarjeta muestra Token stored.

  4. 4
    Empiece a trabajar

    El menú lateral abre Devices, Alerts, Scripts y Automation Runs. El selector de perfil de la cabecera cambia entre Centers sin cerrar sesión.

Perfiles e inicio de sesión#

Un perfil es un Center: un nombre, una URL y su propio token. Profiles & Auth es donde los añade, elige cuál es el predeterminado, inicia sesión y cierra sesión. El selector de perfil de la cabecera cambia toda la aplicación entre Centers.

Cada tarjeta de perfil muestra su URL y si hay un token guardado, además de Make default, Sign in o Sign out, y Delete.
Pantalla de perfiles y autenticación
Cerrar imagen

Sign in abre la página de aprobación en el navegador y espera. Apruébela como el usuario de Center cuyos permisos debe tener la sesión; la aplicación guarda el token emitido y la cabecera muestra quién ha iniciado sesión. Si el navegador no se abre solo, el diálogo muestra el enlace de aprobación y el código de verificación para abrirlo manualmente.

La aplicación consulta al Center hasta que usted aprueba la solicitud en el navegador.
Diálogo de inicio de sesión esperando la aprobación del navegador
Cerrar imagen
Compartido con el CLI
Cerrar sesión desde la aplicación revoca el token en el Center y elimina la credencial local, lo que también termina la sesión del CLI mg en el mismo perfil. Eliminar un perfil lo quita para ambas herramientas.

Dispositivos#

Devices es la vista de inventario: los endpoints que reportan al Center seleccionado, con los filtros y el registro de detalle que de otro modo obtendría con mg device list y mg device inspect.

  • La búsqueda se ejecuta en el servidor contra hostname e IP, de modo que una flota grande se filtra antes de dibujarse.
  • Los filtros de estado y sistema operativo usan los mismos valores que la consola; la columna de SO muestra un icono en lugar de texto.
  • Hostname, Last Seen y Compliance son ordenables, y la paginación es del lado del servidor.
  • Al hacer clic en una fila se abre el registro completo del dispositivo — grupos, etiquetas, perfil de agente, versión del agente — con un botón Copy JSON.
  • Export CSV aplica los filtros activos y pregunta dónde guardar el archivo, luego informa cuántos dispositivos se escribieron.
Búsqueda, filtros de estado y SO, columnas ordenables y paginación del lado del servidor sobre la flota.
Lista de dispositivos con filtros aplicados
Cerrar imagen

Alertas#

Alerts se abre en las activas. Filtre por estado o por dispositivo, abra una fila para leer la alerta completa con su evidencia y resuélvala desde el detalle. Resolver pide confirmación primero y se registra en el log de auditoría del Center a nombre de su usuario.

Una alerta activa abierta desde la lista, con Resolve disponible en el diálogo de detalle.
Lista de alertas y detalle de alerta
Cerrar imagen

Scripts#

Scripts lista la biblioteca de scripts y es donde comienza la ejecución. Puede ejecutar un script guardado o escribir un comando ad hoc, y apuntar a un dispositivo, un grupo de endpoints o una etiqueta.

  1. 1
    Elija qué ejecutar

    Haga clic en una fila de la lista de scripts para ejecutar un script guardado, o use Run command para un comando ad hoc. En un comando ad hoc puede dejar el idioma vacío y dejar que decida el sistema operativo de destino, o fijarlo a shell o powershell.

  2. 2
    Elija el objetivo

    Seleccione Device, Endpoint group o Tag e introduzca el identificador, luego fije el timeout y decida si la ejecución debe esperar a los endpoints que están fuera de línea.

  3. 3
    Confirme antes de ejecutar

    Review & run abre una confirmación que detalla qué se ejecutará y dónde. Como esto ejecuta código en los endpoints, debe escribir RUN para habilitar el botón.

  4. 4
    Siga el resultado

    El toast informa cuántos objetivos recibieron el trabajo. Abra Automation Runs para ver cómo cada endpoint reporta éxito o fallo.

Tipo de objetivo, objetivo, timeout y el interruptor de espera para endpoints fuera de línea, antes del paso de confirmación.
Diálogo de ejecución de script
Cerrar imagen
Esto ejecuta código en los endpoints
Un objetivo de grupo o etiqueta puede alcanzar gran parte de la flota en una sola acción. El paso de confirmación indica qué se ejecutará y dónde, y le pide escribir RUN — léalo antes de confirmar.

Ejecuciones de automatización#

Cada ejecución — un script que usted inició aquí o una automatización que disparó el Center — produce un run. Esta pantalla es el registro de qué se ejecutó, dónde y cómo terminó. Filtre por estado o dispositivo, abra una ejecución para ver su detalle por acción, cancele una en curso o reintente una fallida.

Cancel se ofrece mientras la ejecución sigue en curso, y Retry una vez que ha fallado o se ha cancelado.
Lista de ejecuciones y detalle de ejecución
Cerrar imagen
La cancelación es definitiva
Cancelar detiene la ejecución en el endpoint y no se puede deshacer. Retry no reanuda la ejecución anterior: pone en cola una nueva con los mismos parámetros.

Seguridad y auditoría#

  • La app de escritorio no tiene un almacén de credenciales aparte: lee y escribe el mismo archivo de perfiles y de token que usa el CLI mg, y el token se crea con el mismo flujo de aprobación del navegador.
  • Un token hereda el rol del usuario que lo aprobó. Los usuarios de solo lectura pueden listar e inspeccionar; resolver una alerta, ejecutar un script o cancelar una ejecución requiere permiso de escritura.
  • Cada acción de escritura queda registrada en el log de auditoría del Center a nombre del usuario que aprobó, igual que cuando la misma acción se realiza desde el CLI.
  • Resolver una alerta, cancelar o reintentar una ejecución, eliminar un perfil y ejecutar un script requieren confirmación explícita; las ejecuciones de scripts y la eliminación de perfiles piden escribir una palabra de confirmación.
  • La aplicación solo puede escribir el archivo CSV que usted elige en el diálogo de guardado. No tiene ningún otro acceso al sistema de archivos ni al shell.
  • Skip TLS certificate verification existe para Centers on-premises con certificados autofirmados durante la instalación. Déjelo desactivado en producción: un cliente que omite la verificación puede ser dirigido al servidor de un atacante y entregarle un token válido.
shell
mg profile list
mg auth status
mg auth logout

Los comandos anteriores inspeccionan o terminan la misma sesión que usa la aplicación de escritorio, lo que resulta útil cuando quiere confirmar desde un terminal qué perfil está activo y a quién pertenece el token guardado.

Preguntas frecuentes#

¿Necesito también el CLI mg instalado?
No. Moftgate Desktop es una aplicación independiente que se comunica con su Center mediante la misma API. Si tiene el CLI instalado, ambos comparten perfiles y tokens: un perfil creado en uno aparece en el otro, y con iniciar sesión una vez basta para los dos.
¿En qué plataformas funciona?
Windows y macOS. Windows se distribuye como instalador ejecutable y como MSI para despliegue por GPO o Intune; macOS se distribuye como .dmg. Se instala en la estación del administrador, no en los endpoints gestionados.
¿Necesita una licencia aparte?
No. Se autentica contra su Center existente con un token del flujo de aprobación del navegador y hereda los permisos del usuario que aprobó.
¿Puedo gestionar más de un Center desde la aplicación?
Sí. Añada un perfil por Center — producción, staging, un tenant de cliente — y cambie con el selector de perfil de la cabecera. Cada perfil conserva su propia URL y su token.
¿Es lo mismo que la Fleet Discovery & Rescue Tool?
No. La herramienta Fleet descubre máquinas en la red e instala, elimina o reconfigura agentes mediante WinRM y SSH. Moftgate Desktop gestiona una flota que ya reporta a su Center, a través de la API del Center.
¿Funciona con un Center on-premises con certificado autofirmado?
Sí. Marque Skip TLS certificate verification en el perfil. Trátelo como una comodidad de instalación y pase a un certificado de confianza antes de usarlo en producción.