Controller Acronis e Ubiquiti
Controller condiviso e associazione tenant
Un controller appartiene al Customer; l'associazione collega un'entità della sorgente al Tenant ShadowThreat. Non creare un controller nuovo per ogni tenant quando esiste già quello condiviso corretto.
Nel wizard Integrazioni → Aggiungi integrazione il catalogo stabilisce provider e capacità disponibili. Acronis e Ubiquiti possono esporre logs e inventory; selezionare almeno una capacità disponibile. Per Acronis l'inventario richiede un controller esistente con credenziali inventario configurate; un nuovo controller può partire dalla raccolta log.
Campi del wizard
| Campo | Configurazione |
|---|---|
| Integration name | Obbligatorio, massimo 120 caratteri nella UI. |
| Controller | Existing controller o Create a controller, se il contesto consente la creazione. È richiesta esattamente una delle due modalità. |
| Controller selezionato | Obbligatorio se esistente; per inventario Acronis sono disabilitati quelli senza inventario abilitato. |
| Controller name | Obbligatorio per un nuovo controller; backend massimo 200 caratteri. |
| Controller source IP | Obbligatorio per un nuovo Ubiquiti; indirizzo IP valido della sorgente. |
| Controller host | Facoltativo; massimo 253 caratteri, lettere, cifre, punti e trattini. Non inserire un URL con schema e percorso. |
| Acronis customer ID | ID Customer upstream copiato dalla console Acronis, non l'ID Customer ShadowThreat; obbligatorio, massimo 128 caratteri. |
| Ubiquiti site ID | ID del sito UniFi Network, non il nome visualizzato; obbligatorio, massimo 128 caratteri. |
| Site aliases | Ubiquiti: alias separati da virgole; backend massimo 20 elementi di 200 caratteri ciascuno. Spazi esterni ed elementi vuoti vengono rimossi. |
Esegui preflight, attivazione e controllo del risultato. Distingui configurazione riletta, primo evento e sincronizzazione inventario. Per la lettura generale degli stati vedi Integrazioni.
Amministrazione Acronis
In Advanced operations, Provision Acronis controller richiede:
| Campo | Significato |
|---|---|
| Customer | Customer della Console proprietario del controller. |
| Integration ID | Identificatore dell'integrazione da registrare; obbligatorio. |
| Display name | Nome obbligatorio del controller. |
| Target status | active o disabled; iniziale UI active. |
Dopo il provisioning verificare stato di registrazione e disponibilità del bundle. Download bundle scarica il materiale da installare nella sorgente; Retry registration riprende la registrazione prevista dal controllo.
Inventario Acronis
| Campo | Regola |
|---|---|
| Enable inventory API pull | Iniziale UI disattivo; abilita la raccolta inventario del controller. |
| API base URL | Obbligatorio quando l'inventario è attivo. |
| Auth base URL | Indirizzo base del servizio di autenticazione, se richiesto dalla configurazione. |
| Client ID | Identificatore applicativo della credenziale. |
| API key secret ref | Riferimento al segreto custodito, obbligatorio se inventario attivo; non il segreto da pubblicare nella wiki. |
Disabilitare l'inventario invia null per API base URL e API key secret ref. Non trattare quindi l'interruttore come una pausa che garantisce di mantenere entrambi i valori: prima di riabilitare ricontrollare la configurazione.
Rotazione certificati
- Start certificate rotation crea e scarica un nuovo bundle.
- Installa il nuovo materiale nella sorgente Acronis.
- Activate rotation richiede il Rotation ID della rotazione preparata.
- Verifica l'uso del nuovo certificato.
- Complete rotation richiede lo stesso identificatore per completare la procedura.
Cancel pending rotation annulla la rotazione pendente secondo lo stato consentito. Non avviare una seconda rotazione per compensare un risultato incerto: rileggere stato e Rotation ID.
Deprovision Acronis controller rimuove l'identità di integrazione runtime preservando i mapping dei tenant; non è sinonimo di cancellazione delle associazioni.
Amministrazione Ubiquiti
Upsert Ubiquiti controller registra o aggiorna i campi Customer, Integration ID, Display name, Source IP, Controller host e Status. Customer, ID, nome e IP sono obbligatori. Status ammette active, disabled, deprovisioned; il modulo propone active per una nuova compilazione.
Attach controller gestisce separatamente la relazione col tenant:
| Campo | Significato |
|---|---|
| Tenant | Tenant destinatario, obbligatorio. |
| Ubiquiti controller | Controller condiviso da associare, obbligatorio. |
| Upstream entity ID | ID del sito nella sorgente, obbligatorio. |
| Aliases | Alias separati da virgole, ripuliti dagli spazi. |
| Status | mapped o disabled; iniziale UI mapped. |
La rimozione di un attachment elimina quella relazione. Deprovision Ubiquiti controller rimuove invece il binding dell'IP sorgente preservando i mapping tenant: dopo la modifica controllare entrambi i livelli.