Configuración de la utilidad ADSync

Este artículo contiene los siguientes temas:

Este artículo explica cómo configurar la utilidad ADSync.

Configuraciones en Cloud Service Management 

Configure cómo el servidor de Cloud Service Management interactúa con la utilidad ADSync.

Configuración de la información de cliente y las propiedades de sincronización

El archivo sync.properties contiene la información de Cloud Service Management para el cliente. La utilidad ADSync está configurada con las credenciales de inicio de sesión del administrador del cliente o de la suborganización.

Solo se pueden sincronizar los datos de los usuarios mediante la utilidad.

Para obtener más información sobre el archivo sync.properties, consulte Archivo sync.properties.

Configuración del modo de gestión de la supresión de usuarios

Para configurar cómo Cloud Service Management trata la detección de datos de usuarios, vaya a GESTIÓN, Herramientas, Parámetros de la configuración. Configure el siguiente parámetro:

• ACTIVE_DIRECTORY_USERS_DEPROVISION_USERS_THRESHOLD

No hay registros eliminados si el número de registros que están marcados para su eliminación es superior a este valor. No se ve afectada la sincronización de los datos restantes.

Configuración de la utilidad ADSync del lado del cliente (LDAP)

La utilidad ADSync se basa en un conjunto de archivos de configuración. Estos archivos se entregan con la utilidad ADSync. Los archivos se encuentran en la carpeta de la utilidad ADSync. El equipo de soporte de ServiceAide no tiene acceso a estos archivos. En este paso, se configuran estos archivos con la siguiente información del entorno y, a continuación, se ejecuta una prueba de la utilidad:

• Información de conexión para el servidor LDAP
• Información de conexión de Cloud Service Management
• Cómo se asignan los valores en el servidor LDAP y los campos en los archivos de configuración de Cloud Service Management

Todos estos archivos se encuentran en la carpeta de la utilidad de ADSync. Cuando se configuran estos archivos, asegúrese de mantener su ubicación en esta carpeta. Todos los archivos de ADSync deben permanecer en la misma ubicación relativa en la que se descomprimen. Se puede mover toda la carpeta de la utilidad ADSync, pero todos los archivos deben permanecer juntos.

Antes de iniciar la sincronización, asegúrese de que se ha definido la estructura de organización en Cloud Service Management.

Archivos de configuración de la utilidad ADSync

Este tema explica los archivos de configuración que se incluyen con la utilidad ADSync.

searchBase.list

Este archivo contiene una lista de todas las unidades de organización (OU). La lista se utiliza para extraer datos del usuario que se envían a Cloud Service Management. Cada línea está formada por una OU completa como:

• OU=Users,DC=Bedford,DC=Nimsoft Service Desk,DC=InteQ,DC=com
• OU=Users,DC=Boston,DC=Nimsoft Service Desk,DC=InteQ,DC=com
• OU=Users,DC=Seattle,DC=Nimsoft Service Desk,DC=InteQ,DC=com

Si el archivo searchBase.list está vacío, la utilidad busca los datos de todos los registros en el servidor LDAP.

attribute_map.list

Este archivo contiene una lista de todos los atributos de usuario que se tienen que recopilar para cada cuenta de usuario. Se edita este archivo para aplicar el nombre del atributo apropiado de Active Directory para los campos de Cloud Service Management.

Los valores se asignan mediante la ecuación siguiente:

Atributo de Cloud Service Management=Atributo de Active Directory

Se puede realizar la asignación en cualquiera de los formatos siguientes:

• Se puede asignar un valor de AD con el valor correspondiente de Cloud Service Management. Introduzca solo el nombre del atributo de Active Directory junto con el atributo de Cloud Service Management.

Por ejemplo: first_name=givenName

• Se pueden transmitir varios valores de Active Directory para un atributo de Cloud Service Management en el siguiente formato: ${Valor1} ${Valor2}.

Por ejemplo: name=${last_name}, ${first_name}

