Gestión de la herramienta AD Sync

La herramienta de sincronización con AD es una herramienta de línea de comandos que puede ejecutar en un sistema Windows, Linux o macOS para sincronizar usuarios y grupos entre su Active Directory (AD) o servidor LDAP y su cuenta de Zoom. Con esta herramienta, podrá gestionar automáticamente los usuarios y grupos de su cuenta Zoom cuando se produzca un cambio en su sistema LDAP/AD para dichos usuarios y grupos.

La herramienta se ejecuta en la consola y no incluye una interfaz gráfica de usuario ni una interfaz web. Los ajustes se configuran mediante un archivo de propiedades, y puede consultar los archivos de registro para ver los detalles de los cambios o para solucionar cualquier error.

Basándose en los cambios en su servidor LDAP/AD, la herramienta de sincronización AD le permite crear, actualizar y desactivar/eliminar usuarios, actualizar el correo electrónico del usuario Zoom (el dominio del nuevo correo electrónico debe estar en el dominio asociado) y dar de baja a los usuarios cuando su contraseña haya sido cambiada, eliminada o desactivada. Esta herramienta también le permite crear, actualizar y eliminar grupos de Zoom, así como añadir o eliminar miembros del grupo.

La herramienta de sincronización AD admite los siguientes atributos.

Usuario:

Grupo:

icono de nota
Si está sincronizando ADFS con Entra ID, le recomendamos que utilice nuestra integración Entra ID para una experiencia administrativa mejorada.

Requisitos de la herramienta AD Sync

Índice

Cómo crear una aplicación OAuth de servidor a servidor para la herramienta de sincronización de AD

Verificar los permisos para editar usuarios

Para crear esta aplicación, el usuario debe tener permisos de Usuario:Editar.

  1. Inicie sesión en el portal web de Zoom como administrador o usuario con permisos de edición de gestión de roles.
  2. En el menú de navegación, haga clic en Gestión de usuarios y luego en Roles.
  3. En la pestaña Todos, haga clic en el nombre del tipo de rol que desee comprobar, como Admin.
  4. En Gestión de usuarios y permisos, verifique que este rol tiene permisos de Edición para Usuarios.

Más información sobre la gestión de roles.

Crear la aplicación

Debe crear una aplicación OAuth de servidor a servidor para la herramienta en Zoom App Marketplace. Sólo los usuarios con permisos Usuario:Editar pueden completar esta tarea.

  1. Inicie sesión en Zoom App Marketplace.
  2. En la esquina superior derecha, haga clic en Desarrollar y, a continuación, en Crear aplicación de servidor a servidor.
  3. Introduzca un nombre para su aplicación y haga clic en Crear.
  4. En la pestaña Credenciales de la aplicación, vea su ID de cuenta, ID de cliente y secreto de cliente. Utilizará estas credenciales para autenticarse con Zoom.
  5. En la pestaña Información, añada datos sobre su aplicación, como una breve descripción, el nombre de la empresa y la información de contacto del desarrollador (nombre y dirección de correo electrónico necesarios para la activación).
  6. En la pestaña Ámbitos, haga clic en Añadir ámbitos y añada los siguientes ámbitos:
    1. Haga clic en Usuario y, a continuación, en Ver información de usuarios y gestionar usuarios y seleccione el ámbito Eliminar el token de un usuario.
    2. Haga clic en SCIM2, luego en Llamar a la API SCIM2 y seleccione el ámbito Llamar a la API SCIM2.
    3. Pulse Hecho.
    4. Pulse Continuar.
  7. En la pestaña Activación, active su aplicación.

Inicio rápido de la herramienta AD Sync

  1. Instale el JDK versión 17 o superior y ejecute el siguiente comando para asegurarse de que java está instalado correctamente:
    java -version
  2. Obtenga el archivo zoomadsynctool.zip de la siguiente ubicación: https://cdn.zoom.us/prod/tools/zoomadsynctool.zip
  3. Descomprima el archivo zoomadsynctool.zip.
  4. Haga una copia de seguridad y actualice el config.properties como se describe en la sección Configuración.
  5. Prepare un código secreto para proteger la información sensible de los archivos de configuración de la herramienta. El código secreto es necesario cada vez que ejecute la herramienta.
  6. Complete la configuración de inicialización de la herramienta ejecutando el siguiente comando:
    bin/adtool.cmd setup
  7. Valide la exactitud del archivo config.properties y los resultados de la sincronización ejecutando el siguiente comando:
    bin/adtool.cmd vista previa
  8. Modifique el config.properties y sus usuarios/grupos LDAP/AD, ejecute de nuevo el comando de vista previa para verificar si los resultados cumplen sus expectativas.
  9. Cuando la configuración sea correcta y el comando de previsualización dé los resultados esperados, inicie la operación de sincronización ejecutando el siguiente comando:
    bin/adtool.cmd sync
    Precaución: La ejecución del comando sync o start puede eliminar o desactivar usuarios existentes de su cuenta Zoom si dichos usuarios no existen en Active Directory. Consulte la configuración de la cuenta de Zoom:
    zoom.allow.delete.missing.user
    Nota: Si hay una gran cantidad de datos que sincronizar, este comando tardará algún tiempo en ejecutarse. Por favor, absténgase de realizar cualquier operación adicional durante su ejecución.
  10. (Opcional) Supervise y sincronice continuamente cualquier cambio en su sistema LDAP/AD ejecutando el siguiente comando:
    bin/adtool.cmd start
    Nota: Inicie la Herramienta de Sincronización AD como un servicio daemon. Continuará ejecutando la sincronización incremental cada 40 minutos. También supervisará los eventos de cambio de contraseña.
  11. Compruebe el archivo de registro si no consigue ejecutar algún comando.

