Vai al contenuto
Bexxo Assistenza

Assistenza La piattaforma Importazione e SSO

Collegare Active Directory o LDAP

Per gli amministratori Aggiornato il 13 novembre 2026

Collegare una directory Active Directory o OpenLDAP installata nei vostri locali per sincronizzare le persone e i gruppi dell’organizzazione.
In questa pagina
  1. Panoramica
  2. Accesso di rete: chi interroga la directory
  3. Compilare la sezione Connessione
  4. Attributi letti e gruppi
  5. Verifica e risoluzione dei problemi

Panoramica

Questo articolo riguarda la sezione Connessione di un’importazione LDAP / Active Directory e ciò che è specifico di LDAP; le altre impostazioni sono comuni a tutte le importazioni. Questa fonte non offre SSO.

Le impostazioni comuni a tutte le importazioniImportare le persone e configurare l’SSO

Accesso di rete: chi interroga la directory

La vostra organizzazioneChe cosa prevedere
Senza l’opzione di crittografiaI nostri server si collegano da Internet: il nome del server deve risolversi unicamente verso indirizzi pubblici (un indirizzo privato o riservato viene rifiutato) e la porta 636 (LDAPS) o 389 (StartTLS) deve essere aperta verso di esso. Una directory raggiungibile solo dalla vostra rete interna non può essere letta in questo modo.
Con la crittografia lato clientIl vostro agente Bexxo Protected legge la directory: la sua macchina deve raggiungere il server LDAP. È l’unico modo per sincronizzare una directory non raggiungibile da Internet.

TLS è obbligatorio (ldaps o starttls): una connessione non cifrata viene rifiutata. Il certificato viene verificato sul nome inserito: usate il nome che figura nel certificato, non un indirizzo IP.

L’agente che legge la directory dalla vostra reteInstallare l’agente Bexxo Protected

Compilare la sezione Connessione

Predisponete un account di servizio in sola lettura, che possa leggere sotto i DN di base le persone, i gruppi e gli attributi elencati più sotto; una connessione anonima viene rifiutata. I campi facoltativi lasciati vuoti (rami e filtri degli utenti e dei gruppi, porta, attributo identificativo) assumono il valore predefinito: il DN di base per i rami e quello del tipo di directory per il resto. I campi da compilare con attenzione:

CampoContenuto
Server (host)Nome del server, senza ldap://, ad esempio ldap.exemple.ch.
Port e Crittografialdaps (636 per impostazione predefinita) o starttls (389 per impostazione predefinita).
DN di connessione (bind DN)DN completo dell’account di servizio, ad esempio CN=svc-bexxo,OU=Services,DC=exemple,DC=ch.
DN di base (base DN)Punto di partenza delle ricerche, ad esempio DC=exemple,DC=ch.
Tipo di directoryad (Active Directory) o openldap: imposta i valori predefiniti qui sotto.
Attributo identificativoUn attributo stabile che riconosce una persona o un gruppo da una sincronizzazione all’altra.

Tipo di directory e valori predefiniti

Impostazioneadopenldap
Filtro degli utenti(&(objectClass=user)(objectCategory=person))(objectClass=inetOrgPerson)
Filtro dei gruppi(objectClass=group)(objectClass=groupOfNames)
Attributo identificativoobjectGUIDentryUUID
Account disattivatoImportato come inattivo (attributo userAccountControl).Tutte le persone vengono importate come attive.

Un filtro LDAP personalizzato sostituisce il filtro predefinito: includetevi la classe di oggetto, ad esempio (&(objectClass=user)(objectCategory=person)(department=Vente)). Si applica prima dei filtri della sezione Filtri.

Non cambiate l’attributo identificativo dopo una prima sincronizzazione: le persone già importate non verrebbero più riconosciute. Una voce priva di questo attributo viene ignorata e conteggiata in un avviso del registro.

Attributi letti e gruppi

Vengono letti solo questi attributi, più l’attributo identificativo: sono gli unici utilizzabili nella corrispondenza dei campi e nei filtri.

OggettoAttributi
Personasn, givenName, cn, displayName, mail, mobile, telephoneNumber, preferredLanguage, dn, e accountEnabled (valore calcolato: true o false)
Gruppocn, displayName, description, member, dn

Le appartenenze vengono lette nell’attributo member dei gruppi. Il server deve supportare la paginazione dei risultati LDAP (« paged results »).

Oltre circa 1500 membri, Active Directory restituisce member solo a blocchi e la sincronizzazione non riesce anziché importare un gruppo incompleto. Mantenete gruppi più piccoli o restringete il DN di base dei gruppi.

Verifica e risoluzione dei problemi

La verifica della connessione si autentica, poi cerca una persona sotto il DN di base degli utenti, con il filtro degli utenti.

SituazioneDa verificare
Verifica non riuscita, organizzazione non cifrataIl nome si risolve verso un indirizzo pubblico, la porta è aperta da Internet, il certificato corrisponde al nome inserito?
Errore con una password correttaLa crittografia corrisponde alla porta (ldaps: 636, starttls: 389)? Il DN di connessione è completo?
La verifica riesce, ma non viene trovato nessunoIl DN di base e il filtro degli utenti corrispondono ai vostri account? Il tipo di directory è quello giusto?
Voci ignorate « per mancanza di un identificativo stabile »L’attributo identificativo non è leggibile: svuotate il campo per ripristinare il valore predefinito, oppure date all’account di servizio il diritto di leggerlo.
« Gruppo/i dell’ambito non trovato/i »Il gruppo non esiste più sotto il DN di base dei gruppi o non è più selezionato dal loro filtro: rimuovetelo da Gruppi importati.
Organizzazione cifrata: l’agente non risponde entro 10 minutiL’agente è avviato e la sua macchina raggiunge il server LDAP?

Non avete trovato la risposta? Contattarci