Descripción general de la sincronización de directorios

La sincronización de directorios garantiza que los usuarios de Webex para Cisco BroadWorks puedan utilizar el directorio de Webex desde la aplicación de Webex para llamar a cualquier entidad que llame desde el servidor de BroadWorks. Esta característica sincroniza la información de llamadas de BroadWorks que no formaba parte del aprovisionamiento de usuarios en el directorio de Webex .

El aprovisionamiento de usuarios de Webex para Cisco BroadWorks actualiza el directorio de Webex con detalles de llamadas para los usuarios de Webex para Cisco BroadWorks (número de teléfono principal , número de número de teléfono móvil, extensión), pero omite los registros de llamadas externas. Sin embargo, cuando la sincronización de directorios está activada, la función también sincroniza los siguientes registros de llamadas con el directorio de Webex .

  • Usuarios que solo llaman de BroadWorks (que no están incorporados a Webex)

  • Entidades que no son de usuario (p. Ej., Un teléfono de sala de conferencias, una máquina de fax, un número de grupo de salto )

  • Entradas de la lista de teléfonos de BroadWorks

La siguiente tabla resume los registros de llamadas de BroadWorks y muestra cómo se agregan al directorio de Webex .

Tabla 1. Actualizaciones de sincronización de directorios en el directorio de Webex

Registros de llamadas de BroadWorks

Descripción

Agregado al directorio de Webex a través de ...

Webex para usuarios de Cisco BroadWorks

Los usuarios están habilitados para Webex para Cisco BroadWorks

Aprovisionamiento de usuarios (p. Ej., Aprovisionamiento continuo)

Usuarios que solo llaman de BroadWorks

Llamar a los usuarios que están no incorporado a Webex

Sincronización de directorios

Entidades que llaman que no son usuarios

Por ejemplo, un teléfono de sala de conferencias, máquina de fax, número de grupo de búsqueda

Sincronización de directorios

Listas telefónicas de BroadWorks

Entradas de la lista de teléfonos de BroadWorks:

  • Listas de teléfonos comunes de la empresa

  • Listas de teléfonos comunes de grupo (grupos de proveedores de servicios o grupos empresariales)

  • Listas de teléfonos personales

Sincronización de directorios (sincronización de la lista de teléfonos)


Para obtener más detalles sobre el aprovisionamiento de usuarios, consulte la Guía de la solución de Webex para Cisco BroadWorks .

Condiciones de sincronización de directorios

  • Los administradores de socios deben habilitar la función a nivel de socio. Los administradores de socios pueden activar o desactivar la función para varias organizaciones de clientes en una sola operación.

  • De forma predeterminada, la sincronización inicial se produce una semana después de la activación de la sincronización (la hora elegida para iniciar la sincronización es aleatoria). Sin embargo, las organizaciones de clientes pueden utilizar la Sincronizar ahora opción para omitir el período de espera de una semana y activar una sincronización inmediata para una organización de cliente determinada.

  • De forma predeterminada, la sincronización de directorios se ejecuta semanalmente para cada cliente. Cada sincronización se produce una semana después de la última sincronización, independientemente de si la última sincronización se programó o se activó manualmente con Sincronizar ahora .

  • La número máximo de sincronizaciones simultáneas por clúster de BroadWorks es dos: una sincronización programada y una sincronización a pedido (a través de API o GUI de Partner Hub). Sin embargo, los administradores no pueden ejecutar dos sincronizaciones bajo demanda al mismo tiempo desde el mismo BroadWorks. Esta restricción existe independientemente de si la sincronización se inició a través de la API o del Sincronizar ahora opción en Partner Hub. Además, Webex no programará dos sincronizaciones programadas para que se ejecuten al mismo tiempo desde el mismo BroadWorks.

  • Si se produce un error de sincronización, Webex vuelve a intentar la sincronización automáticamente cada 24 horas hasta la próxima sincronización programada.

  • La sincronización ignora a los usuarios que no tienen un número telefónico.

  • En Partner Hub, puede ver la información del estado de sincronización de un cliente determinado. Además, puede exportar información detallada sobre la última sincronización a un registro CSV . El registro CSV proporciona más detalles que la pantalla de Control Hub y puede ayudar en la resolución de problemas, el análisis y la auditoría.

  • Webex almacena los contactos de los usuarios en un formato cifrado. Solo el usuario propietario del contacto tiene acceso a la clave de descifrado.

  • Para los usuarios que llaman solo de BroadWorks y las entidades que llaman que no son usuarios, esta función sincroniza los siguientes tipos de número telefónico de BroadWorks:

    • Número de teléfono principal

    • Número de teléfono móvil

    • Extensión

    Sin embargo, la sincronización excluye de la sincronización a los usuarios que llaman solo de BroadWorks y a las entidades que no son usuarios que llaman si no hay un número de teléfono principal ni una extensión.