Los espacios entre los valores o cualquier otro elemento que se coloque fuera de ${} se tratarán como valores estáticos y se incluyen tal cual en la definición del atributo.

• Se puede transferir un valor estático (texto) como asignación de un atributo de Cloud Service Management. Si todo el valor situado en el lado derecho es estático, enciérrelo entre comillas dobles.

Por ejemplo: title="ejemplo de cadena estática"

• También se puede transferir una combinación de atributos de Active Directory y valores estáticos para un atributo de Cloud Service Management. Siga estas reglas estrictamente:

  • Cuando se utiliza una combinación de atributos de Active Directory y de valores estáticos, se debe verificar que el atributo de Active Directory se encierra entre ${}.

Por ejemplo: job_title = Sr. ${title}

Este es un ejemplo de un valor estático “Sr.” cuyo valor de Active Directory es el título.

• • No utilice comillas dobles para representar un valor estático mientras se transfiere una combinación de atributos de Active Directory y valores estáticos. En este caso, lo que no se encierre entre ${} se considerará como una cadena estática de forma predeterminada. Si se utilizan comillas dobles, estas formarán parte de un valor estático.

Por ejemplo: job_title=“Sr.” ${title}

Aquí, todo el texto de la cadena “Sr.”, incluyendo las comillas, se considerará como una cadena estática.

• • No encierre entre comillas dobles todos los valores situados en el lado derecho mientras se transfiere una combinación de atributos de Active Directory y valores estáticos. En este caso, ADSync ignora el valor de Active Directory y lo considera parte de la cadena de texto estático.

Por ejemplo: nombre = "este es un ejemplo de un valor estático que incluye el atributo de Active Directory ${department}"

En este ejemplo, ${department} no se considerará como una variable, ya que está incluido dentro de las comillas. En su lugar, ${department} también se trata como texto.

Si una cuenta de usuario no tiene ningún valor correspondiente al atributo de Active Directory que ha especificado el usuario, solo se transmitirán para dicha cuenta los valores estáticos. Esta regla no se aplica al atributo org_name. Consulte Configuración del atributo org_name para obtener más información sobre el atributo org_name.

Compruebe la descripción de cada atributo en la lista de atributos para ver las excepciones.

Consideraciones importantes:

• Si se cambia la asignación de un atributo tras ejecutar la utilidad ADSync, los nuevos valores sobrescribirán a los existentes en Cloud Service Management la próxima vez que se ejecute dicha utilidad. Asimismo, si se suprime el valor asignado, se suprimirá el mismo de Cloud Service Management tras ejecutar la utilidad de nuevo.
• El atributo time_zone ya no está disponible. La versión actual de la aplicación actualiza automáticamente la zona horaria del usuario conectado en función de sus valores del sistema. Por lo tanto, la configuración manual ya no es necesaria.
• No se puede asignar un atributo de AD a más de dos atributos en Cloud Service Management. Al asignar un atributo por segunda vez, asegúrese de que se introduzca en el formato ${atributo}.
  Por ejemplo: Se desea asignar el atributo de correo en LDAP a los atributos e_mail y user_login en Cloud Service Management.

Defina los atributos del siguiente modo:
e_mail=mail
user_login=${mail}

Lista de atributos de Microsoft Active Directory:

Lista de atributos para Novell eDirectory.:

• #Nimsoft Service Desk Field = Directory Service Field Name
• first_name=givenName
• last_name=sn
• job_title=title
• e_mail=mail
• user_login=uid
• manager=manager
• org_name=${company} >> ${physicalDeliveryOfficeName} >> ${ou}
  Consulte Configuración del atributo org_name para obtener más información sobre el atributo org_name.
• lvl1_name=company
• lvl2_name=physicalDeliveryOfficeName
• lvl3_name=ou
  Nota: Utilice siempre el atributo org_name en lugar de lvl1_name, lvl2_name y lvl3_name. Si está utilizando el atributo org_name, no hay ninguna necesidad de definir lvl1_name, lvl2_name y lvl3_name. Estos niveles solo se proporcionan para la compatibilidad con las versiones anteriores de la aplicación.
