Skip to Content

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:

AreaPagineDisponibile per
HomeAgents, StatusOgni connettore
ConfigureData source, IdentityConnettori di autenticazione
ConfigureProvisioning target, IdentityConnettori di provisioning
InsightLogs, DiagnosticsDiagnostics per i connettori di autenticazione, Logs per ogni connettore
ExploreUsers, Groups, Directory structureConnettori di autenticazione
UpdateRelease notes, UpdateOgni 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

CampoSignificato
Protocolldaps:// (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, PortIndirizzo del domain controller o del server LDAP, normalmente porta 636 per LDAPS e 389 per LDAP.
Bind DN, Bind passwordL'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 DNLa 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 certificatesDisattiva 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:

CategoriaContenuto
LogsI file di log del connettore. Inclusi per impostazione predefinita.
SettingsLa configurazione dell'origine dati: host, bind DN, base DN e filtri. La bind password viene omessa.
Connection testIl risultato di un nuovo test di connessione.
Users, Groups, Directory structureI 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

In questa pagina