Lista de teléfonos de BroadWorks y máximos de contactos

La sincronización de directorios también sincroniza las entradas de la lista de teléfonos de Webex con los contactos de Webex. Las entradas sincronizadas se agregan a uno de los siguientes tipos de contacto:

  • Contactos de la organización: Webex almacena estos contactos en una organización. Cada usuario puede acceder a los contactos de la organización de su organización. El máximo es de hasta 30000 contactos.

  • Contactos de usuario: Webex almacena estos contactos frente a un usuario. Solo el usuario propietario del contacto puede acceder a la entrada del contacto. El máximo es de hasta 2000 contactos (1500 contactos sincronizados + 500 contactos de entrada manual).


Solo las entradas de la lista de teléfonos se agregan a los contactos de Webex . Los usuarios que solo llaman de BroadWorks y las entidades de llamada que no son de usuario que se incluyen en la sincronización del directorio no se agregan a los contactos a menos que un usuario de Webex los agregue a los contactos manualmente.

La siguiente tabla asigna los tipos de contacto de Webex a la fuente de contacto (sincronizados desde una lista de teléfonos de BroadWorks o agregados manualmente):

Tabla 2. Origen y valores máximos de sincronización de directorios

Tipo de contacto de Webex

Fuente de contacto

Máximo

Sincronizado desde BroadWorks ...

API utilizada para la sincronización

Contactos de la organización

Sincronización de directorios

30000 contactos

Listas de teléfonos comunes de la empresa

/directories/enterprisecommon

Listas de teléfonos comunes de grupo (para un grupo de proveedores de servicios) **

/directories/groupcommon

Contactos de usuario

Sincronización de directorios

1500 contactos

Listas de teléfonos personales

/directories/personal

Agregado manualmente por el usuario

500 contactos

No disponible

No disponible

Contactos de grupo

Sincronización de directorios

30000 contactos por grupo

Listas de teléfonos comunes de grupo (para un grupo empresarial) **

/directories/groupcommon

** Las entradas de las listas de teléfonos comunes de grupo se sincronizan de manera diferente dependiendo de si BroadWorks está en modo de empresa o en modo de proveedor de servicios. El valor de la isBroadWorksEnterprise El parámetro (verdadero o falso) determina cómo se sincroniza la lista:

  • Verdadero: sincronizar como contacto de grupo

  • Falso: sincronizar como contacto de la organización

Se aplican las siguientes condiciones sobre cómo Directory Sync maneja los máximos de contactos:

  • Si una organización supera el número máximo de contactos permitidos para la sincronización (30000 contactos de la organización o 30000 contactos comunes de grupo por grupo), la sincronización del directorio excluye las entradas que superan el umbral máximo. No se aplica ningún orden en particular a los contactos sincronizados u omitidos.

  • Si uno de sus clientes excede el número máximo permitido de contactos en cualquiera de las categorías, le recomendamos que plantee un caso a Cisco para que esa organización sea excluida de la sincronización de directorios.

  • Los contactos manuales son contactos que un usuario agrega manualmente en la aplicación Webex . Un usuario puede agregar hasta 500 contactos manuales. Los contactos manuales se encuentran dentro de la categoría de contacto de usuario más grande en Webex, pero no se incluyen en la sincronización.

  • El límite total combinado de contactos de la organización (30000) y contactos de grupo (30000 por grupo) es 200000.

Actualizaciones

A continuación, se muestra cómo el directorio de Webex maneja las actualizaciones:

  • Si el nombre de contacto cambia en BroadWorks, el contacto existente se elimina del directorio de Webex y se crea un nuevo contacto.

  • Si el número de contacto cambia en BroadWorks, Webex actualiza el contacto existente en el directorio de Webex con el nuevo número.

