> ## 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

> Collega NetBox a Myrmex con un token dell'API REST — crea il token e aggiungi l'integrazione.

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

Collega il tuo IPAM/DCIM **NetBox** in modo che Myrmex possa leggere in tempo reale il tuo inventario di riferimento (source of truth) — sedi, rack, dispositivi, indirizzi IP, prefissi e VLAN. Myrmex si connette tramite l'**API REST di NetBox** utilizzando un token API.

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Leggi l'inventario" icon="boxes-stacked">
    Recupera sedi, rack, dispositivi, indirizzi IP, prefissi e VLAN dalla tua source of truth, su richiesta.
  </Card>

  <Card title="Stato e metriche" icon="chart-line">
    Verifica lo stato e le metriche di IPAM/DCIM di NetBox tramite l'API.
  </Card>

  <Card title="Correlazione incrociata" icon="diagram-project">
    Metti in relazione i record NetBox con i dati provenienti dalle tue altre integrazioni durante le indagini.
  </Card>

  <Card title="Chiedi nel Workspace" icon="magnifying-glass">
    Interroga il tuo inventario in linguaggio naturale.
  </Card>
</CardGroup>

## Prima di iniziare

* Un'istanza **NetBox** raggiungibile (Myrmex si connette tramite HTTPS; facoltativamente attraverso un [Collector](/it/documentation/agent-endpoint-security/collector-mode) se NetBox si trova su una rete privata).
* Un **account utente** NetBox le cui autorizzazioni coprano gli oggetti che desideri far leggere a Myrmex (la sola lettura è sufficiente per l'analisi).
* L'autorizzazione a creare un **token API** per quell'utente.

## Passo 1 — Crea il token API in NetBox

<Steps>
  <Step title="Apri i tuoi token API">
    In NetBox, apri il menu utente e vai su **API Tokens** (oppure **Admin → API Tokens**).
  </Step>

  <Step title="Aggiungi un token">
    Fai clic su **Add a token** e assegnalo all'account in sola lettura. Deseleziona **Write enabled** per mantenere il token in sola lettura.
  </Step>

  <Step title="Copia il token completo">
    Copia l'intera stringa del token, incluso il prefisso, il nome e il separatore a punto — il formato è `nbt_{name}.{token}`. Conservalo in modo sicuro; lo incollerai in Myrmex.
  </Step>
</Steps>

<Tip>
  Limita il token a un account in sola lettura e, se supportato, restringilo per IP di origine in modo che possa essere usato solo dal tuo Collector o da Myrmex.
</Tip>

## Passo 2 — Aggiungi l'integrazione in Myrmex

Dal **Directory**, scegli **Add Integration → NetBox**, quindi compila:

| Field           | Descrizione                                                                                                         |
| --------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nome univoco per questa istanza NetBox.                                                                          |
| **Description** | Nota opzionale per identificarla.                                                                                   |
| **API Token**   | L'intera stringa del token nel formato `nbt_{name}.{token}` — includi il prefisso, il nome e il separatore a punto. |
| **URL**         | L'host o l'URL di base di NetBox che Myrmex deve contattare.                                                        |
| **Protocol**    | `https` o `http` (HTTPS consigliato).                                                                               |
| **Port**        | La porta dell'API (`443` o `80`).                                                                                   |
| **Collector**   | [Collector](/it/documentation/agent-endpoint-security/collector-mode) opzionale per raggiungere un NetBox privato.  |

## Connetti

Fai clic su **Connect** per convalidare il token e completare. NetBox appare quindi in **Environment → Integrations**, pronto per essere interrogato nel Workspace.

<Note>
  Myrmex legge da NetBox in tempo reale tramite l'API ogni volta che lo richiedi — nulla proveniente dalla tua istanza NetBox viene memorizzato lato Myrmex.
</Note>