> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# NetBox

> Conecta NetBox a Myrmex con un token de la API REST: crea el token y agrega la integración.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Conecta tu **NetBox** IPAM/DCIM para que Myrmex pueda leer en tiempo real tu inventario de fuente de verdad: sitios, racks, dispositivos, direcciones IP, prefijos y VLANs. Myrmex se conecta mediante la **API REST de NetBox** usando un token de API.

## Qué puede hacer Myrmex

<CardGroup cols={2}>
  <Card title="Leer el inventario" icon="boxes-stacked">
    Trae sitios, racks, dispositivos, direcciones IP, prefijos y VLANs desde tu fuente de verdad, bajo demanda.
  </Card>

  <Card title="Salud y métricas" icon="chart-line">
    Verifica la salud y las métricas de NetBox IPAM/DCIM mediante la API.
  </Card>

  <Card title="Referencia cruzada" icon="diagram-project">
    Correlaciona los registros de NetBox con datos de tus otras integraciones durante las investigaciones.
  </Card>

  <Card title="Pregunta en el Workspace" icon="magnifying-glass">
    Consulta tu inventario en lenguaje natural.
  </Card>
</CardGroup>

## Antes de comenzar

* Una instancia de **NetBox** accesible (Myrmex se conecta por HTTPS; opcionalmente a través de un [Collector](/es/documentation/agent-endpoint-security/collector-mode) si NetBox está en una red privada).
* Una **cuenta de usuario** de NetBox cuyos permisos cubran los objetos que quieres que Myrmex lea (solo lectura basta para el análisis).
* Permiso para crear un **token de API** para ese usuario.

## Paso 1 — Crear el token de API en NetBox

<Steps>
  <Step title="Abre tus tokens de API">
    En NetBox, abre tu menú de usuario y ve a **API Tokens** (o **Admin → API Tokens**).
  </Step>

  <Step title="Agrega un token">
    Haz clic en **Add a token** y asígnalo a la cuenta de solo lectura. Desmarca **Write enabled** para mantener el token de solo lectura.
  </Step>

  <Step title="Copia el token completo">
    Copia la cadena completa del token, incluyendo el prefijo, el nombre y el separador de punto: el formato es `nbt_{name}.{token}`. Guárdalo de forma segura; lo pegarás en Myrmex.
  </Step>
</Steps>

<Tip>
  Acota el token a una cuenta de solo lectura y, si es compatible, restríngelo por IP de origen para que solo pueda usarse desde tu Collector o Myrmex.
</Tip>

## Paso 2 — Agregar la integración en Myrmex

Desde el **Directory**, elige **Add Integration → NetBox** y luego completa:

| Field           | Descripción                                                                                                             |
| --------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nombre único para esta instancia de NetBox.                                                                          |
| **Description** | Nota opcional para identificarla.                                                                                       |
| **API Token**   | La cadena completa del token en el formato `nbt_{name}.{token}`: incluye el prefijo, el nombre y el separador de punto. |
| **URL**         | El host o la URL base de NetBox que Myrmex debe llamar.                                                                 |
| **Protocol**    | `https` o `http` (se recomienda HTTPS).                                                                                 |
| **Port**        | El puerto de la API (`443` o `80`).                                                                                     |
| **Collector**   | [Collector](/es/documentation/agent-endpoint-security/collector-mode) opcional para acceder a un NetBox privado.        |

## Conectar

Haz clic en **Connect** para validar el token y finalizar. NetBox aparecerá entonces en **Environment → Integrations**, listo para consultar en el Workspace.

<Note>
  Myrmex lee de NetBox en tiempo real mediante la API cada vez que lo solicitas: nada de tu instancia de NetBox se almacena del lado de Myrmex.
</Note>