Después de que un administrador actualiza un contacto en BroadWorks, se describen las siguientes condiciones cuando la actualización se muestra en la aplicación Webex de un usuario:

  • Si la actualización es para un usuario que llama solo de BroadWorks o una entidad que llama que no es un usuario, la actualización se muestra en la aplicación de Webex de un usuario inmediatamente después de la sincronización del directorio posterior.

  • Si la actualización es para una entrada de la lista de teléfonos de BroadWorks:

    • Para los contactos del usuario: las actualizaciones se muestran en la aplicación Webex del usuario inmediatamente después de la sincronización del directorio posterior.

    • Para contactos de grupo: las actualizaciones se muestran en la aplicación de Webex de los usuarios inmediatamente después de la sincronización del directorio posterior.

    • Para los contactos de la organización: el directorio de Webex se actualiza en la siguiente sincronización del directorio, pero los usuarios no verán el cambio en la aplicación de Webex hasta que reinicien la aplicación de Webex o hasta que caduque el temporizador de caché de 72 horas local.


Las actualizaciones de la información del usuario de Webex para Cisco BroadWorks se gestionan como parte de los procesos de aprovisionamiento.

Control Hub contiene una opción para agregar o editar contactos de nivel de organización en Control Hub a través de un archivo CSV. Los administradores de socios y los administradores de clientes con acceso a Control Hub pueden acceder a esta opción. Sin embargo, la actualización de contactos a través de Control Hub no es compatible con Webex para Cisco BroadWorks. Las actualizaciones de contactos aplicadas en Control Hub no se sincronizan con BroadWorks y no están disponibles para búsquedas de directorio desde teléfonos de escritorio.

Requisitos previos de sincronización de directorios

Le recomendamos que utilice la siguiente configuración:


Los siguientes ejemplos asumen que está utilizando un servidor XSP. Para servidores ADP, reemplace (XSP_ CLI) con (ADP_ CLI).
  • Valores límite de velocidad: establezca las siguientes propiedades del sistema OverloadControl (XSP_ CLI / Aplicaciones / Xsi-Actions / OverloadControl):

    • userDirectoryTransactionLimit: se establece en un valor nulo.

    • globalDirectoryTransactionLimit: se establece en un valor nulo.


    Se recomienda que establezca userDirectoryTransactionLimit y globalDirectoryTransactionLimit en un valor nulo. Sin embargo, si decide asignar valores, cada uno debe establecerse en al menos cinco veces el valor de transactionLimitPeriodSeconds (que debería ser 1).
  • Límites de transacción: establezca los siguientes valores (XSP_ CLI / Sistema / CommunicationUtility / DefaultSettings):

    • userTransactionLimit: establezca al menos 100.

    • transactionLimitPeriodSecs: se establece en 1.

  • Valores de paginación: establezca las propiedades del sistema de paginación (XSP_ CLI / Aplicaciones / Xsi-Actions / Paging):

    • defaultPageSize: establecido en 50

    • availableUserMaxLimit: se establece en 100

  • Interfaz CTI : asegúrese de cargar los certificados de CA de Webex en el almacén de confianza de la interfaz CTI y de habilitar la autenticación del cliente en la interfaz CTI .

Además, según su versión de BroadWorks, le recomendamos que aplique los siguientes parches del sistema a la implementación de BroadWorks antes de habilitar esta función:

Habilitar la sincronización de directorios (nueva plantilla)

Los administradores de socios pueden habilitar Directory Sync para una plantilla de cliente mientras crean la nueva plantilla. Cualquier nueva organización de clientes que se asigne a esa plantilla tendrá habilitada la sincronización de directorios. Para obtener más información, consulte "Configurar sus plantillas de cliente" en Configure su organización asociada en Partner Hub dentro del Guía de soluciones para Webex para Cisco BroadWorks .

Qué hacer a continuación

Asegúrese de que sus usuarios sepan que deben hacer clic en el Contactos pestaña en la aplicación Webex al menos una vez para activar la función en la aplicación Webex . Esto debe completarse una sola vez.

Habilitar la sincronización de directorios (plantilla existente)

