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

# UniFi Controller

> Collega Ubiquiti UniFi a Myrmex con una API key di UniFi Site Manager — crea la key e aggiungi l'integrazione.

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

Collega il tuo parco **Ubiquiti UniFi** in modo che Myrmex possa leggere in tempo reale le tue sedi, console, dispositivi e client per inventario e analisi. Myrmex si connette tramite l'**API UniFi Site Manager** (`api.ui.com`) utilizzando una API key.

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Leggi l'inventario" icon="boxes-stacked">
    Elenca sedi, console, dispositivi UniFi e client connessi in tutto il tuo parco, su richiesta.
  </Card>

  <Card title="Stato e integrità" icon="chart-line">
    Verifica lo stato dei dispositivi, l'adozione e l'uptime per le sedi che gestisci.
  </Card>

  <Card title="Audit di hardening" icon="shield-halved">
    Porta l'inventario UniFi in una revisione di [Security Posture](/it/documentation/security-posture/overview).
  </Card>

  <Card title="Chiedi nel Workspace" icon="magnifying-glass">
    Interroga il tuo ambiente UniFi in linguaggio naturale durante le indagini.
  </Card>
</CardGroup>

## Prima di iniziare

* Un **account UniFi Site Manager** (`unifi.ui.com`) con accesso alle console e alle sedi che desideri collegare.
* L'autorizzazione a creare una **API key** in Site Manager.
* Il **Console ID** e il **Site ID** della console/sede che desideri far leggere a Myrmex.

## Passo 1 — Crea la API Key in UniFi Site Manager

<Steps>
  <Step title="Apri UniFi Site Manager">
    Accedi a UniFi Site Manager all'indirizzo `unifi.ui.com`.
  </Step>

  <Step title="Crea una API key">
    Apri **Settings → API** (Control Plane) e crea una nuova **API Key**. Assegnale un nome descrittivo.
  </Step>

  <Step title="Copia la key">
    Copia immediatamente la key generata e conservala in modo sicuro — viene mostrata una sola volta. La incollerai in Myrmex.
  </Step>

  <Step title="Annota i Console e Site ID">
    Registra il **Console ID** e il **Site ID** dell'ambiente che desideri far leggere a Myrmex.
  </Step>
</Steps>

## Passo 2 — Aggiungi l'integrazione in Myrmex

Dal **Directory**, scegli **Add Integration → UniFi Controller**, quindi compila:

| Field           | Descrizione                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Name**        | Un nome univoco per questo ambiente UniFi.                                                                         |
| **Description** | Nota opzionale per identificarlo.                                                                                  |
| **API Key**     | La API key di UniFi Site Manager del Passo 1, inviata come header `X-API-Key`.                                     |
| **Host**        | L'host dell'API (predefinito `api.ui.com`).                                                                        |
| **Port**        | La porta HTTPS (predefinita `443`).                                                                                |
| **Console ID**  | L'identificatore della console UniFi da leggere.                                                                   |
| **Site ID**     | L'identificatore della sede all'interno di tale console.                                                           |
| **Collector**   | [Collector](/it/documentation/agent-endpoint-security/collector-mode) opzionale per instradare la connessione API. |

## Connetti

Fai clic su **Connect** per convalidare la API key e completare. UniFi appare quindi in **Environment → Integrations**, pronto per essere interrogato nel Workspace.

<Note>
  Myrmex legge da UniFi in tempo reale tramite l'API ogni volta che lo richiedi — nulla proveniente dal tuo ambiente UniFi viene memorizzato lato Myrmex.
</Note>