← Volver a Docs

Inicio Rápido

De cero a un cliente conectado en 5 minutos.

Instálalo con IA

Deja que tu agente de IA lo configure. Copia esta línea y pégala en tu agente.

Set up WireZTNA for me: fetch and follow https://wireztna.com/docs/quickstart/agent-setup.md

Funciona con Claude Code, Cursor, Codex y más.

Prerrequisitos

  • • O bien: un broker self-hosted que despliegas tú (open source), o una cuenta SaaS gestionada / de partner.
  • • Una máquina Linux en la red de tu cliente para el publisher (cualquier VM, bare metal o instancia cloud)
  • • Un equipo (macOS, Windows o Linux) para el cliente
Ruta A

Hazlo tú mismo (Código abierto)

Ejecuta tu propio broker. Después todo lo de la Ruta B funciona igual — solo usa el hostname de tu propio broker allí donde estos pasos muestran your-tenant.wireztna.com.

  1. 1. Aprovisiona un host con IP pública

    Cualquier VM Linux o servidor bare-metal accesible desde internet (una instancia pequeña basta para empezar).

  2. 2. Instala el broker

    Sigue la instalación open source desde el repositorio en github.com/wireztna/wireztna-oss.

  3. 3. Crea el primer admin

    Crea tu cuenta de admin inicial y abre el panel de administración en el hostname de tu propio broker.

  4. 4. Continúa con la instalación del publisher + enrolamiento del cliente

    Sigue los Pasos 1–3 de abajo, sustituyendo your-tenant.wireztna.com por el hostname de tu propio broker en cada comando.

Ruta B

Lo operamos nosotros (SaaS gestionado)

Con tu cuenta de partner y tu tenant your-tenant.wireztna.com, sigue los pasos de abajo. (Self-hosters: estos mismos pasos aplican — usa el hostname de tu propio broker.)

1

Instalar el Publisher

En el panel de administración, ve a Publishers y haz clic en "+ Añadir Publisher". Esto genera un token de enrollment de un solo uso y muestra un comando de una línea.

Conéctate por SSH a la máquina Linux de tu cliente y ejecuta el comando:

curl -fsSL https://tu-tenant.wireztna.com/api/v1/publishers/install.sh | sudo bash

Esto descarga el binario del publisher (8 MB), lo registra en el broker usando el token embebido, crea un túnel WireGuard e instala un servicio systemd. Tarda ~10 segundos.

Lo que ocurre internamente:

  1. Descarga el binario estático wireztna-publisher
  2. Genera un par de claves WireGuard localmente (la clave privada nunca sale de la máquina)
  3. Se registra con el broker mediante el token de enrollment
  4. Establece un túnel WireGuard persistente hacia el broker
  5. Se instala como servicio systemd (arranca automáticamente con el sistema)
2

Crear un Usuario y Generar Token de Enrollment

En el panel de administración:

  1. Ve a Users → + Nuevo Usuario — introduce el email del usuario
  2. Ve a Groups — asigna al usuario a un grupo que tenga acceso al publisher
  3. Haz clic en el usuario → Pestaña Enrollment → Generar Token
  4. Copia la URL de enrollment y envíasela al usuario

La URL de enrollment tiene esta forma: https://tu-tenant.wireztna.com/api/v1/clients/enroll?token=abc123...

Los tokens son de un solo uso, expiran en 24h y se pueden revocar desde el panel de administración.

3

Registrar y Conectar el Cliente

En el equipo del usuario, ejecuta estos tres comandos:

Enroll (registra el dispositivo en el broker):

wireztna enroll "https://tu-tenant.wireztna.com/api/v1/clients/enroll?token=abc123"

Login (autentica al usuario):

wireztna login

Connect (establece el túnel):

sudo wireztna connect

En Windows, usa un PowerShell elevado en lugar de sudo. En macOS/Linux, sudo es necesario para crear la interfaz de red.

4

Verificar la Conectividad

Una vez conectado, el cliente puede acceder a recursos en la red del publisher:

# Hacer ping a un host en la LAN del publisher
ping 10.50.1.100

# Acceder a un servicio
curl http://10.50.1.100:8080

# Comprobar el estado del túnel
wireztna status

El cliente solo tiene acceso a los CIDRs expuestos por los publishers de sus grupos asignados. El resto del tráfico usa la red predeterminada del usuario (split tunnel).