Este proyecto está destinado únicamente a la investigación y enseñanza de seguridad en redes. Está estrictamente prohibido su uso con fines ilegales. Asegúrese de obtener autorización explícita del sistema objetivo antes de realizar cualquier prueba con esta herramienta, y cumpla estrictamente con las leyes y regulaciones pertinentes de su país/región. Cualquier consecuencia directa o indirecta derivada del uso de esta herramienta (incluyendo, pero no limitado a: pérdida de datos, daños del sistema, responsabilidad legal) es responsabilidad exclusiva del usuario. El autor de este proyecto no se hace responsable de ningún uso indebido ni de las responsabilidades legales que pueda conllevar. El uso de esta herramienta implica que ha leído, comprendido y aceptado todo el contenido de este descargo de responsabilidad.

Características

• Interfaz de administración más amigable, con soporte para autocompletado de comandos e historial.
• Gestión clara del árbol de nodos.
• Visualización completa de la información de los nodos.
• Conexión directa/inversa entre nodos.
• Soporte de reconexión entre nodos.
• Conexión entre nodos a través de proxy SOCKS5/HTTP.
• Conexión entre nodos mediante túnel SSH.
• Tráfico entre nodos seleccionable como TCP/HTTP/WS.
• Reenvío de tráfico proxy SOCKS5 multicapa, compatible con UDP/TCP, IPv4/IPv6.
• Acceso SSH remoto a través de nodos.
• Shell remoto.
• Subida y descarga de archivos.
• Reenvío de puertos local/remoto.
• Reutilización de puertos de nodo.
• Activación/desactivación libre de varios servicios.
• Autenticación mutua entre nodos.
• Cifrado del tráfico entre nodos con TLS/AES-256-GCM.
• Reducción del 25% del tamaño del archivo en comparación con v1.0.
• Soporte para múltiples plataformas (Linux/Mac/Windows/MIPS/ARM).

Compilación y demostración

• Use make para compilar directamente el programa completo para múltiples plataformas, o consulte el Makefile para compilar programas específicos.
• Si no desea compilar, puede usar los programas ya compilados en release.
• Video de demostración: YouTube

Instrucciones de uso

Roles

Stowaway incluye dos roles:

• admin: el controlador principal utilizado por el probador de penetración.
• agent: el agente controlado desplegado por el probador de penetración.

Definiciones

• Nodo: se refiere a admin o agent.
• Modo activo: el nodo actual se conecta activamente a otro nodo.
• Modo pasivo: el nodo actual escucha en un puerto y espera que otro nodo se conecte.
• Upstream: tráfico entre el nodo actual y su nodo padre.
• Downstream: tráfico entre el nodo actual y todos sus nodos hijos.

Inicio rápido

Los siguientes comandos inician rápidamente la instancia más simple de Stowaway.

• admin: ./stowaway_admin -l 9999
• agent: ./stowaway_agent -c <IP de stowaway_admin>:9999

Parámetros

• admin

• agent

Uso de parámetros

-l

Este parámetro se usa igual en admin y agent, solo en modo pasivo.

Si no se especifica la IP, por defecto escucha en 0.0.0.0.

• admin: ./stowaway_admin -l 9999 o ./stowaway_admin -l 127.0.0.1:9999

• agent: ./stowaway_agent -l 9999 o ./stowaway_agent -l 127.0.0.1:9999

-s

Este parámetro se usa igual en admin y agent, tanto en modo activo como pasivo.

Opcional. Si está vacío, la comunicación no está cifrada; de lo contrario, la comunicación se cifra con la clave proporcionada por el usuario.

• admin: ./stowaway_admin -l 9999 -s 123

• agent: ./stowaway_agent -l 9999 -s 123

-c

Este parámetro se usa igual en admin y agent, solo en modo activo.

Representa la dirección del nodo al que se desea conectar.

• admin: ./stowaway_admin -c 127.0.0.1:9999

• agent: ./stowaway_agent -c 127.0.0.1:9999

--socks5-proxy/--socks5-proxyu/--socks5-proxyp/--http-proxy

Estos cuatro parámetros se usan igual en admin y agent, solo en modo activo.

--socks5-proxy representa la dirección del servidor proxy SOCKS5; --socks5-proxyu y --socks5-proxyp son opcionales.

--http-proxy representa la dirección del servidor proxy HTTP, se usa de la misma manera que SOCKS5.

Sin nombre de usuario y contraseña:

• admin: ./stowaway_admin -c 127.0.0.1:9999 --socks5-proxy xxx.xxx.xxx.xxx

• agent: ./stowaway_agent -c 127.0.0.1:9999 --socks5-proxy xxx.xxx.xxx.xxx

Con nombre de usuario y contraseña:

• admin: ./stowaway_admin -c 127.0.0.1:9999 --socks5-proxy xxx.xxx.xxx.xxx --socks5-proxyu xxx --socks5-proxyp xxx

• agent: ./stowaway_agent -c 127.0.0.1:9999 --socks5-proxy xxx.xxx.xxx.xxx --socks5-proxyu xxx --socks5-proxyp xxx

--up/--down

Estos dos parámetros se usan igual en admin y agent, tanto en modo activo como pasivo.

Pero tenga en cuenta que admin no tiene el parámetro --up.

Estos parámetros son opcionales. Si están vacíos, el tráfico upstream/downstream es TCP puro.

Si desea que el tráfico upstream/downstream sea HTTP/WS, configure estos parámetros como http o ws respectivamente.

• admin: ./stowaway_admin -c 127.0.0.1:9999 --down ws

• agent: ./stowaway_agent -c 127.0.0.1:9999 --up ws o ./stowaway_agent -c 127.0.0.1:9999 --up ws --down ws

Además, tenga en cuenta dos puntos:

Primero, cuando configure el tráfico upstream/downstream de un nodo como TCP/HTTP/WS, el tráfico downstream/upstream del nodo padre/hijo debe ser consistente. Por ejemplo:

• admin: ./stowaway_admin -c 127.0.0.1:9999 --down ws

• agent: ./stowaway_agent -l 9999 --up ws

En este caso, el agente debe configurar --up como ws; de lo contrario, ocurrirán errores de red.

Lo mismo aplica entre agentes.

Supongamos que agent-1 está escuchando en 127.0.0.1:10000 esperando la conexión de un nodo hijo y ha configurado --down ws. Entonces agent-2 también debe configurar --up como ws; de lo contrario, se producirán errores.

• agent-2: ./stowaway_agent -c 127.0.0.1:10000 --up ws

Segundo, dado que HTTP es un protocolo semidúplex, no es muy adecuado para la comunicación full-duplex de Stowaway. Por lo tanto, aquí el protocolo HTTP solo implementa el formato de mensaje HTTP, no un flujo de trabajo HTTP completo. Así que aún puede usar este protocolo, pero el tráfico entre Stowaway en formato de mensaje HTTP no puede ser reenviado a través de nginx. Esta parte del código y la funcionalidad se mantienen para el uso en ciertas situaciones especiales con HTTP, y también para proporcionar una plantilla de tráfico personalizada para que los usuarios la tomen como referencia al personalizar protocolos.

Si necesita usar nginx u otros proxies inversos, utilice el protocolo WS junto con TLS para la comunicación.

--reconnect

Este parámetro solo se usa en agent y solo en modo activo.

Opcional. Si no se establece, el nodo no intentará reconectarse después de que se desconecte la conexión de red. Si se establece, el nodo intentará reconectarse al nodo padre cada x segundos (el número que configure).

• admin: ./stowaway_admin -l 9999

• agent: ./stowaway_agent -c 127.0.0.1:9999 --reconnect 10

En el caso anterior, si la conexión entre el agent y el admin se rompe, el agente intentará reconectarse al admin cada diez segundos.

Lo mismo aplica entre agentes.

Además, el parámetro --reconnect se puede usar junto con --socks5-proxy/--socks5-proxyu/--socks5-proxyp/--http-proxy; el agente intentará reconectarse a través del proxy según la configuración inicial.

--rehost/--report

Estos dos parámetros son especiales; solo se usan en agent. Consulte la sección de reutilización de puertos para más detalles.

--cs

Este parámetro solo se usa en agent, tanto en modo activo como pasivo.

Está diseñado principalmente para resolver problemas de codificación en la función 'shell'. Cuando el agente se ejecuta en una plataforma con codificación de consola gbk (por ejemplo, Windows en general) y el admin se ejecuta en una plataforma con codificación utf-8, asegúrese de establecer este parámetro en 'gbk'.

• Windows: ./stowaway_agent -c 127.0.0.1:9999 -s 123 --cs gbk

--tls-enable

Este parámetro se usa igual en admin y agent, tanto en modo activo como pasivo.

Al habilitar esta opción, el tráfico entre nodos se cifrará con TLS.

Ejemplo:

• admin: ./stowaway_admin -l 10000 --tls-enable -s 123
• agent: ./stowaway_agent -c localhost:10000 --tls-enable -s 123

Nota: Cuando esta opción está habilitada, el cifrado AES se deshabilita por defecto; el parámetro -s solo se usará para autenticación mutua entre nodos y para la función de reutilización de puertos.

Además, cuando esta opción está habilitada, asegúrese de que todos los nodos en la red (incluyendo admin) tengan esta opción habilitada.

--domain

Este parámetro se usa igual en admin y agent, solo en modo activo.

Al establecer esta opción, se puede configurar la opción SNI durante la negociación TLS o el Host de destino para WebSocket.

Ejemplo:

• admin: ./stowaway_admin -l 10000 --tls-enable -s 123
• agent: ./stowaway_agent -c xxx.xxx.xxx.xxx:10000 --tls-enable -s 123 --domain xxx.com

--heartbeat

Este parámetro solo se usa en admin, tanto en modo activo como pasivo.

Al habilitar esta opción, el admin enviará continuamente paquetes de heartbeat al primer nodo, manteniendo así una conexión larga en presencia de un proxy inverso intermedio.

Supongamos que hay un proxy inverso como nginx entre admin y agent que proxy el puerto 8080 al puerto 8000. Ejemplo:

• admin: ./stowaway_admin -l 8000 --tls-enable -s 123 --down ws --heartbeat
• agent: ./stowaway_agent -c xxx.xxx.xxx.xxx:8080 --tls-enable -s 123 --domain xxx.com --up ws

Mecanismo de reutilización de puertos

Actualmente, Stowaway ofrece reutilización de puertos basada en las características SO_REUSEPORT y SO_REUSEADDR, y reutilización de puertos basada en IPTABLES.

• En Linux, se pueden reutilizar la mayoría de los puertos funcionales.
• En Windows, no se pueden reutilizar los puertos IIS, RDP; se pueden reutilizar puertos de servicios MySQL, Apache.

Modos de reutilización

• Modo SO_REUSEPORT y SO_REUSEADDR

  Suponga que el agente utiliza el mecanismo de reutilización de puertos para reutilizar el puerto 80.

  En este caso, el agente debe configurar los parámetros --rehost, --report y -s.

  • --rehost: Representa la dirección IP que se desea reutilizar; no puede ser 0.0.0.0, generalmente debe ser la dirección externa de la tarjeta de red.
  • --report: Representa el puerto que se desea reutilizar.
  • -s: Representa la clave de comunicación.

  Principalmente compatible con Windows y Mac; también funciona en Linux, pero con más restricciones.

  • admin: ./stowaway_admin -c 192.168.0.105:80 -s 123
  • agent: ./stowaway_agent --report 80 --rehost 192.168.0.105 -s 123

• Modo IPTABLES

  Suponga que el agente utiliza el mecanismo de reutilización de puertos para reutilizar el puerto 22.

  En este caso, el agente debe configurar los parámetros -l, --report y -s.

  • -l: Representa el puerto que no puede ser accedido normalmente, es decir, el puerto donde realmente desea que el agente escuche y acepte conexiones.
  • --report: Representa el puerto que se desea reutilizar.
  • -s: Representa la clave de comunicación.

  Solo compatible con Linux; el agente modificará automáticamente las reglas de IPTABLES, requiere privilegios root.

  • agent: ./stowaway_agent --report 22 -l 10000 -s 123

    Después de iniciar el agente, use el script reuse.py en el directorio script.

    Primero, establezca el valor de SECRET (el valor de SECRET es la clave de comunicación establecida al iniciar cada nodo).

    Luego ejecute: python reuse.py --start --rhost xxx.xxx.xxx.xxx --rport xxx

    • --rhost: Representa la dirección del agente.
    • --rport: Representa el puerto reutilizado; en este ejemplo, debería ser 22.

  • Ahora el admin puede conectarse: ./stowaway_admin -c 192.168.0.105:22 -s 123

Notas

• Los ejemplos anteriores solo muestran conexiones entre admin y agente; las conexiones entre agentes son similares, sin diferencias.
• Si el agente es eliminado con ctrl-c o el comando kill, el programa limpiará automáticamente las reglas de iptables. Pero si se elimina con kill -9, no se limpiarán automáticamente. Por lo tanto, para evitar que las reglas de iptables no se limpien después de una salida anormal del agente y que el servicio reutilizado no se pueda acceder, cuando necesite cerrar, ejecute: python reuse.py --stop --rhost xxx.xxx.xxx.xxx --rport xxx Esto desactivará las reglas de reenvío, permitiendo que el servicio original sea accesible normalmente.
• Si se usa el modo de reutilización de puertos basado en IPTABLES, se forzará la escucha en 0.0.0.0; no se puede especificar una IP con el parámetro -l.