Los administradores de socios pueden completar los siguientes pasos para activar la sincronización de directorios dentro de una plantilla de cliente existente a fin de habilitar la función para las organizaciones de clientes que utilizan la plantilla.

1

Inicie sesión en Partner Hub y elija Configuraciones .

2

Desplazarse a BroadWorks Calling y haga clic en Ver plantillas .

3

Seleccione la plantilla de cliente adecuada y desplácese hasta Sincronización de directorios de BroadWorks .

4

Para habilitar la sincronización de directorios de forma predeterminada para las nuevas organizaciones de clientes que utilizan esta plantilla:

  1. Establecer el Habilite la sincronización del directorio y la lista de teléfonos de BroadWorks para todas las organizaciones de clientes nuevas cambiar a En .

  2. Haga clic en Guardar.

5

Para habilitar la sincronización de directorios para las organizaciones de clientes existentes que utilizan esta plantilla:

  1. Haga clic en Mostrar lista de estado de sincronización de clientes .

  2. Marque las casillas de verificación adyacentes para cada organización para la que desee activar la función.

  3. Haga clic en Habilitar sincronización .


 

Si desea deshabilitar la sincronización de directorios, siga el procedimiento anterior y:

  • En el paso 4a, configure el Habilitar la sincronización del directorio telefónico para todas las organizaciones de clientes nuevos cambiar a Apagado para deshabilitar la sincronización de directorios de forma predeterminada para las organizaciones de nuevos clientes que utilizan esta plantilla.

  • En el paso 5c, haga clic en Deshabilitar sincronización para desactivar la función para las organizaciones existentes.

Qué hacer a continuación

Asegúrese de que sus usuarios sepan que deben hacer clic en el Contactos pestaña en la aplicación Webex al menos una vez para activar la función en la aplicación Webex . Esto debe completarse una sola vez.

Activar sincronización inmediata

El Sincronizar ahora La opción permite al administrador del socio activar una sincronización a pedido para una organización de cliente determinada. Esta opción se puede seleccionar solo para organizaciones de clientes individuales; no hay una opción masiva para Sincronizar ahora.

1

