# Enterprise Connectors

Gestire i connector on-premises che collegano la propria rete alla piattaforma per autenticazione, sincronizzazione e provisioning.

Un **Enterprise Connector** è un software leggero da installare all'interno della propria rete. Apre una connessione in uscita persistente verso la piattaforma e la mantiene attiva; dal lato del cliente nulla resta in ascolto di connessioni in entrata e il firewall non richiede alcuna regola in ingresso. Le richieste verso Active Directory o LDAP transitano su questa connessione fino al connector, che comunica localmente con la directory. Tutti i connector sono gestiti in un unico punto, in **Directory → Enterprise Connectors**, con una panoramica di ogni connector, del suo stato e del suo utilizzo.

## Tipi di connector

Il tipo si sceglie alla creazione del connector e **non può essere modificato in seguito**:

| Tipo | Scopo | Associato a |
|---|---|---|
| **Autenticazione** | Convalida gli accessi rispetto ad Active Directory / LDAP e sincronizza gli utenti per una directory aziendale. | Esattamente una directory utenti. |
| **Provisioning** | Instrada il provisioning in uscita (SCIM) verso applicazioni che si trovano all'interno della propria rete. | Nessuna directory: sono le applicazioni a selezionarlo. |

Un connector di autenticazione deve essere associato a una directory. Una directory può avere **più** connector di autenticazione: ogni richiesta di accesso e di sincronizzazione viene inviata al connector con la latenza misurata più bassa in quel momento e, se un connector non è più disponibile, gli altri ne assumono il compito.

## Creare e registrare un connector

1. Aprire **Directory → Enterprise Connectors** e scegliere di creare un nuovo connector.
2. Inserire un **Nome** e selezionare il **Tipo**.
3. Per un connector di **Autenticazione**, selezionare la **Directory** che servirà. Questo dato è obbligatorio: il primo connector di autenticazione di una directory stabilisce la chiave sicura con cui la directory protegge le password end-to-end, quindi deve sapere a quale directory appartiene.
4. Salvare. Il connector viene visualizzato con un **URL di provisioning** e uno stato in sospeso.
5. Installare il software del connector nella propria rete e registrarlo con questo URL di provisioning. Non appena si connette, il suo stato passa a **Ready**. La procedura completa, inclusi i requisiti e il download del programma di installazione, è descritta in [Installare un Enterprise Connector](https://dts-identity.com/it/docs/directories/enterprise-connector-installation.md).

L'URL di provisioning è monouso e scade dopo alcuni giorni. Se scade prima della registrazione, eliminare il connector in sospeso e crearne uno nuovo.

### Più connector e la chiave condivisa

Tutti i connector di autenticazione della stessa directory devono funzionare con la **stessa coppia di chiavi**. Il primo connector che si registra imposta la chiave per la directory; ogni connector successivo deve presentare la stessa, altrimenti la registrazione viene rifiutata. In questo modo la protezione delle password resta coerente indipendentemente dal connector che gestisce un determinato accesso.

## Stato e monitoraggio

Ogni connector mostra il proprio stato attuale:

- **Ready**: connesso e disponibile.
- **Connesso**: connesso ma non ancora completamente inizializzato.
- **In sospeso**: creato ma non ancora registrato.
- **Disconnesso**: attualmente non connesso.

Aprire un connector per visualizzarne i dettagli dell'host, la versione, l'ultimo orario online e, finché è connesso, un grafico in tempo reale del round-trip time.

Ogni cambio di stato viene registrato nel log di audit come `CONNECTOR_ONLINE` / `CONNECTOR_OFFLINE`. Quando la maggioranza dei connector di autenticazione registrati di una directory è offline, un evento aggiuntivo `DIRECTORY_DEGRADED` segnala che l'accesso tramite quella directory potrebbe essere compromesso. Utilizzare il modello di allarme **Directory degradata** per ricevere una notifica in merito.

### Avviso di aggiornamento

Quando è disponibile una release più recente del connector, la dashboard di amministrazione mostra in cima alla pagina un avviso con l'elenco dei connector che eseguono una versione precedente e la voce **Enterprise Connectors** nella navigazione riporta un punto rosso. I connector che non hanno mai comunicato una versione, o che non sono stati rilevati da 30 giorni, non vi compaiono. L'elenco dei connector contrassegna ogni connector che non esegue l'ultima release con il badge **Aggiornamento disponibile**, inclusi i connector offline da più tempo. L'avviso scompare non appena tutti i connector attivi eseguono l'ultima release.

## Provisioning tramite un connector

Quando un'applicazione esegue il provisioning degli utenti in un sistema che si trova all'interno della propria rete, è possibile instradare tale provisioning tramite uno o più connector di **Provisioning**. Nella scheda **Provisioning** dell'applicazione, in **Connettività**, selezionare i connector da utilizzare in ordine di priorità. Se sono selezionati dei connector, il provisioning passa **esclusivamente** attraverso di essi; se non ne è selezionato nessuno, la piattaforma si connette alla destinazione direttamente tramite Internet.

## Rimuovere un connector

Un connector può essere eliminato quando è **Offline**. Disconnettere o arrestare prima il connector nella propria rete, quindi eliminarlo qui.

## Risoluzione dei problemi

- **Il connector resta In sospeso**: l'URL di provisioning non è stato utilizzato in tempo oppure il connector non riesce a raggiungere la piattaforma. Verificare la connettività in uscita e, se l'URL è scaduto, ricreare il connector.
- **Registrazione rifiutata per un connector aggiuntivo**: un secondo connector di autenticazione sulla stessa directory deve utilizzare la stessa coppia di chiavi del primo. Riutilizzare la chiave esistente.
- **Il connector si connette ma viene rifiutato per una chiave pubblica non corrispondente**: il connector utilizza una coppia di chiavi diversa da quella memorizzata per la sua directory. Importare in questo connector la coppia di chiavi esportata dal connector originale della directory; se tale coppia di chiavi è andata persa, rimuovere tutti i connector di autenticazione della directory e registrarli di nuovo.
- **Impossibile eliminare un connector**: è ancora online. Arrestarlo prima, quindi eliminarlo.

Per il software nella propria rete, vedere [Installare un Enterprise Connector](https://dts-identity.com/it/docs/directories/enterprise-connector-installation.md) e [Configurare e gestire un Enterprise Connector](https://dts-identity.com/it/docs/directories/enterprise-connector-configuration.md).
