Interacción entre cliente Windows, aplicación web, IA y MCP¶
El cliente Windows, la aplicación web, los servicios de IA, MCP y Local Bridge acceden por diferentes vías técnicas a Zeta Test Management. La interfaz de Windows y web cubre las tareas funcionales de gestión de pruebas sobre la misma base de proyecto y permisos. IA, MCP e integraciones locales poseen cada uno sus propias autorizaciones y límites técnicos. Planifique cada vía de acceso como un límite propio de confianza, red y operación.
- Tareas y límites funcionales
- Arquitectura y límites de red
- Base de datos común y autorizaciones
- Inicio de sesión Active Directory y LDAP
- Conectividad backend del cliente de Windows
Tareas y límites funcionales¶
El cliente de Windows proporciona el alcance completo de escritorio e integraciones locales. La aplicación web ofrece espacios de trabajo especializados, administrativos y de IA basados en navegador. MCP automatiza capacidades compartidas de lectura y escritura a través de los mismos servicios especializados que el chat web. Local Bridge complementa únicamente con acciones locales permitidas por la TI del cliente.
Una comparación compacta se encuentra en Funciones en Windows, Web, IA y MCP. La configuración y manejo de las nuevas funciones se describen en IA y automatización.
Arquitectura y límites de red¶
- El navegador se conecta mediante HTTPS al host de la aplicación web. No necesita acceso directo a las comparticiones de archivos de base de datos o proyecto.
- El cliente de Windows se conecta a un backend central según el modelo operativo o utiliza una variante local de backend compatible.
- Las áreas de trabajo de IA utilizan la pasarela neutral del proveedor del lado del servidor. Los puntos finales del proveedor y los secretos permanecen en la administración del servidor; las zonas de datos y el egreso se autorizan expresamente.
- MCP utiliza el host web a través de
POST /mcpy una verificación propia de clave API. La clave MCP no es equivalente a la clave backend del cliente Windows. - Local Bridge conecta Chrome o Edge mediante una extensión del navegador con un host nativo de mensajería local. El servidor web no inicia comandos locales libres; la política de TI solo permite acciones nombradas.
No publique ni la base de datos ni las carpetas compartidas del proyecto directamente en Internet. Utilice HTTPS controlado, reglas de firewall y, si es necesario, VPN o proxy inverso. Documente los flujos de datos, zonas de datos, cuentas de servicio y límites de confianza antes de la puesta en marcha.
Base de datos común y autorizaciones¶
La aplicación de Windows y la aplicación web trabajan dentro de los límites configurados del proyecto con la misma base de datos funcional. Sin embargo, el navegador, el proveedor de IA y MCP no acceden directamente a la base de datos ni a los archivos del proyecto, sino a través de los componentes de servidor previstos y servicios funcionales filtrados por permisos.
Un inicio de sesión válido o la verificación de clave API no sustituyen permisos de proyecto, rol u objeto. Para IA también deben coincidir activación global, asignación de escenario, compartición de datos y permiso de IA en el proyecto. Las acciones de escritura verifican permisos y versión del objeto nuevamente al confirmar.
Separe los archivos del programa, los datos del proyecto, la base de datos y las copias de seguridad. Asigne a las cuentas técnicas solo los permisos necesarios y no almacene secretos ni en la documentación ni en los registros de diagnóstico.
Inicio de sesión Active Directory y LDAP¶
Dependiendo de la configuración del proyecto y del servidor, los usuarios pueden autenticarse mediante cuentas de proyecto integradas o un directorio LDAP conectado. El host web o el componente de aplicación responsable debe poder acceder al servicio de directorio desde su zona de red; los roles y derechos del proyecto se siguen evaluando en Zeta Test Management.
No es estrictamente necesario un mecanismo IIS propio para NTLM o Kerberos, siempre que la aplicación gestione el inicio de sesión LDAP. Si su arquitectura objetivo prevé autenticación Windows, inicio de sesión único o un proxy de identidad previo, esta variante debe planificarse y aprobarse por separado. Prefiera conexiones LDAP cifradas y verifique la confianza del certificado, resolución de grupos y comportamiento ante fallos.
Conectividad backend del cliente de Windows¶
El cliente de Windows puede configurarse para una URL central del backend con la clave API correspondiente. Introduzca los valores en las opciones del programa previstas para ello o en una configuración gestionada, utilice exclusivamente HTTPS y emplee en la documentación solo marcadores de posición como https://backend.example.org/ y <backend-api-key>.
En los modos de operación locales compatibles, el cliente actual puede iniciar un host Kestrel local incluido para operaciones locales sin una URL central de backend configurada. Esta variante local no es una recomendación para abrir un servicio sin control hacia el exterior. El acceso a la red, el enlace, los certificados y el ciclo de vida deben ajustarse al modelo de operación elegido.
La clave API del backend del cliente Windows y una clave API MCP cumplen funciones diferentes y no deben confundirse ni reutilizarse. Proteja y rote ambos secretos, no registre valores completos y bloquee las claves que ya no se necesiten.
Vistas integradas en el cliente Windows¶
La vista general y los detalles en la ventana principal, la visualización del caso de prueba durante la ejecución y la vista previa de revisión son proporcionados por el backend configurado como páginas independientes y sin marco. Permanecen visibles en la ventana de Windows. Para ello se utiliza el mismo host local Kestrel o el host IIS central que para la conexión con el backend; no se requiere un servidor web adicional de Windows.
El inicio de sesión existente en Windows se transfiere una sola vez a la vista integrada. Proyecto, usuario y permisos de objeto se verifican en el servidor. Si la transferencia falla, aparece el inicio de sesión web con el destino original. Otro usuario conectado no recibe derechos del usuario de Windows. El cliente de Windows y el backend deben usar versiones compatibles del programa.
Si falta la conexión al backend, la vista no puede recargarse. Restablezca la conexión y utilice Intentar de nuevo o seleccione nuevamente el nodo del árbol. Una revisión solo puede guardarse después de que se haya cargado su vista previa; los contenidos del caso de prueba modificados entre tanto requieren una nueva vista previa.
También las vistas previas Markdown, imágenes en línea e informes HTML utilizan el host central. Para contenidos de imagen aún no guardados, Windows solo transfiere imágenes del proyecto a una vista previa temporal. Un solo archivo de imagen no debe superar los 8 MiB; por transferencia se permiten 256 archivos y un total de 24 MiB. Las imágenes sobredimensionadas o no compatibles se rechazan con un mensaje. Reduzca el tamaño de dichas imágenes y abra la vista previa nuevamente. El servidor no accede a rutas de archivos locales arbitrarias del equipo Windows.
La configuración del proyecto para ocultar enlaces opcionales Abrir en la web no afecta estas vistas básicas integradas. Los diálogos nativos de edición y el diseñador de informes permanecen funciones de Windows. Las plantillas de informes HTML propias deben estar disponibles en el backend configurado; las adaptaciones locales de las plantillas estándar anteriores no se evalúan en las nuevas páginas integradas.
Las exportaciones PDF desde la vista previa del informe HTML utilizan el documento ya cargado. Espere hasta que la vista previa esté completamente cargada; durante la exportación, actualizar y otras exportaciones están bloqueadas. Si la exportación falla, se conserva un archivo de destino existente.