Configurare le directory configuring-directories

Per ogni dominio enterprise configurato, specifica le directory in cui il provider di autenticazione ricerca le informazioni dell’utente. Puoi configurare più directory per un dominio.

Aggiungere directory o SPI personalizzati adding-directories-or-custom-spis

Per ogni dominio enterprise configurato, specifica le directory in cui il provider di autenticazione ricerca le informazioni dell’utente. Puoi aggiungere una directory a un dominio enterprise esistente o a un nuovo dominio enterprise che stai aggiungendo. Puoi configurare più directory per un dominio. Inoltre puoi configurare un dominio per l’utilizzo di un’interfaccia del provider di servizi (SPI) personalizzata per la sincronizzazione.

Aggiungere una directory add-a-directory

Aggiungere un’interfaccia SPI personalizzata add-a-custom-spi

Per informazioni sulla creazione di un’interfaccia del provider di servizi (SPI) personalizzata, consulta “Sviluppare SPI per AEM Forms” in Programmare con AEM Forms. Per rendere disponibile una SPI personalizzata appena distribuita per l’associazione al dominio, riavvia il server.

Modificare una directory edit-a-directory

Puoi modificare i dettagli di una directory che hai configurato in precedenza.

Eliminare una directory delete-a-directory

Quando sincronizzi i domini dopo l’eliminazione di una directory, tutti gli utenti e i gruppi in tale directory vengono contrassegnati come obsoleti nel database. Non verranno restituiti in alcuna ricerca dalla console di amministrazione.

Impostazioni directory directory-settings

Quando aggiungi una directory a un dominio, specifica le seguenti impostazioni della directory.

Server: (obbligatorio) il nome dominio completo (FQDN) del server delle directory. Ad esempio, per un computer denominato x nella rete adobe.com, il nome dominio completo è x.adobe.com. Puoi utilizzare un indirizzo IP al posto del nome del server FQDN.

Porta: (obbligatoria) la porta utilizzata dal server delle directory. In genere, 389 o 636 se il protocollo SSL (Secure Sockets Layer) viene utilizzato per l’invio di informazioni di autenticazione sulla rete.

SSL: (obbligatorio) specifica se il server della directory utilizza SSL per l’invio di dati in rete. L’impostazione predefinita è no. Se impostato su sì, il certificato del server LDAP corrispondente deve essere considerato attendibile dall’ambiente runtime Java™ (JRE) del server applicazioni.

Binding (obbligatorio) specifica come accedere alla directory.

Anonimo: non è richiesto alcun nome utente o password. Un utente anonimo può essere in grado di recuperare solo una quantità limitata di dati. Questa opzione può essere utile per il test iniziale.

Utente: è richiesta l’autenticazione. Nella casella Nome, specifica il nome del record utente che può accedere alla directory. È consigliabile immettere il nome distinto completo (DN) dell’account utente, ad esempio cn=Jane Doe, ou=user, dc=can, dc=com. Nella casella Password, specifica la password associata. Queste impostazioni sono necessarie quando selezioni Utente come opzione di binding.

Nome: il nome che puoi utilizzare per la connessione al database LDAP quando l’accesso anonimo non è abilitato. Per Active Directory 2003, specifica [domain name]\[userid]. Per Sun™ One, eDirectory o IBM Tivoli Directory Server, specifica il nome completo dell’utente, ad esempio uid=lcuser,ou=it,o=company.com.

Password: la password corrispondente al nome specificato per la connessione al database LDAP quando l’accesso anonimo non è abilitato.

Popola pagina con: se selezioni questa opzione, popola gli attributi nelle pagine delle impostazioni Utente e Gruppo con i corrispondenti valori LDAP predefiniti.

Recupera DN di base: recupera i DN di base e li visualizza nell’elenco a discesa. Questa impostazione è utile quando disponi di più DN di base e devi selezionare un valore.

