Skip to Content

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:

TipoScopoAssociato a
AutenticazioneConvalida gli accessi rispetto ad Active Directory / LDAP e sincronizza gli utenti per una directory aziendale.Esattamente una directory utenti.
ProvisioningInstrada 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.

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 e Configurare e gestire un Enterprise Connector.

In questa pagina