Importante: Los datos de acceso (SSO Start URL, regiones, usuario(s) de RDP/MSSQL, etc.) se entregan por separado mediante un enlace de uso único.
Antes de empezar
1) Activa tu usuario en IAM Identity Center
Si aún no lo hiciste, sigue este artículo (paso a paso):
https://ayuda.guit.mx/es/articles/14824821-activacion-de-usuario-en-aws-iam-identity-center
2) Descarga el Launcher
Recibirás un enlace para descargar el archivo. Recomendaciones:
Descarga el ZIP / EXE desde el enlace oficial compartido por GUITMX.
Extrae el ZIP a una carpeta local (ej. Escritorio).
Si Windows muestra un aviso de seguridad, haz:
Clic derecho al ZIP o EXE → Propiedades → marca Desbloquear (si aparece) → Aplicar.
Requisitos (en tu equipo)
Windows 10/11 (recomendado).
Cliente de Escritorio remoto (mstsc) (viene incluido en Windows).
SQL Server Management Studio (SSMS) si vas a usar la opción MSSQL.
El Launcher valida lo necesario al momento de usar cada opción. Si algo falta, te lo indicará.
Flujo general del Launcher
Paso 1: Abre el Launcher e ingresa parámetros
En la pantalla principal, captura (desde tu enlace de Keeper):
SSO Start URL
SSO Region (normalmente
us-east-1, pero usa la que te entregó GUITMX)AWS Region (la región donde vive la instancia a la que te conectarás)
Paso 2: Inicia sesión (Device Authorization)
Al presionar "Login + Refresh" verás:
un User code
un Verify URL (se abrirá el navegador)
Completa el login en el navegador y regresa al Launcher.
Paso 3: Cargar instancias y capacidades
Una vez autenticado, el Launcher mostrará la lista de instancias disponibles para tu usuario, identificadas por:
FriendlyName (cuando está disponible)
Estado (running/stopped)
Capabilities (por ejemplo: RDP, MSSQL, SSH)
Las capabilities disponibles dependen de tu usuario y de lo que GUITMX habilitó en cada instancia.
Encender una instancia (START) — sin conectarte
A veces solo necesitas encender una máquina (por ejemplo un bastión) sin entrar por RDP o MSSQL. Para esto existe el botón:
START (Encender)
Selecciona una instancia que esté stopped
Presiona START
El Launcher intentará encenderla y te mostrará su progreso:
Starting...Running...Ready(cuando ya esté lista)
Restricción importante (control de gasto)
No todas las instancias están autorizadas para encenderse automáticamente.
Esto es un control de costos/horas de EC2.
Si una máquina no está autorizada para autostart:
El botón START puede aparecer deshabilitado, o
El Launcher mostrará que no se puede completar la acción
En ese caso:
No lo intentes repetidas veces
Genera un Support Bundle (ver abajo) y contacta a GUITMX
Conexión por RDP (Windows)
¿Qué hace el Launcher?
Establece un túnel seguro a la instancia (sin abrir 3389 públicamente).
Abre el cliente de Escritorio remoto.
¿Cómo conectarte?
Selecciona la instancia que tenga capability RDP.
Presiona RDP.
Se abrirá el cliente de Escritorio remoto.
Ingresa tus credenciales de Windows (las que recibiste por Keeper).
Botón “Copy RDP”
Si necesitas copiar datos para soporte o para pegar manualmente:
Usa Copy RDP para copiar la dirección local (ej.
localhost:<puerto>).
Conexión a SQL Server con SSMS (MSSQL)
¿Qué hace el Launcher ?
Establece un túnel seguro hacia SQL Server (sin abrir 1433 públicamente).
Abre SSMS y pre-llena únicamente el “Nombre del servidor”.
No fuerza “Authentication” ni “Trust server certificate”. Esos ajustes quedan en tus manos.
¿Cómo conectarte?
Selecciona la instancia con capability MSSQL.
Presiona MSSQL.
Se abrirá SSMS y verás el cuadro Conectar al servidor.
Verifica que en “Nombre del servidor” tengas algo como:
tcp:127.0.0.1,<puerto>
Selecciona:
Authentication según el usuario entregado (normalmente “SQL Server Authentication” si te dieron usuario/clave SQL).
Si SSMS muestra error de certificado, marca:
Certificado de servidor de confianza (Trust server certificate)
Conéctate.
Botón “Copy SQL”
Si necesitas copiar el nombre de servidor para pegarlo manualmente o para soporte:
Usa Copy SQL para copiar
tcp:127.0.0.1,<puerto>.
¿Qué pasa si la instancia está apagada y quieres conectarte?
Si la instancia está stopped, el Launcher intentará encenderla como parte del flujo de conexión (RDP o MSSQL).
Si está autorizado: iniciará la máquina, esperará a que esté lista y luego continuará con tu conexión.
Si no está autorizado: no podrá encenderla y tendrás que contactar a GUITMX (control de gasto).
Si tu intención era solo encenderla (sin conectarte), usa el botón START.
Support Bundle (para soporte técnico)
El Launcher incluye un botón Support Bundle pensado para acelerar soporte.
¿Cuándo usarlo?
AccessDenied / permisos
La instancia no arranca (o START no está permitido)
No carga lista de instancias
RDP/SSMS no abre
Fallas de túnel / conexión intermitente
¿Qué hace?
Genera un ZIP con:
logs del Launcher
versiones detectadas (cuando aplica)
estado/capabilities detectadas
información útil para diagnóstico
¿Cómo usarlo?
Reproduce el problema (o intenta conectar / encender).
Presiona Support Bundle.
Se generará un archivo ZIP (normalmente en Escritorio o en una ruta indicada por el Launcher).
Envíalo a GUITMX junto con una breve descripción del problema.
Situaciones comunes y qué hacer
1) “AccessDenied” al conectar o al encender
Significa que tu usuario no tiene permisos para esa acción (RDP/MSSQL/START) o para esa instancia.
Verifica que seleccionaste la instancia correcta.
Si persiste, genera Support Bundle y envíalo a GUITMX.
2) SSMS abre pero no conecta y muestra error de certificado
Marca Certificado de servidor de confianza en SSMS.
Si tu usuario es SQL:
selecciona “SQL Server Authentication” e ingresa usuario/clave.
3) La instancia aparece “stopped” y no arranca (o START deshabilitado)
Puede ser un control intencional de costos.
Genera Support Bundle y notifica a GUITMX para que autoricen/realicen el arranque.
4) No aparece ninguna instancia en la lista
Puede ser que tu usuario aún no tenga asignaciones correctas o que falte activar/propagar permisos.
Confirma que completaste la activación de Identity Center.
Genera Support Bundle y envíalo a GUITMX.
Buenas prácticas (para usuarios)
No compartas tus credenciales. Usa exclusivamente las entregadas por GUITMX.
Si algo falla, no adivines: genera Support Bundle y compártelo con GUITMX.
Si SSMS marca error de certificado, recuerda la regla:
marca Trust server certificate (Certificado de servidor de confianza)
Si el Launcher no puede arrancar una máquina, notifícalo a GUITMX (control de costo/horas EC2).
¿Necesitas ayuda?
Si algo no funciona, adjunta siempre:
Support Bundle
Nombre de la instancia (FriendlyName)
Qué intentabas hacer: START, RDP o MSSQL
Mensaje de error exacto (si lo hubo)
Con eso GUITMX puede resolverlo mucho más rápido.