• phone1=telephoneNumber
• phone2=mobile

logger.properties

Este archivo proporciona la capacidad de configurar los niveles de registro y los archivos de salida para el proceso de sincronización de Active Directory. Los pares nombre-valor que deben configurarse para el registro son los siguientes:

sync.properties

Este archivo es el centro de la configuración principal para la sincronización de datos. Los pares nombre-valor disponibles para la configuración son los siguientes:

Durante la resolución de problemas, el equipo de soporte le solicitará que valide los valores establecidos en el archivo sync.properties.

• Token de autorización = authtoken para el motor de integración de usuarios en un segmento de cliente.
• Token del segmento = slicetoken para el intervalo en el proceso de sincronización en el que se escribe.
• URL de acción = la URL a la instancia correcta a la que el cliente desea enviar el resultado de la sincronización.

Configuración del atributo org_name

El atributo org_name representa la jerarquía de la organización. Este atributo está configurado en el archivo attribute_map.list. El valor especificado muestra todos los niveles de la jerarquía organizativa.

Se puede definir un atributo org_name mediante atributos de Active Directory (AD), valores estáticos o una combinación de ambos.

Se deben seguir las reglas que aparecen a continuación al configurar el atributo org_name:

• Si se utiliza un atributo de Active Directory para representar un nivel, el atributo se debe encerrar entre ${ }. Por ejemplo: ${department}.
  Este formato no es necesario para los valores estáticos. Por ejemplo: Recursos Humanos.
• Los niveles deben separarse por medio de la cadena "espacio sencillo>>espacio sencillo". Por ejemplo: ${nombre_compañía} >> ${departamento} o ${nombre_compañía} >> Recursos Humanos.
  No debe utilizarse ningún otro carácter para separar los niveles.
• No hay ningún límite en el número de niveles para el atributo org_name.
• Si se utilizan atributos de Active Directory en el atributo org_name, cada usuario debe estar asignado al menos a uno de los atributos de Active Directory del atributo org_name. Si un usuario no está asignado a ninguno de los atributos de AD de org_name, ese usuario no se asigna a ninguna organización.
• No deben agregarse espacios ni cualquier otro carácter al principio o al final de la definición del atributo org_name.
• No se deben utilizar comillas dobles para representar los valores estáticos en la jerarquía de org_name. Sin embargo, es necesario utilizar las comillas dobles cuando la definición completa de org_name es un valor estático.

Ejemplo:

Caso 1: org_name incluye solamente atributos de Active Directory:

org_name=${company} >> ${physicalDeliveryOfficeName} >> ${department} >> ${additional level} >> ${additional level}

Caso 2: org_name es una combinación de atributos de Active Directory y de valores estáticos:

org_name = Empresa XYZ >> EE. UU. >> ${estado} >> ${condado} >> ${pueblo} >> Recursos Humanos

En este ejemplo:

• • Empresa XYZ, EE. UU. y Recursos Humanos son valores estáticos.
  • ${estado}, ${condado} y ${pueblo} son atributos de Active Directory.

Se pueden agregar tantos niveles como sea necesario como valores estáticos en org_name.

Caso 3: org_name es solamente una cadena estática:

org_name="Empresa XYZ >> EE. UU. >> Nueva York >> Recursos Humanos"

Asegúrese de que en este caso se incluye el valor de la derecha entre comillas dobles.

Activación del entorno SSL para la utilidad ADSync

Para activar el entorno SSL para la utilidad ADSync, realice los pasos siguientes:

1. Haga clic en Ver información del sitio (el icono de bloqueo) situado junto a la dirección URL de Cloud Service Management en la barra de direcciones del explorador.
2. Vaya a Certificado, Detalles y haga clic en Copiar en archivo.
3. Haga clic en Siguiente y establezca el formato que desea utilizar como .DER binario codificado X.509 (.CER).
4. Haga clic en Siguiente, introduzca el nombre del archivo y guarde el archivo.
5. Haga clic en Siguiente, verifique la ruta y haga clic en Finalizar.
6. Copie el archivo de certificado guardado en la ubicación raíz de ADSync (ad-usuario-sync\).
7. Ejecute el comando keytool desde la ubicación raíz de ADSync (ad-usuario-sync\).

