Post

Proyecto JARVIS: Infraestructura de IA para un Laboratorio de Ciberseguridad

Diseño e implementación de una IA central (Claude Code) que administra un laboratorio de pentesting en VirtualBox: servidor MCP, SSH con mínimo privilegio, fronteras de confianza y modelo de amenazas.

Proyecto JARVIS: Infraestructura de IA para un Laboratorio de Ciberseguridad

Autor: Maximiliano Barcia (Kad) Fecha: 08-11-2026 Versión: 1.0 — Fase de infraestructura


Resumen Ejecutivo

Este proyecto documenta la construcción de la base de infraestructura de “JARVIS”: una IA central personal (basada en Claude Code) que administra mi laboratorio de ciberseguridad, mi aprendizaje y las IAs de mis proyectos de GitHub.

En esta primera fase se logró que la IA del equipo anfitrión (Windows) controle el laboratorio de VirtualBox y opere la Kali Linux mediante un servidor MCP propio, y que la Kali pueda conectarse de vuelta al anfitrión por SSH con un usuario de mínimo privilegio, sin exponer ningún servicio a la red WiFi.

El aspecto más importante del proyecto no fue la conectividad sino la seguridad del diseño: un laboratorio de hacking es, por definición, un entorno que puede comprometerse. Por eso se definieron fronteras de confianza explícitas y se corrigió una debilidad de diseño crítica detectada durante el propio montaje: el código que la IA ejecuta en el anfitrión estaba en una carpeta que la Kali podía modificar.

Resultados

ComponenteEstado
IA en Windows controla VMs y Kali (MCP kali-lab)✅ Operativo
Kali → Windows por SSH con usuario limitado, solo loopback✅ Operativo y verificado
“Cerebro” compartido entre ambas IAs (instrucciones y memoria)✅ Operativo
Código ejecutable de la IA fuera del alcance de la Kali✅ Corregido
Estructura de JARVIS (perfil, estado, IAs por proyecto)✅ Creada

Hallazgos de seguridad del propio diseño

SeveridadHallazgoEstado
🔴 CríticaServidor MCP (ejecutado en el host con el usuario principal) ubicado en carpeta compartida con escritura desde la Kali✅ Mitigado (movido fuera del recurso compartido)
🟠 AltaOpción evaluada de dar a la Kali una shell SSH con el usuario principal✅ Evitado (usuario dedicado sin admin)
🟡 MediaOtras VMs de las redes NAT pueden alcanzar el puerto SSH del host vía loopback⚠️ Aceptado (solo llave, servicio manual)
🟡 MediaCarpeta de descargas compartida con escritura contiene material sensible (VPN/llaves)⏳ Pendiente

1. Contexto y Objetivos

Trabajo en ciberseguridad (CTF en Hack The Box, PortSwigger y, a futuro, bug bounty) con un laboratorio local en VirtualBox: una Kali Linux como atacante y varias máquinas objetivo vulnerables.

Objetivos de esta fase:

  • Que una IA pueda operar el laboratorio: encender/apagar VMs, tomar snapshots y ejecutar comandos en la Kali.
  • Poder trabajar desde la Kali con una IA que tenga acceso controlado al anfitrión.
  • Compartir instrucciones y memoria entre ambas IAs.
  • Hacerlo aplicando mínimo privilegio y defensa en profundidad, asumiendo que la Kali puede llegar a comprometerse.
  • Crear la estructura base de JARVIS para las siguientes fases.

2. Arquitectura

2.1 Diagrama general

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
┌──────────────────────── WINDOWS 11 (HOST) ─────────────────────────┐

│                                                                    │

│  JARVIS (Claude Code)                                              │

│   ├── M:\Jarvis\            ← instrucciones, perfil, estado        │

│   └── MCP "kali-lab"        ← M:\Documentos\kali-mcp\server.py     │

│          │  VBoxManage (ciclo de vida de VMs)                      │

│          │  SSH → 127.0.0.1:2222 (port-forward) → Kali:22          │

│          ▼                                                         │

│  sshd (OpenSSH Server) escuchando SOLO en 127.0.0.1:22             │

│   └── usuario "labclaude" (estándar, sin admin, solo llave)        │

│                                                                    │

│  Recursos compartidos de VirtualBox (RW):  M:\GitHub , Descargas   │