Abilita riferimento: questa impostazione è applicabile quando l’organizzazione utilizza più domini di Active Directory organizzati in una struttura gerarchica e hai specificato impostazioni di directory solo per il dominio principale. In questa situazione, quando selezioni questa opzione, gestione utenti può accedere ai dettagli di utenti e gruppi dai domini secondari.

Impostazioni utente user-settings

Identificatore univoco: (obbligatorio) un attributo univoco e costante utilizzato per identificare gli utenti. Utilizza un attributo non DN come identificatore univoco perché il DN di un utente può cambiare se viene spostato in un’altra parte dell’organizzazione. Questa impostazione dipende dal server delle directory. Il valore è objectGUID per Active Directory 2003, nsuniqueID per Sun™ One e guid per eDirectory.

DN di base: imposta come punto iniziale per la sincronizzazione di utenti e gruppi dalla gerarchia LDAP. È consigliabile specificare un DN di base al livello più basso della gerarchia che includa tutti gli utenti e i gruppi che devono essere sincronizzati per i servizi.

Se nelle impostazioni della directory hai selezionato l’opzione Abilita riferimento, imposta l’opzione DN di base sulla parte dc del DN. Affinché il riferimento funzioni, l’intervallo di ricerca deve includere entrambi i domini principale e figlio.

Sebbene il DN di base sia un’impostazione obbligatoria nella console di amministrazione, alcuni server delle directory, come IBM Domino Enterprise Server, potrebbero richiedere un DN di base vuoto. Per specificare un DN di base vuoto, esporta il file config.xml, modifica l’impostazione nel file config.xml, quindi reimportalo. Consulta Importazione ed esportazione del file di configurazione.

Filtro di ricerca: (obbligatorio) il filtro di ricerca da utilizzare per trovare il record associato all’utente. Puoi eseguire una ricerca a un livello o a un livello secondario. Consulta Sintassi del filtro di ricerca o RFC 2254. Per ulteriori informazioni sullo schema di Microsoft AD, consulta Schema di Active Directory.

Descrizione: l’attributo dello schema per la descrizione dell’utente

Nome completo: (obbligatorio) l’attributo dello schema per il nome completo dell’utente

ID accesso: (obbligatorio) l’attributo dello schema per l’ID di accesso dell’utente

Cognome: (obbligatorio) l’attributo dello schema per il cognome dell’utente

Nome assegnato: (obbligatorio) l’attributo dello schema per il nome dell’utente

Iniziali: l’attributo dello schema per le iniziali dell’utente

Calendario aziendale: ti consente di mappare un calendario aziendale a un utente in base al valore di questa impostazione (chiave del calendario aziendale). I calendari aziendali definiscono i giorni lavorativi e non lavorativi. AEM Forms può utilizzare i calendari aziendali per il calcolo di date e ore future per eventi quali promemoria, scadenze ed escalation. Il modo in cui assegni le chiavi del calendario aziendale agli utenti dipende dal fatto che utilizzi un dominio Enterprise, locale o ibrido. Consulta Configurazione dei calendari aziendali.

Se utilizzi un dominio Enterprise, puoi mappare l’impostazione del calendario aziendale a un campo nella directory LDAP. Ad esempio, se ogni record utente nella directory contiene un campo paese e desideri assegnare calendari aziendali in base al paese in cui si trova l’utente, specifica il nome del campo paese come valore per l’impostazione del calendario aziendale. Puoi quindi mappare le chiavi del calendario aziendale (i valori definiti per il campo paese nell’elenco LDAP) ai calendari aziendali in Forms Workflow.

Lo spazio utilizzato per visualizzare il nome della chiave del calendario aziendale nelle pagine di Forms Workflow è limitato. Limita il nome della chiave del calendario aziendale a meno di 53 caratteri per evitare che venga troncato su tali pagine.

Modifica marca temporale: per abilitare la sincronizzazione della directory delta, imposta questo valore per modificare la marca temporale. Consulta Abilitare la sincronizzazione della directory delta.