Cómo configurar la Herramienta de Sincronización AD

El archivo config.properties incluye un conjunto de parámetros que determinan cómo realizará la herramienta la sincronización. Puede realizar dos tipos de sincronizaciones:

Debe actualizar los valores de las siguientes secciones del archivo.

Nota: Las credenciales no deben añadirse en este archivo.

Ajuste del zoom (se requieren valores actualizados)

Opciones de sincronización (se requieren valores actualizados)

Ajustes LDAP/AD (se requieren valores actualizados)

Esta herramienta admite múltiples conexiones a servidores LDAP/AD. El valor "n" identifica el índice del servidor LDAP. El valor de n parte de 0.

Asignación de atributos (valores actualizados opcionales)

Notas:

Configuración de registro

Comandos de sincronización

configuración

Configure las credenciales para la autenticación Zoom y la autenticación LDAP. Si desea cambiar algunas
credenciales, puede ejecutar el comando de configuración para actualizar. Al ejecutar este comando, se le
pedirá que introduzca el ID de cuenta de Zoom, el ID de cliente y el secreto de cliente, el nombre de usuario y la contraseña de AD.

Flujo de instalación:

  1. Introduzca el código secreto.
  2. Confirme el código secreto.
  3. Introduzca el ID de la cuenta de Zoom (copiado de la aplicación OAuth de servidor a servidor).
  4. Introduzca el ID de cliente de Zoom (copia de la aplicación OAuth de servidor a servidor).
  5. Introduzca el secreto de cliente de Zoom (Copiar de la aplicación OAuth de servidor a servidor).
  6. Introduzca el DN de usuario (distinguishedName) del servidor LDAP.
  7. Introduzca la contraseña de usuario del servidor LDAP.
    Nota: El código secreto, el secreto del cliente y la contraseña no son visibles cuando se editan.

inicie

Inicie la Herramienta de Sincronización de AD como un servicio. Ejecutará una sincronización completa por primera vez e iniciará un trabajo para ejecutar una sincronización incremental cada 40 minutos hasta que apague la herramienta. Además, la herramienta supervisará el evento de cambio de contraseña. Utilizando este comando, no tiene que crear Programador de Tareas o CRON en el sistema.

previsualizar

Previsualice el resultado de la sincronización sin realizar cambios en su cuenta de Zoom. Esto es útil si desea asegurarse de que las opciones de la herramienta funcionan como se espera.

reiniciar

Restablezca los ajustes de esta herramienta. Limpiará toda la configuración local y los datos almacenados en caché de la herramienta. Si no consigue ejecutar esta herramienta por cualquier motivo, puede ejecutar el comando de reinicio para que vuelva a funcionar.

sincronice

Ejecute una sincronización completa o incremental desde LDAP a Zoom. Recomendamos ejecutar la vista previa para comprobar el resultado antes de ejecutar una sincronización completa. Si alguna vez se ha ejecutado una sincronización completa, ejecutará una sincronización incremental. Si desea ejecutar una sincronización completa, añada "--all" a la orden de sincronización.

monitor

Supervise el evento de cambio de contraseña del usuario y fuerce la desconexión del usuario Zoom de todos los dispositivos cuando cambie la contraseña en LDAP/AD. Esta herramienta supervisa el caso de que la contraseña del usuario LDAP/AD haya sido modificada, y no puede obtener las contraseñas de los usuarios LDAP/AD.

prueba

Compruebe si la configuración funciona. Utilizará la credencial para probar la conexión y la autenticación para el servidor LDAP/AD y Zoom.

Ejemplos de ejecuciones de comandos para la herramienta de sincronización de AD

El patrón de script de ejecución común es: bin/{archivo de script} {comando}.

Ejemplos de ayuda/información sobre la versión de la herramienta

Mostrar información de ayuda de la herramienta:

bin/{archivo de script} -h
bin/{archivo de script} --help

Muestra información sobre la versión de la herramienta:

bin/{archivo de script} -v
bin/{archivo de script} --version

Muestra información de ayuda del comando setup:

bin/{archivo de script} setup -h
bin/{archivo de script} setup --help

Ejemplos para configurar la herramienta

Configure la herramienta en el modo por defecto:

bin/{archivo de script} configuración

Ponga la herramienta en el modo de servicio:

bin/{archivo de script} setup --service

Reinicie la herramienta:

bin/{archivo de script} reset

Ejemplos para ejecutar la herramienta

Ejecute la herramienta en el modo por defecto:

bin/{archivo de script} iniciar
bin/{archivo de script} sincronizar
bin/{archivo de script} previsualizar
bin/{script file} monitorizar
bin/{archivo de script} prueba

Ejecute la herramienta en modo de servicio:

bin/{archivo de script} {command} --service

Cómo ejecutar la herramienta como un servicio (Windows)

Requisito previo:

Ejecute el siguiente comando para establecer el modo de servicio(Nota: Si ejecuta "bin/adtool.cmd setup" eliminará el modo de servicio):

bin/adtool.cmd setup --service

Cómo iniciarse automáticamente tras el arranque del sistema (Windows)

  1. En el menú Inicio, vaya a Herramientas administrativas de Windows y, a continuación, haga clic en Programador de tareas.
  2. En el menú Acción, haga clic en Crear tarea.
  3. En la pestaña General, haga lo siguiente:
    1. Introduzca un nombre para la tarea, por ejemplo "ADSyncToolTask".
    2. En Opciones de seguridad, seleccione la opción Ejecutar tanto si el usuario ha iniciado sesión como si no y la casilla Ejecutar con los privilegios más altos.
  4. Pulse la pestaña Disparadores y haga lo siguiente:
    1. Pulse Nuevo.
    2. En el desplegable Comenzar la tarea, seleccione Al inicio.
    3. Pulse OK.
  5. Pulse la pestaña Acciones y haga lo siguiente:
    1. Pulse Nuevo.
    2. En el desplegable Acción, seleccione Iniciar un programa.
    3. Haga clic en Examinar, elija el archivo start.bat en el directorio bin y haga clic en Abrir.
    4. Pulse OK.
  6. Pulse la pestaña Condiciones y haga lo siguiente:
    1. En Alimentación, desactive la casilla situada junto a Iniciar la tarea sólo si el ordenador está conectado a la corriente alterna.
    2. Pulse OK.
  7. Pulse la pestaña Configuración y haga lo siguiente:
    1. Deje seleccionada la casilla Permitir que la tarea se ejecute bajo demanda y desactive el resto de casillas.
    2. Pulse OK.
      La herramienta se iniciará automáticamente tras el siguiente reinicio del sistema.

Archivos de registro de la Herramienta de sincronización de AD

Utilice los archivos de registro para ver los detalles de los registros que se sincronizaron y para ayudar a depurar cualquier fallo de sincronización. Cada día se genera un máximo de un archivo de registro de cada tipo. Si ejecuta la herramienta Zoom AD Sync varias veces en el mismo día, la información de esa ejecución se anexa al archivo que se generó previamente para ese día.

Archivos de datos anómalos

Utilice el archivo de datos anómalos para ver los detalles sobre los datos anómalos de usuarios/grupos durante la sincronización completa.

Seguridad de la herramienta AD Sync

Activación de la conexión SSL/TLS para ADFS

Si está utilizando LDAPS a través del puerto 636 para conectarse a un servidor de Active Directory utilizando SSL, el certificado SSL debe ser recuperado e instalado, o puede recibir los siguientes errores:

"El servidor requiere que se active la comprobación de integridad si SSL\TLS no está ya activo en la conexión..."

o

"sun.security.provider.certpath.SunCertPathBuilderException: no se ha podido encontrar una ruta de certificación válida para el destino solicitado."

Recuperación e instalación del certificado SSL

Para importar el certificado SSL y conectar la herramienta AD Sync a través de TLS:

  1. Abra el Administrador de servidores de gestión de Windows.
  2. En Herramientas, abra la Autoridad de Certificación.
  3. En Certificaciones emitidas, haga clic con el botón derecho en el certificado deseado.
  4. Haga clic en Propiedades.
  5. Haga clic en la pestaña Detalles .
  6. Haga clic en Copiar a archivo y elija la codificación Base-64 x.509 (.cer) para exportar.
  7. Haga clic en Siguiente para exportar el certificado.
  8. Copie la certificación exportada en el almacenamiento local de su dispositivo (ej. D:\ca.cert).
  9. Abra la consola de comandos y ejecute el siguiente comando de cambio de directorio para acceder a la ubicación de la papelera Java JDK: 
    cd C:\Archivos de programa\Java\jdk-17\bin
    Nota: Es posible que esta carpeta no se encuentre en la ruta exacta indicada anteriormente, por lo que será necesario modificar el comando si la ruta real de la carpeta es diferente.
  10. Ejecute el siguiente comando para copiar el certificado en la nueva ubicación:
    keytool.exe -importcert -keystore ..\jre\lib\security\cacerts -storepass changeit -file D:\ca.cer -alias myca
    Nota: La estructura de comandos se basa en lo siguiente:
  11. Una vez completado, el certificado será importado e instalado. Actualice la URL LDAP/AD a ldaps://[dirección]:636.