└───────────────┬──────────────────────────────────▲─────────────────┘

                │ NAT Network "Red_NAT" 10.0.2.0/24│

                ▼                                  │ ssh windows

┌──────────── KALI LINUX (VM) ─────────────┐       │ (10.0.2.1 → host 127.0.0.1)

│ eth1: 10.0.2.3 (reserva DHCP)            │───────┘

│ ~/cerebro → /media/sf_GitHub/claude      │

│ Claude Code (operador de laboratorio)    │

└──────────────────────────────────────────┘

2.2 Componentes

ComponenteTecnologíaFunción
JARVISClaude Code (Windows)IA central: administra laboratorio, perfil, proyectos
kali-labServidor MCP en Python (paquete mcp)Expone herramientas para VMs y Kali
Kali_LaboratorioKali Linux en VirtualBoxMáquina atacante / operador
Red_NATNAT Network de VirtualBox 10.0.2.0/24Red del laboratorio
sshdOpenSSH Server de WindowsAcceso Kali → host
labclaudeUsuario local estándarIdentidad limitada para la Kali
M:\lab-shareCarpeta NTFSÚnico lugar de escritura para labclaude

2.3 Fronteras de confianza

Esta es la decisión de diseño central del proyecto:

ZonaConfianzaContenidoQuién escribe
M:\Jarvis, M:\Documentos🟢 AltaInstrucciones de JARVIS, servidor MCPSolo el host
M:\GitHub (compartido RW)🔴 BajaRepos, “cerebro” compartidoHost y Kali
Kali🔴 BajaHerramientas ofensivas, objetivos—

3. Implementación

3.1 Servidor MCP kali-lab: la IA controla el laboratorio

MCP (Model Context Protocol) es un protocolo abierto que permite conectar herramientas externas a un asistente de IA. Desarrollé un servidor MCP en Python que expone estas herramientas a Claude Code:

HerramientaQué hace
vm_list, vm_infoLista VMs y estado (vía VBoxManage)
vm_start, vm_stopEnciende / apaga VMs
vm_snapshot_list/take/restoreGestión de snapshots (volver a un estado limpio)
kali_execEjecuta comandos en la Kali por SSH
kali_upload, kali_downloadTransferencia de archivos
kali_statusComprueba conectividad (hostname, usuario, IPs)

La conexión a la Kali usa una llave SSH dedicada y un port-forward de la NAT Network que solo escucha en el loopback del host:

1
2
3
kali-ssh: tcp  [127.0.0.1]:2222  →  [10.0.2.3]:22

Registro en Claude Code (alcance de usuario):

1
2
3

claude mcp add kali-lab --scope user -- python M:\Documentos\kali-mcp\server.py

Verificación:

1
2
3
4
5
6
7
8
9
kali_status →

kali

kali

eth1   UP   10.0.2.3/24

3.2 Evaluación de alternativas: ¿cómo trabajar desde la Kali?

El objetivo era usar la IA desde la Kali y que pudiera operar sobre el host. Se evaluaron cuatro opciones:

OpciónVentajaProblemaDecisión
Remote Control (controlar la sesión del host desde el navegador)Sin abrir puertosNo disponible con autenticación por API key❌
Claude Code en la Kali, sin acceso al hostAislamiento totalNo puede operar el hostBase
Servidor MCP en el host expuesto por HTTPHerramientas acotadasMás desarrollo; mismo riesgo si se expone una shellFuturo
SSH Kali → host con usuario limitadoFlexible y estándarRequiere hardening cuidadoso✅ Elegida

Se descartó explícitamente dar SSH con el usuario principal: si la Kali se compromete, el atacante tendría acceso completo a la PC.

3.3 SSH Kali → Windows con mínimo privilegio

Todo se automatizó en un script de PowerShell que se ejecuta como administrador. Medidas aplicadas:

1) Usuario dedicado, estándar, con contraseña aleatoria que nunca se usa:

1
2
3
4
5
6
7
8
9
10
11
12
13

$chars = (48..57) + (65..90) + (97..122) + (33,35,36,37,42,43,45,61,63,64)

$plain = -join (1..32 | ForEach-Object { [char]($chars | Get-Random) })

