# Manual de uso de IA Gobernanza — versión para usuarios sin perfil técnico > Este manual le acompaña desde su primer ingreso hasta el uso diario de la plataforma. No necesita conocimientos técnicos. Cuando una tarea requiera a una persona técnica de su empresa (por ejemplo, conectar un modelo de IA que ya tienen instalado), se lo indicamos claramente. > > Versión del documento: 1.0 · Corresponde a la plataforma IA Gobernanza (Marketing de Inteligencia Artificial S de RL de CV). Contacto: info@iagobernanza.com · WhatsApp 33 4280 2102. --- ## 0. ¿Qué hace IA Gobernanza, en una frase? Vigila y controla los sistemas de inteligencia artificial de su empresa: detecta cuando alguien intenta manipularlos, evita que salgan datos personales de sus clientes, deja constancia firmada de cada decisión y, si hace falta, **apaga un modelo con un botón (Kill Switch)**. **Lo que NO hace:** no es un antivirus, no detecta virus ni correos falsos (phishing), no sustituye a su equipo de seguridad informática. Su terreno es la capa de inteligencia artificial. --- ## 1. Primer ingreso (onboarding) — 10 minutos ### Paso 0. La pantalla de PIN (acceso controlado al sitio) La página pública de IA Gobernanza sólo se muestra a **visitantes autorizados**: al entrar verá únicamente el logo, el nombre y un recuadro para un **PIN**. Si le entregaron un PIN (prospectos, aliados, auditores), escríbalo y pulse **“Entrar”**; el acceso dura hasta 24 horas. Si usted es **operador de una empresa cliente no necesita PIN**: pulse **“Soy operador de una empresa cliente”** y pasará directo al inicio de sesión. Para solicitar un PIN escriba a info@iagobernanza.com. ### Paso 1. Entre al panel 1. Abra la página principal y pulse **“Ir al Panel →”** (arriba a la derecha). Enlace directo: [Ir al panel](/?view=dashboard). 2. Escriba su **correo corporativo** y la **contraseña** que le entregó su administrador. 3. Pulse **“Entrar al panel”**. > Si aparece “Credenciales inválidas”, revise mayúsculas y espacios. Tras 5 intentos fallidos en un minuto el sistema espera unos segundos por seguridad. ### Paso 2. Active su segundo factor (MFA) — obligatorio para administradores y operadores Al entrar por primera vez verá una ventana **“Activar MFA”** que no se puede cerrar hasta completar el proceso. Es normal: sin el segundo factor sólo podrá **ver**, no **cambiar** nada. 1. Instale en su teléfono una app de autenticación gratuita: **Google Authenticator**, **Microsoft Authenticator** o **Authy**. 2. En la ventana de la plataforma pulse **“Comenzar”**. Aparecerá un **código QR** y, debajo, una clave en letras. 3. En la app del teléfono elija **“+” → Escanear código QR** y apunte al QR de la pantalla. 4. La app mostrará un **número de 6 dígitos que cambia cada 30 segundos**. Escríbalo en la casilla y pulse **“Confirmar”**. 5. La plataforma le mostrará **8 códigos de recuperación**. **Guárdelos ahora** (impresos o en un gestor de contraseñas). No se volverán a mostrar. Sirven si pierde el teléfono. 6. Pulse **“Listo”**. El botón con la llave en la parte superior cambiará a color verde: su cuenta ya está protegida. > ¿Perdió el teléfono? Al iniciar sesión pulse **“Usar código de recuperación”** y escriba uno de los 8 códigos (cada uno sirve una sola vez). Después pida a otro administrador que reinicie su MFA para volver a enrolar su nuevo teléfono. ### Paso 3. Reconozca su rol En la esquina superior derecha verá su nombre y rol: | Rol | Qué puede hacer | |---|---| | **Auditor (viewer)** | Ver todo, no cambiar nada. Ideal para auditoría externa. | | **Operador (operator)** | Además, atender incidentes, probar conectores, simular ataques, disparar el Kill Switch. | | **Administrador (admin)** | Además, crear políticas, modelos, conectores, usuarios, llaves y **reactivar** un modelo apagado. | ### Paso 4. Recorra el panel de arriba hacia abajo El panel es una sola página larga. Estas son sus secciones, en orden: 1. **Sistemas de IA bajo gobernanza** — sus modelos y el botón de Kill Switch. 2. **Incidentes en tiempo real** — lo que la plataforma detectó y bloqueó. 3. **Políticas vigentes** — las reglas activas según el marco legal que elija (LFPDPPP, LGPD, EU AI Act, etc.). 4. **Conectores de IA · Modelos híbridos** — sus modelos DeepSeek/Qwen/Llama propios o en la nube, protegidos por el proxy. 5. **AI Threat Shield** — ataques a la capa de IA (inyección de instrucciones, jailbreak, fugas). 6. **API pública / Gestión de API Keys** — llaves para que sus sistemas hablen con la plataforma (zona técnica). 7. **Webhooks de salida** — avisos automáticos a su equipo de seguridad (zona técnica). 8. **Heartbeat & Dead Man’s Switch** — comprueba que su sistema sigue “vivo” y protegido. 9. **Agente de monitoreo normativo** — analiza cambios regulatorios y propone ajustes de políticas. 10. **Manual de operaciones** — este documento y su versión técnica, descargables. --- ## 2. Servicio por servicio: cómo se usa ### 2.1 Registrar los modelos de IA de su empresa **Para qué:** que la plataforma sepa qué sistemas de IA existen (un chatbot de atención, un scoring de crédito, un asistente interno…) y pueda protegerlos. 1. Vaya a **“Sistemas de IA bajo gobernanza”**. 2. Pulse **“Registrar modelo”** (solo administrador). Escriba un nombre claro (“Chatbot de cobranza”), el proveedor y el sector de riesgo. 3. Guarde. El modelo aparece en la lista con estado **Activo** y su Kill Switch en modo **Alerta** (avisa, no apaga). Un administrador puede cambiarlo a modo **Bloqueo** (apaga de verdad) cuando el sistema esté maduro. ### 2.2 Kill Switch (apagado de emergencia) **Qué es:** un control para el tráfico integrado a un modelo. Puede dispararse automáticamente por una regla crítica inmediata **o** por confianza y persistencia; no requiere siempre tres capas simultáneas. - **Disparar a mano:** operator o admin. Un operator conserva el modo configurado: **Alerta** registra sin bloquear, **Bloqueo** detiene el camino integrado. Sólo admin puede modificar el modo, automatización y umbral. - **Reactivar:** sólo admin con los controles MFA aplicables y motivo de al menos 10 caracteres. Se registra y notifica el cambio. > No apaga procesos externos que no consulten la plataforma. Amenazas persistentes o fugas críticas del Gateway pueden activar el control según política; no se garantiza ausencia de falsos positivos. ### 2.3 Políticas y marco legal 1. Arriba del panel, en el selector de **marco normativo**, elija el que aplique a su empresa (México LFPDPPP, Brasil LGPD, UE AI Act, etc.). 2. En **“Políticas vigentes”** verá las reglas cargadas para ese marco (por ejemplo, “no enviar datos personales sin anonimizar”). 3. Un administrador puede crear políticas adicionales desde la sección de políticas; los operadores y auditores solo las consultan. ### 2.4 Conectores de IA — usar DeepSeek, Qwen, Kimi, Llama u otros modelos con protección **Para qué:** muchas empresas ya usan modelos abiertos instalados en sus propios servidores (Ollama, vLLM) o contratados por uso (Fireworks AI, DeepSeek API). El **Conector** pone la protección de IA Gobernanza **delante** de ese modelo sin cambiar su programa: su equipo técnico solo cambia una dirección web. **Lo que usted (no técnico) debe saber y decidir:** 1. **¿El modelo corre en su empresa o fuera?** La tarjeta del conector lo dice: **“Infraestructura Local”** (los datos no salen de su red) o **“Nube Externa”** con la bandera del país donde se procesan (🇺🇸 EE.UU., 🇨🇳 China, 🇪🇺 UE). 2. **Riesgo mostrado:** **bajo**, **medio** o **alto**. “Alto” significa que enviar datos personales a ese país requiere cuidados legales (por ejemplo, China no tiene reconocimiento de adecuación en RGPD). La plataforma lo indica; su área legal decide. 3. **Protección ZK “Activa”:** tokeniza los patrones de datos personales detectados antes del envío al proveedor externo y restaura tokens conocidos para el solicitante. No detecta toda PII posible. Un Gateway alojado recibe el texto antes de tokenizarlo; para tokenizar dentro de su red use SDK o muro local. 4. **Entrega posterior a auditoría:** la respuesta se retiene completa antes de revisarla y entregarla, incluso con `stream:true`. No aparecerá texto token a token. El límite es 2 MB y 120 s de lectura del cuerpo; errores o cierres incompletos se rechazan. No es una garantía contra todo contenido dañino. **Cómo se agrega un conector (administrador, con ayuda técnica para la dirección web):** 1. Vaya a **“Conectores de IA”** y pulse **“Agregar conector”**. 2. Escriba un **nombre** (“DeepSeek R1 servidor local”). 3. Elija el **tipo de proveedor** (Ollama, vLLM, Fireworks, DeepSeek API…). La dirección web se llena sola; su técnico la ajusta si el servidor está en otra máquina. 4. Si el proveedor lo exige, pegue la **API key** (una contraseña larga que le entrega el proveedor). Puede verla u ocultarla con el ojo. **Solo se guarda cifrada y no se volverá a mostrar.** 5. Deje encendidos los tres interruptores de **Seguridad instantánea** (enmascaramiento LFPDPPP, auditoría antimanipulación, auditoría ISO/IEC 42001) y elija la **sensibilidad del Kill Switch** (Medio es un buen inicio). 6. Opcional: escriba **palabras prohibidas** (cosas que el modelo jamás debe decir: nombres de competidores, promesas de garantía…) y **términos confidenciales** (nombres de proyectos secretos). Estos últimos se guardan cifrados como huella, nunca en claro. 7. Pulse **“Crear y probar conexión”**. La tarjeta pasará a **“En línea”** si el modelo respondió. Si dice **“Sin conexión”** o **“Configuración requerida”**, pase la tarjeta a su técnico (ver sección 4). 8. Entregue a su equipo técnico el recuadro **“Apunte su aplicación al Gateway”** que aparece debajo: contiene la dirección y el ejemplo que ellos necesitan. **Qué verá funcionando:** en la parte alta de la sección, cuatro contadores del día: **datos sensibles anonimizados**, **intentos de fuga/ataques bloqueados**, **latencia añadida por el proxy** (milisegundos que suma la revisión) y **peticiones auditadas**. Debajo, la tabla **“Últimos incidentes detectados por el proxy”**. ### 2.5 AI Threat Shield — ataques a la capa de IA **Qué detecta:** intentos de que la IA “ignore sus instrucciones”, se haga pasar por otra sin límites (jailbreak), revele sus instrucciones internas, extraiga datos en masa o sea bombardeada por robots. **Qué debe hacer usted:** 1. Revise la sección con frecuencia (se actualiza sola cada 15 segundos). 2. Cada fila muestra el tipo de amenaza, su gravedad y cuántas veces ocurrió. **No** muestra el texto del atacante (por diseño solo se guardan huellas). 3. Si es operador, pulse **“Reconocer”** cuando haya visto el incidente y **“Resolver”** cuando su equipo lo haya atendido, escribiendo una nota breve. 4. Puede pulsar **“Simular red-team”** (operador) para ver cómo la plataforma bloquea seis ataques de ejemplo sin afectar a sus modelos. ### 2.6 Llaves (API keys), Webhooks, Heartbeat — zona técnica Estas tres secciones las usa su equipo técnico. Lo que le conviene saber: - **API keys:** son las “credenciales” con las que los sistemas de su empresa se conectan. Un administrador las crea, les pone fecha de caducidad y puede **revocarlas** al instante si sospecha una fuga. - **Webhooks:** avisos automáticos firmados que llegan al equipo de seguridad (Splunk, Sentinel, QRadar u otro). Si ve el estado **“fallando”**, su técnico debe revisar el receptor. - **Heartbeat / Dead Man’s Switch:** su sistema debe “latir” cada minuto. Si deja de hacerlo, la plataforma lo marca como **stale** (sin señal) y avisa. ### 2.7 Asistente normativo sobre corpus local Analiza una consulta contra un conjunto **acotado y estático** de extractos normativos y propone cambios. No hay vigilancia continua DOF/RSS conectada. Las citas se contrastan con ese corpus; esto no garantiza origen oficial, vigencia ni ausencia de alucinaciones. Las propuestas requieren aprobación humana y revisión jurídica. ### 2.7b Aprobaciones humanas y Cuatro Ojos - Una acción integrada que coincide con una regla sensible queda en PAUSE; no debe ejecutarse hasta que exista autorización válida. - El rol exigido está indicado por la regla: un Aprobador Operativo no puede resolver solicitudes reservadas a Gobernanza Admin. El cargo humano es una etiqueta descriptiva, no un permiso adicional. - Con Cuatro Ojos, proponer edición, pausa, reactivación o eliminación **no cambia la configuración vigente**. Se requiere un segundo Gobernanza Admin; el proponente no puede validar su propio cambio. - Abra **Revisar cambio propuesto** y use **Validar** o **Descartar** con reautenticación. Debe resolverse la propuesta pendiente antes de crear otra. Si aparece conflicto, actualice y revise el estado, no asuma que su decisión ganó. - Desactivar Cuatro Ojos también requiere segunda validación. La protección sigue activa mientras se decide. - El token emitido no implementa consumo de uso único en el servidor; la herramienta ejecutora debe respetar la decisión y validar su autorización. ### 2.8 Bitácora, Trust Center y estado del servicio - Cada acción relevante queda en una **bitácora encadenada** (cada registro incluye la huella del anterior; si alguien altera uno, la cadena se rompe y se detecta). Un auditor puede verificarla desde el panel. - [Trust Center](/trust): qué controles existen realmente y cuáles están en hoja de ruta. No afirmamos certificaciones que no tenemos. - [Estado del servicio](/status): disponibilidad medida. - [Términos](/legal/terminos) · [Aviso de privacidad](/legal/privacidad). --- ## 3. Alertas y avisos: qué significan y qué hacer | Lo que ve | Qué significa | Qué hacer | |---|---|---| | Mensaje **“El servicio de su empresa está inactivo / suspendido”** al iniciar sesión | El contrato o la mensualidad de su empresa venció, o IA Gobernanza suspendió el servicio. Ningún usuario de su empresa podrá entrar y las integraciones (API keys, Gateway) responderán error 403. | Contacte a su administrador de contrato y a IA Gobernanza (info@iagobernanza.com · WhatsApp 33 4280 2102). Al regularizar, el acceso se reactiva de inmediato. | | Ventana **“Activar MFA”** que no se cierra | Su rol exige segundo factor y aún no lo tiene. | Complete el enrolamiento (sección 1, paso 2). Mientras, solo podrá consultar. | | Mensaje **“Tu rol exige MFA”** al intentar un cambio | Igual que arriba. | Pulse el botón de la llave arriba a la derecha y active MFA. | | Modelo en rojo **“Kill Switch ACTIVO”** | El modelo fue apagado (automático o manual). Sus usuarios reciben un error controlado. | Operador: revise incidentes y Threat Shield para la causa. Administrador: si es seguro, **“Reactivar”** con motivo. Si no entiende la causa, **no reactive**; llame a su responsable técnico. | | Incidente **“Amenaza detectada”** (Threat Shield) | Alguien intentó manipular la IA. La petición fue bloqueada; el modelo sigue en pie. | Reconozca el incidente. Si se repite muchas veces desde el mismo usuario, informe a seguridad: puede ser un ataque dirigido. | | Tabla de conectores: **“Solicitud bloqueada (403)”** | El proxy detuvo una petición maliciosa antes de llegar al modelo. | Normal. Si son cientos en poco tiempo, avise a seguridad. | | Tabla de conectores: **“Transmisión cortada”** | El **modelo** respondió algo indebido (inventó datos de control, reveló información prohibida o mostró señales de haber sido manipulado). Se cortó la respuesta y, si fue grave, se apagó el modelo. | Trate el modelo como sospechoso. Administrador: revise el conector, sus palabras prohibidas y decida si reactivar. Considere avisar al proveedor del modelo. | | Tabla de conectores: **“Transferencia bloqueada”** | Se intentó enviar datos personales a un proveedor en un país de riesgo alto sin anonimización. | Confirme que el interruptor **“Enmascaramiento LFPDPPP”** del conector está encendido, o use un conector local. Consulte a su área legal antes de permitir la transferencia. | | Tabla de conectores: **“Error del proveedor”** | El modelo destino no respondió (apagado, sin red, API key caducada). | Pulse **“Probar”** en la tarjeta. Si falla, su técnico debe revisar el servidor o renovar la API key. | | Tarjeta de conector **“Configuración requerida”** | Falta la API key o nunca se probó la conexión. | Pulse **“Editar”**, complete los datos y **“Probar”**. | | Error **“PII en claro rechazada”** (en la API o SDK) | Un sistema envió datos personales sin anonimizar; la plataforma los rechazó **sin guardarlos**. | Es una protección, no un fallo. Su técnico debe activar la anonimización (SDK o Muro Perimetral) en ese sistema. | | **“HUMAN_ALERT_REQUIRED”** / circuito humano | Todos los modelos de la empresa mostraron problemas a la vez: la plataforma sospecha un fallo general y pide decisión humana en vez de apagar todo. | Convoque a su responsable técnico. Durante 30 segundos no se toman acciones automáticas. | | Heartbeat **“stale”** | Su sistema dejó de reportar señal de vida. | Verifique con su técnico si el sistema está caído o si perdió conexión con la plataforma. | | Webhook **“fallando”** | Los avisos a su equipo de seguridad no están llegando. | Su técnico debe revisar la dirección receptora; la plataforma reintenta cinco veces con espera creciente. | | **429 “Demasiados intentos”** | Protección contra fuerza bruta o exceso de peticiones. | Espere el tiempo indicado. Si no fue usted, informe a seguridad. | ### Regla de oro ante cualquier anomalía 1. **No borre nada.** La evidencia está en la bitácora. 2. **Reconozca** el incidente (queda registrado quién lo vio). 3. **Contenga**: si duda, deje el modelo apagado. 4. **Escale** a su responsable técnico o de seguridad con la **hora**, el **nombre del modelo/conector** y el **ID de transacción** (la tabla lo muestra; empieza por `tx_gober_`). 5. **Documente** la resolución con la nota al resolver. --- ## 4. Cuándo necesita a una persona técnica - Para indicar la **dirección web** de un modelo instalado en sus servidores. - Para **cambiar la dirección** en la aplicación que usa el modelo (apuntarla al Gateway). - Para configurar **webhooks**, **SDK** o el **Muro Perimetral**. - Cuando un conector queda en **“Sin conexión”** tras probarlo. Comparta con esa persona el **Manual técnico de operaciones** (descargable desde la misma sección del panel). --- ## 5. Preguntas frecuentes **¿La plataforma guarda lo que escriben mis clientes a la IA?** No. Guarda huellas (hashes), métricas y decisiones. Cuando anonimiza datos para un modelo externo, la tabla de equivalencias vive cifrada como máximo 5 minutos y se destruye al terminar. **¿Puede un empleado apagar un modelo por error?** Solo operadores y administradores, y queda registrado. Reactivar exige administrador con MFA y un motivo. **¿Esto me hace cumplir la ley automáticamente?** No. Le da controles, evidencia y avisos alineados a LFPDPPP/RGPD e ISO/IEC 42001. La evaluación legal de transferencias y avisos de privacidad sigue siendo de su área jurídica. **¿Qué pasa si pierdo mis códigos de recuperación y el teléfono?** Otro administrador de su empresa reinicia su MFA desde la gestión de usuarios. Si es el único administrador, contacte a soporte: info@iagobernanza.com.