Representar atributos de LDAP a elementos en la página de registro del Geoportal

La página de registro proceso de registro del geoportal, de uso inmediato, muestra varios campos que se pueden representar en el LDAP de una organización. Tenga en cuenta que el nombre de usuario y contraseña son obligatorios porque son necesarios para iniciar sesión. El correo electrónico es obligatorio para que el administrador del Geoportal pueda contactar a un usuario si es necesario. Otros campos son opcionales. Este tema explica cómo se pueden agregar o eliminar los campos de esta página de proceso de registro. IMPORTANTE: Es necesario entender los conceptos de LDAP descritos en el artículo Conceptos importantes de LDAP antes de continuar.

Los campos que se muestran en la página de proceso de registro se representan en LDAP y se les llama "atributos". Puede ver los atributos disponibles en LDAP al visualizar un usuario, usando la herramienta de exploración del Directorio como Apache Directory Studio. En Apache Directory Studio, abra la conexión LDAP y vaya al nodo de usuarios. Seleccione un usuario del árbol. Nótese que, al seleccionar el usuario, todos los atributos asignados a ese usuario se muestran en el lado derecho de la ventana. Cada entidad en la estructura LDAP tiene atributos relacionados con la misma. Estos atributos se definen por medio del Formato de intercambio de datos de LDAP y asignan la información al usuario o al grupo. El archivo gpt.xml del Geoportal usa atributos que se definen en LDAP para definir los campos en la página de proceso de registro del geoportal. Observe el nombre de los atributos en la columna "Descripción de atributos" en la izquierda. Si abre el archivo gpt.xml desde su carpeta \\geoportal\WEB-INF\classes\gpt\config, verá que estos atributos corresponden a los valores "ldapName" de los atributos que se definen en la sección <userAttributeMap>.

Es probable que no todos los atributos que aparecen en su directorio LDAP aparezcan listados en gpt.xml y viceversa: es posible que no todos los atributos de gpt.xml aparezcan listados en su estructura de LDAP. La manera en la que se definen estos elementos se debe discutir con el administrador de LDAP en su organización.

Agregar un campo adicional a la página de proceso de registro del Geoportal

Siga los pasos a continuación para agregar un campo adicional a la página de proceso de registro del Geoportal:

1. Navegue a la carpeta \\geoportal\WEB-INF\classes\gpt\config y abra el archivo gpt.xml en un editor de texto.
2. Cree una nueva etiqueta <attribute> en la sección <userAttributeMap> del archivo gpt.xml
   • Al atributo de clave, dele un valor de cadena de caracteres, preferiblemente uno que identifique fácilmente los datos a introducir (es decir, telephoneExtension, employeeNumber)
   • Para el atributo IdapName, elija un atributo LDAP que no se use en ningún otro atributo. Este atributo debe corresponder a un atributo LDAP que se muestre en su herramienta de exploración del directorio LDAP (por ejemplo, Apache Directory Studio).
   • Por ejemplo, para agregar un campo al número de teléfono de casa en la página de proceso de registro del Geoportal, agregue un nuevo atributo a la lista en gpt.xml como se muestra a continuación. Asigne el atributo de clave como "home_phone" y represente el atributo IdapName para "homePhone", un atributo que no se usa en LDAP según se ve en la captura de pantalla de la vista de tabla.

      
     <userAttributeMap>          
     <attribute key="username"     ldapName="uid"/>          
     <attribute key="password"     ldapName="userPassword"/>          
     <attribute key="email"        ldapName="mail"/>          
     <attribute key="firstName"    ldapName="givenName"/>          
     <attribute key="lastName"     ldapName="sn"/>          
     <attribute key="organization" ldapName="o"/>            
     <attribute key="affiliation"  ldapName="businessCategory"/>               
     <attribute key="street"       ldapName="street"/>                   
     <attribute key="city"         ldapName="l"/>                
     <attribute key="stateOrProv"  ldapName="st"/>                
     <attribute key="postalCode"   ldapName="postalCode"/>            
     <attribute key="country"      ldapName=""/>            
     <attribute key="phone"        ldapName="telephoneNumber"/>          
     <attribute key="home_phone" ldapName="homePhone"/>          
     </userAttributeMap>
     

3. Ahora, navegue a la carpeta \\geoportal\catalog\identity y abra userAttributes.jsp en un editor de texto. Agregue un nuevo conjunto de etiquetas de salida, teniendo cuidado de usar el nombre clave del atributo en los parámetros:

   <% // home phone number %>  
   <h:outputLabel for="home_phone" rendered="#{SelfCareController.hasUserAttribute['home_phone']}"    
   value="#{gptMsg['catalog.identity.profile.label.home_phone']}"/>  
   <h:inputText id="home_phone" size="30" maxlength="128"  rendered="#{SelfCareController.hasUserAttribute['home_phone']}"    
   value="#{SelfCareController.activeUserAttributes['home_phone'].value}"/>

4. Observe que 'catalog.identity.profile.label.home_phone' se usa para generar el nombre de la etiqueta en la página de proceso de registro. Debe agregar esta entrada a su archivo gpt.properties en la carpeta \\geoportal\WEB-INF\classes\gpt\resources. La nueva entrada en gpt.properties para nuestro ejemplo de número de teléfono de casa es:

   catalog.identity.profile.label.home_phone	= Home Phone Number:

5. Después de actualizar userAttributes.jsp y gpt.properties, guarde ambos archivos y ciérrelos. Después, reinicie la aplicación Web del geoportal.
6. Para ver cómo se relaciona la página de proceso de registro a LDAP, inicie el sitio del Geoportal y haga clic en el botón "Registrar".
7. Registre un nuevo usuario al introducir los elementos de la información obligatoria y proporcionar información que acaba de personalizar; por ejemplo, número de teléfono de casa.
8. Haga clic en "Registrar".
9. Ahora actualice la vista en el explorador del directorio LDAP para ver el nuevo usuario agregado al árbol. Haga clic en el nuevo usuario y vea cómo se asignan las propiedades en LDAP, incluyendo el nuevo número de teléfono de casa.