Organizzazione: l’attributo dello schema per il nome dell’organizzazione a cui appartiene l’utente.

E-mail principale: l’attributo dello schema per l’indirizzo e-mail principale dell’utente.

E-mail secondaria: l’attributo dello schema per l’indirizzo e-mail secondario dell’utente.

Telefono: l’attributo dello schema per il numero di telefono dell’utente.

Indirizzo postale: l’attributo dello schema per l’indirizzo postale dell’utente.

Impostazioni locali: l’attributo dello schema che contiene le informazioni ISO sulle impostazioni locali. Il valore è un codice lingua a due lettere o un codice lingua e paese.

Fuso orario: l’attributo dello schema che contiene il fuso orario in cui si trova l’utente. Il valore è una stringa come Città/Paese.

Abilita controllo VLV (Virtual List View): un controllo LDAP che consente ad AEM Forms di recuperare i dati in batch dal server delle directory. Se utilizzi Sun One come directory LDAP e la directory contiene molti utenti, l’abilitazione di VLV crea un indice utilizzabile da gestione utenti durante la ricerca degli utenti. Questa funzione è utile quando utilizzi un account utente normale in grado di sincronizzare solo una quantità limitata di dati. Puoi anche abilitare VLV per i gruppi. Se selezioni Abilita controllo VLV (Virtual List View), specifica un nome nella casella Ordina campo.

Ordina campo: se selezioni l’opzione Abilita controllo VLV (Virtual List View), specifica il nome dell’attributo utilizzato per ordinare l’indice. Questo nome attributo (ad esempio UID) è quello specificato quando crei un indice per VLV sul server delle directory.

Impostazioni gruppo group-settings

Identificatore univoco: (obbligatorio) l’attributo univoco e costante utilizzato per identificare i gruppi. Utilizza un attributo non DN come identificatore univoco. Questa impostazione dipende dal server delle directory. Il valore è objectGUID per Active Directory 2003, nsuniqueID per Sun One e guid per eDirectory.

DN di base: (obbligatorio) il nome distinto di base della directory.

Sebbene il DN di base sia un’impostazione obbligatoria nella console di amministrazione, alcuni server delle directory, come IBM Domino Enterprise Server, richiedono un DN di base vuoto. Per specificare un DN di base vuoto, esporta il file config.xml, modifica l’impostazione nel file config.xml, quindi reimportalo. Consulta Importazione ed esportazione del file di configurazione.

Filtro di ricerca: (obbligatorio) il filtro di ricerca da utilizzare per trovare il record associato al gruppo. Puoi eseguire una ricerca a un livello o a un livello secondario.

Descrizione: l’attributo dello schema per la descrizione del gruppo

Nome completo: (obbligatorio) l’attributo dello schema per il nome completo del gruppo

DN iscritto: (obbligatorio) l’attributo dello schema per il nome distinto degli iscritti di un gruppo

Identificatore univoco iscritto: l’identificatore univoco per un utente o un gruppo iscritto che appartiene al gruppo selezionato. Questo valore dipende dal server delle directory. Il valore è objectSID per AD2003, nsuniqueID per Sun One e guid per eDirectory.

Se DN iscritto è specificato con un attributo non DN, gestione utenti utilizza l’identificatore univoco iscritto per eseguire una query LDAP per raccogliere il DN dell’utente in quanto corrisponde a un valore identificatore univoco.

Se DN è specificato come identificatore univoco, non devi configurare l’identificatore univoco iscritto.

Organizzazione: l’attributo dello schema per il nome dell’organizzazione a cui appartiene il gruppo

E-mail principale: l’attributo dello schema per l’indirizzo e-mail principale del gruppo

E-mail secondaria: l’attributo dello schema per l’indirizzo e-mail secondario del gruppo

Modifica marca temporale: per abilitare la sincronizzazione della directory delta, imposta questo valore per modificare la marca temporale. Consulta Abilitare la sincronizzazione della directory delta.

