# Configurare e gestire un Enterprise Connector

Origine dati, TLS, stato, log e diagnostica nell'applicazione Enterprise Connector installata sulla propria macchina.

Una volta registrato un connettore, la sua configurazione risiede nell'applicazione del connettore sulla macchina all'interno della propria rete, non nella console. Questa pagina descrive tale applicazione.

## La finestra dell'applicazione

In alto a sinistra, il **selettore di connettore** determina quale dei connettori installati si sta consultando. Ogni pagina sotto il selettore si riferisce al connettore selezionato, quindi conviene controllarlo per primo quando una pagina mostra valori inattesi.

Le pagine disponibili dipendono dal tipo di connettore selezionato:

| Area | Pagine | Disponibile per |
|---|---|---|
| **Home** | Agents, Status | Ogni connettore |
| **Configure** | Data source, Identity | Connettori di autenticazione |
| **Configure** | Provisioning target, Identity | Connettori di provisioning |
| **Insight** | Logs, Diagnostics | Diagnostics per i connettori di autenticazione, Logs per ogni connettore |
| **Explore** | Users, Groups, Directory structure | Connettori di autenticazione |
| **Update** | Release notes, Update | Ogni connettore |

## Data source (connettori di autenticazione)

**Configure → Data source** contiene la connessione ad Active Directory o LDAP. Le modifiche hanno effetto senza riavviare il servizio.

**Connessione**

| Campo | Significato |
|---|---|
| **Protocol** | `ldaps://` (cifrato, consigliato) oppure `ldap://`. La scelta della variante non cifrata mostra un avviso, perché in tal caso le credenziali di bind e i dati della directory transitano in chiaro. |
| **Host**, **Port** | Indirizzo del domain controller o del server LDAP, normalmente porta 636 per LDAPS e 389 per LDAP. |
| **Bind DN**, **Bind password** | L'account di servizio con cui il connettore si autentica. L'accesso in lettura è sufficiente finché non sono attive la sincronizzazione upstream o la riscrittura delle password. |
| **Base DN** | La radice del sottoalbero in cui opera il connettore. |
| **Custom CA certificates (PEM)** | Certificati delle autorità a cui la connessione LDAPS deve dare fiducia in aggiunta all'archivio certificati di sistema. Indipendenti dai certificati configurati per la connessione alla piattaforma. |
| **Ignore invalid certificates** | Disattiva la verifica dei certificati per la connessione LDAPS. Utilizzarlo solo come misura temporanea. |

**Users** e **Groups** accettano ciascuno un **additional base DN**, che viene accodato alla base DN, e un **filtro**. Insieme determinano quali oggetti il connettore consegna alla piattaforma. Filtri stretti mantengono veloce la sincronizzazione ed evitano che account di servizio o di sistema finiscano tra gli utenti.

**Test settings** esegue un test di connessione con i valori attualmente presenti nel modulo e riporta il risultato, inclusi i conteggi degli oggetti. Utilizzarlo dopo ogni modifica, prima di salvare.

Le operazioni sulla directory utilizzano per impostazione predefinita un timeout di dieci secondi, sufficiente per un domain controller sotto carico su una linea lenta. Un accesso utente che lo supera viene considerato un accesso non riuscito, quindi conviene indagare timeout ripetuti sul lato directory anziché aumentare la tolleranza.

## Provisioning target (connettori di provisioning)

**Configure → Provisioning target** stabilisce che cosa un connettore di provisioning è autorizzato a raggiungere:

- **Allowed target origins** è l'elenco dei sistemi verso cui questo connettore può inoltrare richieste di provisioning, una voce per riga. Una voce può indicare un'origin, ad esempio `https://scim.example`, oppure un'origin con un prefisso di percorso per restringerla ulteriormente. **Un elenco vuoto rifiuta tutto**, ed è lo stato previsto finché non si autorizza deliberatamente una destinazione.
- **Custom CA certificates** e **Ignore invalid certificates** funzionano come i corrispondenti nella pagina dell'origine dati, riferiti alla connessione verso la destinazione.

L'elenco di autorizzazioni è un confine di contenimento: delimita quali sistemi della propria rete sono raggiungibili tramite questo connettore. Conviene mantenerlo stretto quanto l'integrazione consente.

## Identity (connessione alla piattaforma)

**Configure → Identity** riguarda il modo in cui il connettore dialoga con la piattaforma:

- **Custom CA certificates (PEM)** sono i certificati delle autorità a cui la connessione alla piattaforma deve dare fiducia, necessari quando la rete intercetta il traffico TLS oppure quando il certificato della piattaforma proviene da un'autorità privata. Questa impostazione viene applicata dal servizio del connettore all'avvio, quindi dopo una modifica il servizio deve essere riavviato.
- **Ignore invalid certificates** disattiva la verifica di quella connessione. Utilizzarlo solo come misura temporanea.
- **Export keypair** raccoglie la coppia di chiavi del connettore in un blocco cifrato con una passphrase. Serve per registrare un altro connettore per la stessa directory oppure per spostare questo connettore su un'altra macchina. La passphrase protegge la chiave privata e non può essere recuperata, quindi occorre conservare entrambe le parti in un luogo sicuro ed eliminare il blocco esportato dopo l'uso.