New-LocalUser -Name labclaude -Password (ConvertTo-SecureString $plain -AsPlainText -Force) `

    -PasswordNeverExpires -UserMayNotChangePassword -Description 'Claude desde Kali (SSH solo llave)'

# Grupo "Users" por SID: funciona en Windows en cualquier idioma

Add-LocalGroupMember -Group (Get-LocalGroup -SID 'S-1-5-32-545').Name -Member labclaude

2) Autenticación solo por llave (ed25519 generada en la Kali), con el archivo de llaves protegido:

1
2
3
4
5
6
7

$ak = "$env:ProgramData\ssh\labclaude_authorized_keys"

Set-Content -Path $ak -Value $PubKey -Encoding ascii

icacls $ak /inheritance:r /grant 'SYSTEM:F' /grant '*S-1-5-32-544:F'

Ubicar authorized_keys en ProgramData (y no en el perfil del usuario) evita que el propio labclaude pueda agregarse llaves.

3) sshd_config endurecido (las directivas se insertan al inicio del archivo: OpenSSH usa el primer valor encontrado y el archivo por defecto de Windows termina en un bloque Match):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
ListenAddress 127.0.0.1

PasswordAuthentication no

PubkeyAuthentication yes

PermitEmptyPasswords no

AllowUsers labclaude

AllowTcpForwarding no

GatewayPorts no

MaxAuthTries 3

  

Match User labclaude

       AuthorizedKeysFile __PROGRAMDATA__/ssh/labclaude_authorized_keys

4) Sin exposición de red: al escuchar solo en 127.0.0.1 no hace falta abrir el firewall; la regla que crea OpenSSH por defecto se desactiva.

1
2
3

Get-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' | Disable-NetFirewallRule

5) Servicio en arranque manual: sshd solo corre cuando se necesita.

1
2
3

Set-Service sshd -StartupType Manual

6) Carpeta de intercambio como único lugar de escritura:

1
2
3

icacls M:\lab-share /grant "labclaude:(OI)(CI)M"

3.4 ¿Cómo llega la Kali al loopback del host?

VirtualBox NAT Network tiene loopback mappings: una IP de la red virtual se traduce al 127.0.0.1 del host.

1
2
3
4
5
6
7
Red_NAT  10.0.2.0/24  Gateway 10.0.2.1

loopback mappings (ipv4)

        127.0.0.1=2

Por la configuración se esperaba llegar por 10.0.2.2, pero la prueba real mostró otra cosa:

1
2
3
4
5
6
7
8
9
10
11
$ ssh labclaude@10.0.2.2

ssh: connect to host 10.0.2.2 port 22: Connection refused

  

$ nc -zv -w3 10.0.2.1 22

(UNKNOWN) [10.0.2.1] 22 (ssh) open

El host es alcanzable a través del gateway 10.0.2.1. Se configuró un alias en la Kali:

1
2
3
4
5
6
7
8
9
10
11
Host windows

    HostName 10.0.2.1

    User labclaude

    IdentityFile ~/.ssh/labclaude_win

    IdentitiesOnly yes

3.5 “Cerebro” compartido entre las dos IAs

La idea inicial fue crear un enlace con mklink /D dentro de la carpeta de Descargas compartida. Se descartó porque:

  • mklink /D crea un enlace simbólico, no un enlace duro (Windows no permite enlaces duros de directorios).

  • Las versiones actuales de VirtualBox no siguen symlinks que apuntan fuera de la carpeta compartida.

  • La carpeta destino ya existía con contenido: el comando habría fallado (o, peor, invitado a borrarla).

La solución fue usar un recurso compartido que ya existía (M:\GitHub → /media/sf_GitHub) y un symlink dentro de la Kali:

1
2
3
ln -sfn /media/sf_GitHub/claude ~/cerebro

3.6 Corrección crítica: el código de la IA estaba al alcance de la Kali

Al revisar el diseño se detectó esta cadena:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Kali (puede comprometerse)

   │ escribe en /media/sf_GitHub/claude/kali-mcp/server.py

   ▼

M:\GitHub\claude\kali-mcp\server.py   ← el mismo archivo

   │ Claude Code lo ejecuta al iniciar

   ▼

Ejecución de código en Windows con el USUARIO PRINCIPAL

Es decir, todo el trabajo de mínimo privilegio con labclaude quedaba anulado: un atacante con control de la Kali podía modificar el servidor MCP y obtener ejecución de código en el host con los privilegios del usuario principal en el siguiente inicio.

Mitigación: mover el servidor a una carpeta no compartida y volver a registrarlo, verificando integridad por hash antes de borrar el original.

1
2
3
4
5
6
7
8
9
10
11

Copy-Item M:\GitHub\claude\kali-mcp\server.py M:\Documentos\kali-mcp\

(Get-FileHash origen).Hash -eq (Get-FileHash destino).Hash   # True

claude mcp remove kali-lab -s user

claude mcp add kali-lab --scope user -- python M:\Documentos\kali-mcp\server.py

Remove-Item -Recurse M:\GitHub\claude\kali-mcp

3.7 Estructura de JARVIS

Con la infraestructura lista se creó el esqueleto de la IA central, fuera de cualquier recurso compartido:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
M:\Jarvis

├── CLAUDE.md              identidad, reglas y límites de seguridad

├── .claude\skills\        habilidades (próxima fase)

├── .claude\agents\        subagentes especializados

├── estado\ahora.md        plan por fases y pendientes

├── perfil\

│   ├── personal.md        objetivos, forma de aprender

│   └── tecnico.md         nivel por área, plataformas, certificaciones

└── proyectos\             una ficha por cada IA de proyecto

    ├── fixia.md

    ├── cyber-portfolio.md

    ├── maxibarcia-github-io.md

    └── hacking-kali.md

Una IA no tiene memoria propia entre sesiones: la continuidad está en los archivos. Cada sesión empieza leyendo CLAUDE.md y estado/ahora.md, y termina actualizándolos.


4. Problemas Encontrados y Soluciones

#ProblemaCausaSolución
1Get-WindowsCapability: La operación solicitada requiere elevaciónPowerShell sin privilegios de administradorEjecutar elevado (Start-Process powershell -Verb RunAs) y validar elevación al inicio del script
2La instalación “parecía colgada”La consola estaba en modo selección (título “Seleccionar…”), que pausa la salida del procesoEsc / Enter para salir del modo selección
3New-LocalUser: ... longitud ... menor o igual que "48"El campo Description admite máximo 48 caracteresAcortar la descripción; el script es idempotente y se re-ejecutó sin efectos colaterales
4Connection refused en 10.0.2.2:22El acceso al host funciona por el gateway de la NAT NetworkUsar 10.0.2.1, verificado con nc
5Remote Control no disponibleFunción limitada al tipo de cuentaInstalar la IA dentro de la Kali + SSH
6Servidor MCP en carpeta RW de la KaliUbicación inicial sin análisis de confianzaMoverlo fuera del recurso compartido (§3.6)

5. Verificación

Pruebas ejecutadas desde la Kali tras la instalación:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
$ ssh windows whoami

<host>\labclaude

  

# ¿Es administrador?

([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole('Administrator')

False

  

# Escritura en la carpeta de intercambio → OK (archivo verificado desde el host y eliminado)

# Lectura del perfil del usuario principal → denegada

En el host:

1
2
3
4
5
6
7
LocalAddress LocalPort

------------ ---------

127.0.0.1           22      ← sshd no escucha en interfaces de red

PruebaResultado esperadoResultado
Login con llave como labclaudeAcceso✅
labclaude en grupo AdministradoresNo✅ No
Escritura en M:\lab-sharePermitida✅
Lectura del perfil del usuario principalDenegada✅
sshd escuchando en WiFi / LANNo✅ Solo 127.0.0.1
MCP kali-lab tras el trasladoConnected✅

6. Modelo de Amenazas y Riesgos Residuales

AmenazaVectorMitigaciónRiesgo residual
Compromiso de la Kali → hostSSHUsuario sin admin, solo llave, sin forwarding🟡 Bajo-medio: acceso a lo que labclaude pueda leer
Compromiso de la Kali → código del hostRecurso compartido RWCódigo e instrucciones de JARVIS fuera de recursos compartidos🟢 Bajo
VM objetivo → hostLoopback mapping de la NATSolo llave (que vive únicamente en la Kali), servicio manual🟡 Bajo
Exposición en la red localsshdListenAddress 127.0.0.1, regla de firewall desactivada🟢 Muy bajo
Prompt injection a la IA del hostArchivos en M:\GitHubSe tratan como no confiables por regla en CLAUDE.md🟡 Medio (control de proceso, no técnico)
Datos sensibles en recurso compartidoCarpeta de descargas RW—🟠 Pendiente

Riesgos aceptados de forma consciente:

  • labclaude puede leer lo que el grupo Users puede leer en el sistema. Es un usuario estándar, no un sandbox.
  • La Kali conserva escritura sobre M:\GitHub para compartir el “cerebro”; por eso esa zona es de baja confianza.

7. Lecciones Aprendidas

  1. Diseñar por fronteras de confianza, no por conectividad. Que algo “funcione” no significa que sea seguro; la vulnerabilidad más grave fue de diseño, no de configuración.

  2. Mínimo privilegio en todas las capas: usuario, autenticación, interfaz de escucha, firewall y tiempo de exposición (servicio manual).

  3. Probar en vez de suponer: la documentación sugería 10.0.2.2; la realidad era 10.0.2.1.

  4. Scripts idempotentes: permitieron re-ejecutar tras cada error sin dejar el sistema en un estado inconsistente.

  5. Un recurso compartido con escritura es una superficie de ataque, especialmente en un laboratorio ofensivo.

  6. La IA es tan buena como su estructura: sin memoria entre sesiones, la organización de archivos es la memoria.


8. Próximos Pasos

  1. Completar el perfil personal y técnico de JARVIS (entrevista).
  2. Crear una IA por proyecto (CLAUDE.md + skills en cada repositorio).
  3. Skills de JARVIS: /ctf, /writeup, /estudiar, /investigar, /repaso.
  4. Instalar Claude Code en la Kali como operador de laboratorio.
  5. Retirar material sensible de los recursos compartidos y evaluar compartir en solo lectura.
  6. Integrar una IA local (Ollama) y la base de conocimiento personal.

9. Operación Diaria

Un sistema no está terminado cuando “funciona una vez”, sino cuando se puede levantar, verificar y apagar de forma repetible. Este es el procedimiento operativo.

9.1 Arranque

PasoAcciónComando¿Obligatorio?
1Abrir JARVIScd /d M:\Jarvis y luego claude✅ Sí
2Encender la KaliPedírselo a JARVIS (usa vm_start del MCP) o con VBoxManageSegún la tarea
3Habilitar SSH Kali → hostnet start sshd (consola como administrador)Solo si se usa

:: 1) IA central (el MCP kali-lab se carga solo: está registrado a nivel de usuario)

cd /d M:\Jarvis

claude

  

:: 2) Encender la Kali manualmente (alternativa a pedírselo a JARVIS)

"C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" startvm Kali_Laboratorio

  

:: 3) Solo si la Kali necesita entrar al host (requiere consola de administrador)

net start sshd

9.2 Verificación rápida

Qué se compruebaCómoResultado esperado
MCP conectado/mcp dentro de Claude Codekali-lab → connected
Kali accesiblePedir a JARVIS kali_statushostname, usuario e IP 10.0.2.3
SSH Kali → hostEn la Kali: ssh windows whoami<host>\labclaude
sshd solo en loopbackGet-NetTCPConnection -LocalPort 22 -State Listen (PowerShell)127.0.0.1:22 únicamente

9.3 Apagado


:: Cerrar SSH (consola de administrador)

net stop sshd

  

:: Apagar la Kali de forma ordenada (o pedírselo a JARVIS: vm_stop)

"C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" controlvm Kali_Laboratorio acpipowerbutton

Antes de cerrar, JARVIS actualiza estado/ahora.md con lo hecho y lo pendiente, para que la próxima sesión arranque con contexto.

9.4 Continuidad entre sesiones

ComandoQué hace
claudeNueva conversación. JARVIS recupera el contexto leyendo CLAUDE.md y estado/ahora.md.
claude --continueRetoma la última conversación de esa carpeta.
claude --resumePermite elegir una conversación anterior de esa carpeta.

La conversación es efímera; la memoria real son los archivos. Por eso siempre se trabaja desde M:\Jarvis y cada sesión termina actualizando el estado.


Conclusión

Esta fase dejó una base funcional y, sobre todo, defendible: la IA central puede administrar el laboratorio y la Kali puede colaborar con el host sin que un compromiso del entorno de pruebas se traduzca automáticamente en un compromiso de la PC.

El proyecto también demostró el valor de revisar críticamente el propio diseño: el hallazgo más grave lo introdujo la misma infraestructura que se estaba construyendo, y se detectó y corrigió antes de usarla en un escenario real.


Contacto: maxibarcia.github.io · LinkedIn · Web

This post is licensed under CC BY 4.0 by the author.