Abilita controllo VLV (Virtual List View): un controllo LDAP che consente ad AEM Forms di recuperare i dati in batch dal server delle directory. Se utilizzi Sun One come directory LDAP e la directory contiene molti gruppi, l’abilitazione di VLV crea un indice utilizzabile da gestione utenti durante la ricerca dei gruppi. Questa funzione è utile quando utilizzi un account utente normale in grado di sincronizzare solo una quantità limitata di dati. Puoi inoltre abilitare VLV per gli utenti. Se selezioni Abilita controllo VLV (Virtual List View), specifica un nome per il campo di ordinamento.

Nome campo di ordinamento: se hai selezionato l’opzione Abilita controllo VLV (Virtual List View), specifica il nome dell’attributo utilizzato per ordinare l’indice. Questo nome attributo è quello specificato al momento della creazione di un indice per VLV sul server delle directory.

Se vengono restituiti utenti e gruppi, i risultati mostrano i valori assegnati a ciascun campo in base alla serie di attributi.

Configurare la gestione utenti per l’utilizzo di VLV (Virtual List View) configure-user-management-to-use-virtual-list-view-vlv

La sincronizzazione delle directory è un requisito importante per la gestione utenti. Gli utenti e i gruppi vengono sincronizzati da una directory Enterprise al database di AEM Forms per l’assegnazione di ruoli e autorizzazioni. Il numero di utenti varia da 100 a oltre 100.000 a seconda dei requisiti e rappresenta una sfida tecnica per sincronizzare i dati in modo efficiente.

Il protocollo LDAP fornisce un meccanismo per eseguire query su set di dati di grandi dimensioni su più pagine utilizzando i controlli di richiesta. Quando utilizzi Microsoft Active Directory, la sincronizzazione del database da LDAP ad AEM Forms utilizza PagedResultsControl per recuperare i dati in batch di dimensioni particolari. Sun ONE Directory Server non supporta questo controllo. Per completare una query su più pagine su Sun ONE Directory Server, utilizza il controllo VLV (Virtual List View). Questo controllo coinvolge sia la configurazione lato server delle directory che l’implementazione lato client.

Configurazione del server delle directory Sun ONE per VLV configuring-the-sun-one-directory-server-for-vlv

La creazione di un VLV richiede una coppia di voci che includono le classi oggetto vlvSearch e vlvIndex. La voce vlvSearch include una base di ricerca e l’attributo vlvFilter, che specifica la classe oggetto contenente gli attributi che desideri ordinare. La classe oggetto vlvIndex include l’attributo vlvSort, che specifica uno o più attributi da ordinare e il modo in cui ordinarli. (Il segno meno (-) indica l’ordine alfabetico inverso). L’utilizzo di VLV con AEM Forms richiede voci separate per gli utenti e i gruppi.

Di seguito è riportato un esempio di script LDIF per la voce VLV per gli utenti:

 dn: cn=lcuser,cn=userRoot,cn=ldbm database,cn=plugins,cn=config
 objectclass: top
 objectclass: vlvSearch
 cn: lcuser
 vlvBase: dc=corp,dc=adobe,dc=com
 vlvScope: 2
 vlvFilter: (&(objectclass=inetOrgPerson))
 aci: (target="ldap:///cn=lcuser,cn=userRoot,cn=ldbm database,cn=plugins,cn=config")(targetattr="*")(version 3.0; acl "Config"
 ;allow(read,search,compare) userdn="ldap:///all"; )
 dn: cn=lcuser,cn=lcuser,cn=userRoot,cn=ldbm database,cn=plugins,cn=config
 cn: lcuser
 vlvSort: cn
 objectclass: top
 objectclass: vlvIndex

Creare le voci oggetto utilizzando uno script

Creare l’indice del server delle directory per VLV create-the-directory-server-index-for-vlv

Dopo aver configurato le impostazioni della directory e creato le voci VLV LDAP per utenti e gruppi, arresta il server e crea l’indice richiesto.