8. Importe el certificado guardado al almacén de claves local de ADSync si mediante la ejecución del comando siguiente desde la raíz de ADSync:
   keytool -import -trustcacerts -alias nombre_alias -keystore si -file nombre_archivo_certificado_guardado
   Nota: Para ejecutar el comando keytool desde la raíz de ADSync, se debe disponer de jre/bin en la variable de entorno PATH.
   Sustituya nombre_alias por el alias que desee. Por ejemplo, cacloudsmcert.
   Sustituya nombre_archivo_certificado_guardado por el nombre del archivo de certificado guardado. Por ejemplo, cacloudsmcert.cer.
   Utilice itmaas cuando se le pida la contraseña. La línea de comandos le pedirá que confirme si se puede confiar en el certificado. Escriba y.
   Se muestra un mensaje en el que se indica que se ha agregado el certificado al almacén de claves.

Prueba de la utilidad

Se puede ejecutar la utilidad ADSync sin enviar los datos a la base de datos de Cloud Service Management. Para evitar que los datos se envíen a la base de datos, se debe establecer el valor No para el atributo send.data del archivo sync.properties. Los datos de salida se muestran en el archivo sync_data.log.0. Los datos también se agregan al archivo DATA.csv. Se pueden revisar estos archivos para comprobar si se está ejecutando la utilidad según lo previsto.

Una vez que finaliza la prueba, se debe restablecer el valor Yes para el atributo send.data.

Se puede realizar la prueba para que se ejecute en los intentos de sincronización iniciales para asegurarse de que la utilidad está correctamente configurada.

También se puede utilizar el atributo send.data para probar las modificaciones en los valores de parámetro. Cuando se modifica un valor de parámetro, realice una sincronización de prueba. Actualice la base de datos de Cloud Service Management solo cuando la ejecución de prueba sea correcta.

Creación de un planificador de tareas

Se puede crear un planificador de tareas para ejecutar la sincronización con regularidad. Por ejemplo, si dispone de un entorno UNIX, se creará una tarea cron para ejecutar la utilidad. El planificador de tareas ejecuta uno de los archivos de script proporcionados para ejecutar la utilidad ADSync. Los archivos de script son:

• sync.bat (Windows)
• sync.sh (UNIX)

Estos scripts se incluyen en el archivo zip y se utilizan tal cual; no es necesario editarlos. Los archivos se encuentran en la carpeta script de la utilidad ADSync.

Configure el planificador de tareas para que llame al archivo de script adecuado en el intervalo deseado. Asegúrese de que se conceden derechos de acceso suficientes para ejecutar el archivo de script. Ahora está listo para ejecutar la utilidad ADSync.

Actualización de la utilidad

La utilidad ADSync se actualiza de vez en cuando. Se puede actualizar a una versión más reciente cuando esta esté disponible. Para evitar la pérdida de datos, siga las instrucciones que se proporcionan en este tema.

Al actualizar a la nueva versión, verifique que la configuración de la utilidad no se haya modificado desde la instalación existente. Se debe asegurar de que la configuración de la utilidad no se haya cambiado desde la instalación existente y de que la última copia de seguridad esté disponible en la utilidad actualizada.

Siga los pasos siguientes:

1. Descargue y descomprima la nueva versión de la utilidad.
2. Copie todos los archivos de propiedades modificados de la carpeta ADSync a la misma ubicación en la nueva carpeta ADSync.
3. Vuelva a agregar los nuevos parámetros que se introducen en la actualización.
4. Copie todo el contenido de la carpeta backup, excepto la carpeta dtd, de la carpeta ADSync existente a la nueva carpeta.