¿Cómo formar una red multinivel?

En los ejemplos anteriores, solo aparecen admin y un agente.

La característica principal es la red multinivel.

En Stowaway, para formar una red multinivel, se deben usar los comandos listen, connect y sshtunnel en el admin.

Pongamos un ejemplo simple:

• admin: ./stowaway_admin -l 9999 -s 123

Ahora agent-1 ya está conectado al admin.

• agent-1: ./stowaway_agent -c 127.0.0.1:9999 -s 123

  Ahora el usuario quiere conectar agent-2, así:

• agent-2: ./stowaway_agent -l 10000 -s 123

  Entonces, el usuario puede, a través del admin, escribir use 0 -> connect IP de agent-2:10000 para agregarlo a la red, convirtiéndolo en un nodo hijo de agent-1.

Si el usuario desea conectar otro nodo, agent-3, pero agent-1 no puede acceder a agent-3.

Entonces, el usuario puede, a través del admin, escribir use 0 -> listen -> seleccionar 1.Normal Passive -> introducir 10001, para que agent-1 escuche en el puerto 10001 y espere conexiones de nodos hijos.

Una vez que el admin haya completado la operación, agent-3 se inicia de la siguiente manera:

• agent-3: ./stowaway_agent -c 127.0.0.1:10001 -s 123

De esta manera, agent-3 se agrega a la red como otro nodo hijo de agent-1.

Para una introducción detallada a listen y sshtunnel, consulte la sección de comandos a continuación.

¿Cómo reconectar?

Stowaway actualmente admite varios métodos de reconexión. Resumiendo brevemente:

En primer lugar, cuando el nodo padre se desconecta, solo un tipo de nodo saldrá activamente: aquellos que se iniciaron en modo activo y no configuraron reconexión.

Si se configuró la reconexión, el nodo intentará reconectarse en el intervalo de tiempo especificado.

Además, todos los nodos iniciados en modo pasivo no saldrán activamente; en su lugar, volverán a escuchar en el puerto especificado según los parámetros de inicio. En ese momento, el usuario aún puede usar connect y sshtunnel para volver a conectar estos nodos a la red.

Notas

1. Si, debido a fluctuaciones de red o desconexión de un nodo intermedio, una rama se desconecta, al reconectar activamente asegúrese de conectar el nodo principal de la cadena faltante. Por ejemplo: admin seguido de node1, node1 se divide en dos ramas: node1->node2->node3->node4 y node1->node5->node6. Si node2 se desconecta, node3 y node4 no se desconectarán, sino que permanecerán activos. En ese momento, el usuario tiene dos opciones para volver a agregar node3 y node4 a la red: una es que si node1 puede acceder directamente a node3, el usuario puede en cualquier momento desde node1 usar el comando connect o sshtunnel para volver a agregar node3 a la red (recuerde, incluso si node1 también puede acceder a node4, no conecte directamente node4; conecte el nodo principal de la cadena faltante (node3), que es node3, para volver a agregar tanto node3 como node4 a la red). La otra opción es que si node1 no puede acceder directamente a node3 (es decir, debe pasar por node2), entonces primero reinicie node2 y agréguelo a la red, luego desde node2 use el comando connect o sshtunnel para conectar node3, agregando así node3 y node4 a la red.

2. Cuando un nodo se desconecta, todos los servicios socks, backward y forward relacionados con ese nodo y sus nodos hijos serán forzados a detenerse.

Explicación de comandos

En la consola de admin, el usuario puede usar Tab para autocompletar comandos y las flechas del teclado para navegar por el historial/mover el cursor.

La consola de admin tiene dos niveles. El primer nivel es el panel principal, que contiene los siguientes comandos:

• help: Muestra la ayuda del panel principal.

• detail: Muestra información detallada de los nodos en línea.

• topo: Muestra la relación padre-hijo de los nodos en línea.

• use: Usa un agente específico.

• exit: Sale de Stowaway.

Cuando el usuario selecciona un agente con el comando use, entra al segundo nivel, el panel de nodo, que contiene los siguientes comandos:

• help: Muestra la ayuda del panel de nodo.

• status: Muestra el estado de socks/forward/backward del nodo actual.