## Status

**Home → Status** mostra tre indicatori per il connettore selezionato: il **Service** locale, la connessione a **Identity** e la connessione alla **Data source** oppure al **Provisioning target**. Sotto di essi compare in tempo reale l'attività recente: esecuzioni di sincronizzazione con i relativi conteggi di utenti, accessi riusciti e non riusciti, modifiche di password e traffico di provisioning con il relativo numero di errori.

È il modo più rapido per distinguere un problema del connettore da un problema della piattaforma. Un connettore il cui servizio è disponibile e la cui connessione alla piattaforma è attiva, ma la cui origine dati è disconnessa, indirizza verso il servizio di directory o verso le credenziali nella pagina dell'origine dati.

## Esplorare la directory

**Explore → Users**, **Groups** e **Directory structure** mostrano, direttamente dall'origine, che cosa il connettore vede realmente con le base DN e i filtri attuali. Servono a verificare un filtro prima di abilitare la sincronizzazione e a capire se un utente assente nella piattaforma manca già all'origine oppure è escluso da un filtro.

## Logs

**Insight → Logs** elenca i file di log del connettore selezionato e offre una vista **Live** che segue il file corrente. I file di log vengono ruotati e limitati nelle dimensioni, quindi non possono crescere senza limiti.

I log restano sulla macchina. Nulla di essi raggiunge la piattaforma finché non viene inviato un pacchetto di diagnostica.

## Diagnostica

**Insight → Diagnostics** compone un pacchetto di supporto a partire dalle categorie selezionate:

| Categoria | Contenuto |
|---|---|
| **Logs** | I file di log del connettore. Inclusi per impostazione predefinita. |
| **Settings** | La configurazione dell'origine dati: host, bind DN, base DN e filtri. La bind password viene omessa. |
| **Connection test** | Il risultato di un nuovo test di connessione. |
| **Users**, **Groups**, **Directory structure** | I dati di directory così come il connettore li legge. Non inclusi per impostazione predefinita, perché contengono dati personali. |

**Download** salva il pacchetto in locale, in modo da poterlo esaminare prima di condividerlo. **Upload to support** lo trasferisce direttamente. Controllare le categorie selezionate prima del caricamento: le categorie di directory contengono dati personali dei propri utenti.

## Note operative

- I connettori funzionano come servizi Windows e continuano a operare quando la finestra dell'applicazione è chiusa.
- L'arresto di un connettore di autenticazione interrompe gli accessi della sua directory, a meno che un altro connettore della stessa directory non sia online.
- Origine dati, destinazione di provisioning e filtri di directory hanno effetto immediato. I certificati per la connessione alla piattaforma hanno effetto dopo un riavvio del servizio.
- La pagina **Update → Release notes** elenca le modifiche di ogni versione.

## Risoluzione dei problemi

- **Identity risulta connesso ma il connettore non è utilizzabile.** Il connettore ha raggiunto la piattaforma ma non è stato accettato. Di norma ciò segue l'eliminazione o la ricreazione del record del connettore nella console. Registrare nuovamente il connettore con un URL di provisioning aggiornato.
- **L'origine dati risulta disconnessa.** Testare la connessione nella pagina dell'origine dati. Le cause frequenti sono una password scaduta dell'account di bind, una regola firewall tra la macchina e il domain controller e un certificato LDAPS a cui la macchina non dà fiducia.
- **Gli accessi non riescono mentre la sincronizzazione funziona.** L'account di bind può leggere, ma gli utenti non riescono a effettuare il bind, oppure il filtro utenti li esclude. Controllare il filtro utenti nella pagina dell'origine dati e verificare l'account in **Explore → Users**.
- **Dopo una sincronizzazione mancano degli utenti.** Controllare per primi l'additional base DN e il filtro utenti, quindi verificare in **Explore → Users** che il connettore veda effettivamente gli account.
- **Una modifica di password viene rifiutata.** Per una directory con protezione end-to-end delle password, i criteri password sono applicati dal connettore. Aggiornare il connettore quando il messaggio non corrisponde ai criteri configurati nella console.

## Vedere anche

- [Installare un Enterprise Connector](https://dts-identity.com/it/docs/directories/enterprise-connector-installation.md) per requisiti, installazione, aggiornamenti e rimozione.
- [Enterprise Connectors](https://dts-identity.com/it/docs/directories/enterprise-connectors.md) per il lato console.
- [Directory utenti](https://dts-identity.com/it/docs/directories/user-directories.md) per la sincronizzazione, la riscrittura delle password e le impostazioni di directory in sé.