Iniciar sesión en Partner Hub (http://admin.webex.com ) y elige Configuraciones .

2

Desplazarse a BroadWorks Calling y haga clic en Ver plantillas .

3

Seleccione la plantilla de cliente adecuada y desplácese hasta Sincronización de directorios de BroadWorks .

4

Haga clic en Mostrar lista de estado de sincronización de clientes .

5

Para la organización del cliente que desea sincronizar, haga clic en los tres puntos en el extremo derecho y seleccione Sincronizar ahora .

6

Haga clic en Actualizar para ver los resultados de la sincronización.

Exportar registros de sincronización a CSV

Los administradores de socios pueden exportar información detallada sobre la última sincronización a un archivo CSV. El CSV contiene una vista más detallada del registro de sincronización que la GUI de Control Hub y puede ayudar en la resolución de problemas y el análisis.

1

Iniciar sesión en Partner Hub (http://admin.webex.com ) y elige Configuraciones .

2

Desplazarse a BroadWorks Calling y haga clic en Ver plantillas .

3

Seleccione la plantilla de cliente adecuada y desplácese hasta Sincronización de directorios de BroadWorks .

4

Haga clic en Mostrar lista de estado de sincronización de clientes .

5

Marque las casillas de verificación adyacentes para cada organización que desee incluir en la exportación.

6

Haga clic en Exportar resultados .

API públicas para la sincronización de directorios

Las API públicas están disponibles en developer.webex.com que permiten a los administradores de socios actualizar la configuración de sincronización de directorios para las organizaciones de clientes que administran, para activar una sincronización inmediata u obtener información sobre el estado de la sincronización. Los métodos de sincronización de directorios se agrupan en Empresas BroadWorks :

  • Lista de empresas de BroadWorks —Utilice este método de API para obtener una lista de empresas de un proveedor de servicios determinado y las id. Debes ingresar al spEnterpriseId según lo asignado en el aprovisionamiento.

  • Actualizar la sincronización de directorios para una empresa de BroadWorks —Entrar en la empresa id para actualizar el estado de sincronización de directorios para esa empresa, habilitando o deshabilitando la sincronización de directorios.

  • Activar la sincronización de directorios para una empresa —Utilice este método de API si desea activar una sincronización inmediata para una empresa determinada id. Para el syncStatus, ingrese el SYNC_NOW comando.

  • Obtener el estado de sincronización de directorios para una empresa —Entrar en la empresa id y ejecutar para obtener un estado y trackingId de la última sincronización. Puede utilizar el trackingID para ejecutar análisis adicionales a través de herramientas como Kibana y Grafana.

Además, los administradores pueden utilizar la Activar la sincronización de directorios para un solo usuario API para desencadenar una sincronización de directorios bajo demanda para un solo usuario.

Para obtener documentación detallada de la API , consultehttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .

Debe iniciar iniciar sesión para leer la especificación de la API enhttps://developer.webex.com/docs/api/v1/broadworks-subscribers .

Sincronizar varias empresas con API

Complete este procedimiento para utilizar las API públicas para activar la sincronización de directorios para varias empresas.

  • La sincronización de directorios le permite sincronizar solo una empresa de un clúster de Broadworks a la vez a través de una sincronización a pedido. Si intenta sincronizar más de una empresa, recibirá un error 429

  • El tiempo que lleva desencadenar una sincronización para una sola empresa varía según el tamaño de la empresa.

1

Ejecute el Lista de empresas de BroadWorks API para generar una lista de empresas que desea sincronizar.

  1. Establecer startWith a la cadena inicial del identificador de empresa o proveedor de servicio .

  2. Haga clic en Ejecutar.

2

Ejecute el Activar la sincronización de directorios para una empresa API en la primera empresa de la lista.

  1. Entrar en la empresa id .

  2. Establecer syncStatus a SYNC_NOW

  3. Haga clic en Ejecutar.

    Se activa una sincronización inmediata para la empresa. Esta sincronización cuenta contra la sincronización única a pedido por límite de Broadworks.
3

Espere unos segundos y luego ejecute el Obtener estado de sincronización de directorios API para obtener el estado de sincronización.

  1. Entrar en la empresa id

  2. Haga clic en Ejecutar.

4

Una vez finalizada la sincronización, complete los pasos 2 a 4 en la siguiente empresa de la lista. Repita estos pasos hasta que haya sincronizado toda la lista.

Códigos de error para la sincronización de directorios

Los siguientes códigos de error se aplican a Directory Sync.

Código de error

Mensaje de error

600000

Error inesperado en la sincronización de usuarios de directorios externos de Broadworks.

600001

La sincronización de usuarios de directorios externos de Broadworks falló.

600002

La sincronización de usuarios de directorios externos de Broadworks tuvo que finalizar antes de que se completara.

600003

La sincronización de usuarios de directorios externos de Broadworks solo tuvo éxito parcial. Algunas organizaciones del cliente no se pudieron sincronizar.

600004

La sincronización de usuarios de directorios externos de Broadworks no está habilitada para ConfigSet.

600005

La sincronización de usuarios de directorios externos de Broadworks está en curso para ConfigSet.

600006

Los hilos de la sincronización de usuarios de directorios externos de Broadworks están ocupados o se están cerrando; por lo tanto, no se aceptarán más solicitudes de sincronización. Vuelva a intentarlo más tarde.

600007

No se encuentra la organización de identidad de CustomerConfig.

600008

CustomerConfig no se encuentra en la organización del socio.

600009

La sincronización de usuarios del directorio externo de Broadworks no se puede ejecutar porque el clúster de broadworks asociado a CustomerConfig está ocupado

600010

La sincronización de usuarios de directorios externos de Broadworks no se puede ejecutar ya que no hay ningún grupo de Broadworks asociado a CustomerConfig.

600011

La sincronización de usuarios de directorios externos de Broadworks no está habilitada para CustomerConfig.

600012

La sincronización de usuarios de directorios externos de Broadworks no se puede ejecutar porque que la sincronización de directorios híbridos ya está habilitada para CustomerConfig.

600013

La sincronización de usuarios de directorios externos de Broadworks no pudo agregar usuarios y cuentas automáticas al almacén de identidades.

600014

La sincronización de usuarios de directorios externos de Broadworks falló al intentar conectarse al grupo de Broadworks. Error de Broadworks:% s.

600015

La sincronización de usuarios de directorios externos de Broadworks no encontró ningún usuario coincidente en el almacén de identidades.

600017

La sincronización de la lista de teléfonos de BroadWorks no pudo sincronizar todos los contactos de usuarios y empresas / organizaciones.

600018

Error en la sincronización de la lista de teléfonos de BroadWorks para los usuarios de la empresa / organización.

600019

La sincronización de la lista de teléfonos de BroadWorks no pudo sincronizar los contactos de la empresa / organización.

600020

La sincronización de usuarios del directorio externo de BroadWorks no se puede deshabilitar ya que la sincronización de CustomerConfig está en curso.

600022

La sincronización de un solo usuario del directorio externo de BroadWorks no es posible ya que la empresa no tiene un usuario aprovisionado.

600023

La sincronización de un solo usuario del directorio externo de BroadWorks no es posible porque el usuario ya existe en esta organización.

600024

La sincronización de un solo usuario del directorio externo de BroadWorks no es posible porque no se encontró ningún usuario coincidente en BroadWorks.

600025

La sincronización de usuarios del directorio externo de BroadWorks no pudo actualizar la cuenta de usuario en CI.

600026

La sincronización de usuarios del directorio externo de BroadWorks no pudo actualizar la cuenta de la máquina en CI.

600027

La sincronización de un solo usuario del directorio externo de BroadWorks no es posible porque se encontraron varios usuarios en BroadWorks.

600028

La sincronización de un solo usuario del directorio externo de BroadWorks no es posible porque se debería haber completado al menos una sincronización del directorio empresarial .

600029

La sincronización de usuarios del directorio externo de BroadWorks falló porque la empresa no tiene ningún usuario aprovisionado.

Historial de cambios

La siguiente tabla resume las actualizaciones de este artículo.

Fecha

Revisión

14 de febrero de 2023

Actualizado Origen y valores máximos de sincronización de directorios sección.

10 de diciembre de 2022

Se actualizó el término Sincronización inmediata completa a Activar sincronización de directorios

19 de julio de 2022

Aclaraciones y correcciones de la información general:

  • Actualizado Descripción general de la sincronización de directorios para aclarar las diferentes sincronizaciones involucradas y cómo se actualiza el directorio de Webex para cada una.

  • Actualizado Lista de teléfonos de BroadWorks y máximos de contactos para aclarar que solo las listas de teléfonos se sincronizan con los contactos.

  • Correcciones a Actualizaciones para aclarar cuánto tiempo tarda la aplicación de Webex en mostrar los registros actualizados.

09 de mayo de 2022

  • En Descripción general de la sincronización de directorios , nota corregida debajo de la Origen y valores máximos de sincronización de directorios mesa. También se actualizó la Nota sobre el aprovisionamiento continuo.

  • Ediciones y correcciones gramaticales

07 de abril de 2022

  • Nota agregada a la Actualizaciones sección en Descripción general de la sincronización de directorios en torno a la limitación de la aplicación de ediciones de contactos a nivel de organización en Control Hub.

28 de marzo de 2022

  • Se volvió a insertar el contenido faltante en Habilitar la sincronización de directorios (nueva plantilla) .

  • Se agregó información sobre los máximos de sincronización. Puede ejecutar una sincronización programada y una sincronización de API simultáneamente desde el mismo clúster.

  • Información agregada sobre Activar la sincronización de directorios para un solo usuario API.

24 de marzo de 2022

Se agregó una lista de tipos de número telefónico sincronizados a Condiciones de sincronización de directorios . La sincronización ahora incluye números de teléfono móvil .

16 de marzo de 2022

  • Se agregaron nuevos códigos de error.

  • Se agregó una declaración de descripción introductoria para una mejor usabilidad de las búsquedas web.

17 de diciembre de 2021

  • Ediciones estructurales menores para solucionar el problema de la falta de TOC.

16 de diciembre de 2021

  • Artículo actualizado con valores máximos aumentados para los contactos de los usuarios.

08 de diciembre de 2021

  • Sección agregada Sincronización de directorios y máximos de contactos para aclarar cómo Directory Sync deriva el número máximo de contactos de organización y usuario.

  • Formato de tabla revisado en Códigos de error para la sincronización de directorios para una mejor legibilidad.