• listen: Ordena al agente escuchar en un puerto y esperar la conexión de nodos hijos.

Tenga en cuenta que listen es un comando especial. Como se puede ver, listen tiene tres modos:

1. Normal passive: Esta opción significa que el agente escuchará de manera normal en el puerto objetivo y esperará la conexión de nodos hijos.
2. IPTables Reuse: Esta opción significa que el agente reutilizará el puerto usando el método IPTables Reuse y esperará la conexión de nodos hijos.
3. SOReuse: Esta opción significa que el agente reutilizará el puerto usando el método SOReuse y esperará la conexión de nodos hijos.

El primer modo es el más común. Si el nodo padre escucha de esta manera, el nodo hijo solo necesita -c ip:puerto del nodo padre para unirse a la red.

El segundo y tercer modo son especiales. Si el usuario elige el segundo o tercer modo, debe asegurarse de que el nodo actual se haya iniciado con el método de reutilización de puertos correspondiente; de lo contrario, no podrá usar estos modos.

En el segundo y tercer modo, el usuario no necesita ingresar ninguna información; el nodo usará automáticamente sus propios parámetros de inicio para reutilizar el puerto y prepararse para aceptar conexiones de nodos hijos.

Además, listen solo acepta la conexión de un nodo hijo a la vez. Si se necesitan múltiples nodos hijos, ejecute el comando listen tantas veces como sea necesario.

• addmemo: Agrega una nota al nodo actual.

• delmemo: Elimina la nota del nodo actual.

• ssh: Ordena al nodo conectarse a una máquina objetivo vía SSH.

En este modo, la tecla Tab está deshabilitada.

• shell: Obtiene el shell del nodo actual.

En este modo, la tecla Tab está deshabilitada.

• socks: Inicia un servicio socks5 en el nodo actual.

Tenga en cuenta que el puerto 7777 aquí no se abre en el agente, sino en el admin.

Si necesita configurar nombre de usuario y contraseña, cambie el comando a: socks 7777 <su nombre de usuario> <su contraseña>.

Si necesita especificar la interfaz de escucha, cambie el comando a: socks xxx.xxx.xxx.xxx:7777.

• stopsocks: Detiene el servicio socks5 en el nodo actual.

• connect: Ordena al nodo actual conectarse a otro nodo hijo.

• sshtunnel: Ordena al nodo actual conectarse a otro nodo hijo a través de un túnel SSH.

En entornos de red estrictamente restringidos, se puede usar el túnel SSH para disfrazar el tráfico de Stowaway como tráfico SSH, evitando así las restricciones del firewall.

• upload: Sube un archivo al nodo actual.

• download: Descarga un archivo del nodo actual.

• forward: Mapea un puerto del admin a una dirección remota.

• stopforward: Detiene el mapeo remoto del nodo actual.

• backward: Mapea inversamente un puerto del agente actual al puerto local del admin.

• stopbackward: Detiene el mapeo inverso del nodo actual.

• shutdown: Ordena al nodo actual desconectarse.

• back: Vuelve al panel principal.

• exit: Sale de Stowaway.

TODO

• Corregir errores
• Soporte para TLS
• Soporte para múltiples nodos iniciales (startnode)

Notas importantes

• Este programa se desarrolló durante el tiempo libre para aprender; la estructura del código puede no ser rigurosa y las funciones pueden tener errores. Agradecemos su comprensión.
• Cuando el admin no está en línea, no se permitirá la entrada de nuevos nodos.
• El admin solo admite un nodo agente conectado directamente; los agentes no tienen esta limitación.
• Si el usuario usa el admin en Windows, primero descargue ansicon o aquí. Luego vaya a la carpeta correspondiente a la arquitectura del sistema y ejecute ansicon.exe -i; de lo contrario, la consola del admin puede mostrar caracteres ilegibles.
• Este programa solo admite UDP ASSOCIATE según el estándar RFC1928. Al usar el proxy SOCKS5 UDP, tenga en cuenta que el programa que utilice (por ejemplo, escáneres) debe construir paquetes de acuerdo con el estándar RFC1928 y debe manejar la pérdida de paquetes por sí mismo.

Proyecto 404 StarLink

Stowaway ahora se ha unido al Proyecto 404 StarLink

Agradecimientos

Agradecemos la ayuda de los siguientes maestros y proyectos durante el desarrollo de Stowaway:

• lz520520
• SignorMercurio
• MM0x00
• r0ck3rt
• Termite
• Venom