Descripción general de la sincronización de directorios

La sincronización de directorios garantiza que los usuarios de Webex para Cisco BroadWorks puedan usar el directorio de Webex para llamar a cualquier entidad que llame desde el servidor de BroadWorks. Cuando esta característica está habilitada, el directorio completo de llamadas del servidor de BroadWorks se sincroniza con el directorio de Webex. Los usuarios pueden acceder al directorio desde la aplicación Webex y realizar una llamada a cualquier entidad que llame desde el servidor de BroadWorks.

La sincronización de directorios incluye la sincronización de la información de llamadas de los usuarios y de las listas de teléfonos. Los registros de la lista de teléfonos sincronizadas se escriben en uno de los dos tipos de contactos dentro del directorio de Webex:

  • Contactos de la organización: estos contactos se almacenan en una organización y están disponibles para todos los usuarios de la organización.

  • Contactos del usuario: estos contactos se almacenan frente a un usuario y solo están disponibles para el usuario que es el propietario del contacto.


El aprovisionamiento de Webex para Cisco BroadWorks incluye una sincronización predeterminada de usuarios de mensajería y su información de llamadas asociada desde el servidor de BroadWorks al directorio de Webex. Sin embargo, la sincronización de aprovisionamiento predeterminada omite a los usuarios no de mensajería y las entidades que no son usuarios (por ejemplo: un teléfono sala de conferencia, una máquina de fax o grupo de búsqueda usuario). Activar la sincronización de directorios garantiza que todas las entidades que llaman se agregan al directorio de Webex.

Condiciones de sincronización de directorios

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

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

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

  • Si se produce una falla de sincronización, se vuelve a completar la sincronización automáticamente cada 24 horas hasta la próxima sincronización planificada.

  • La sincronización ignora a los usuarios que no tienen un número de teléfono.

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

  • Los contactos del usuario se almacenan en un formato cifrado, solo el usuario que es el propietario del contacto y tiene acceso a la clave de descifrado.

  • Esta característica sincroniza los siguientes tipos de lista de teléfonos desde el servidor de BroadWorks:

    • Listas de teléfonos comunes empresariales

    • Listas de teléfonos comunes grupales

    • Listas de teléfonos personales

Sincronización de directorios y máximos de contactos

A continuación, se muestra la cantidad máxima de contactos que permite la sincronización de directorios para cada tipo de contacto de Webex:

  • 500 contactos de la organización

  • 500 contactos de usuario: para un usuario, la cantidad máxima incluye los contactos de usuarios sincronizados y los contactos manuales (contactos que el usuario agrega manualmente a través de la aplicación de Webex)

Se aplican las siguientes condiciones:

  • Si una organización tiene más de 500 contactos en cualquiera de las categorías, la sincronización excluye las entradas que supera el umbral de 500 límite. No hay ningún orden en particular aplicado a contactos sincronizados o omitidos.

  • Si un usuario agrega contactos manualmente en la aplicación Webex, el máximo de contactos del usuario se determina substracción de los contactos manuales de los contactos de usuarios sincronizados. Por ejemplo: si un usuario agrega 100 contactos manualmente en la aplicación Webex, la sincronización de directorios permite sincronizar hasta 400 contactos de usuarios desde BroadWorks para ese usuario.

  • Le recomendamos que si una de sus organizaciones de clientes tiene más de 500 contactos en cualquiera de las categorías, presente un caso a Cisco para que esa organización sea excluida de la sincronización de directorios.

La siguiente tabla asigna los tipos de contactos de Webex a la lista de teléfonos de BroadWorks desde la cual se sincronizan los registros:

Tabla 1. Tipos de contactos de la sincronización de directorios y fuente de la sincronización

Tipo de contacto de Webex

Sincronizado desde BroadWorks...

API utilizada para la sincronización

Contactos de la organización

Listas de teléfonos comunes empresariales

/directories/enterprisecommon

Listas de teléfonos comunes grupales (mientras está Proveedor de servicios modo de mantenimiento)**

/directories/groupcommon

Contactos del usuario

Listas de teléfonos comunes grupales (mientras está en modo empresarial)**

/directories/groupcommon

Listas de teléfonos personales

/directories/personal


**Las listas de teléfonos comunes grupales se sincronizan de manera diferente, según si BroadWorks está en el modo empresarial o en Proveedor de servicios móvil. El valor de la isBroadWorksEnterprise(verdadero o falso) determina cómo se sincroniza la lista:

  • Verdadero: sincronización como contacto de la organización

  • Falso: sincronización como contacto del usuario

Actualizaciones

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

  • Las actualizaciones de contactos de la organización aparecen en la aplicación de Webex después de que el usuario reinicia la aplicación, o una vez que caduca el temporizador de caché local de 72 horas de la aplicación.

  • Las actualizaciones de contactos del usuario aparecen en la aplicación Webex para ese usuario de inmediato.

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

  • Si el nombre del 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, el contacto existente en el directorio de Webex se actualiza con el número nuevo.

Requisitos previos de la sincronización de directorios

Alternar requisitos

Existen las siguientes alternancias de características para esta característica. Asegúrese de comunicarse con su representante de Cisco BroadWorks de Webex para configurarlo.

Alternancia de características

Aplicado a...

Descripton

webex-for-broadworks-phone-list-sync

Socio

Alternancia obligatoria. Habilita la sincronización de listas de teléfonos para todas las organizaciones de clientes en este socio.

Debe estar habilitado.

webex-for-broadworks-phone-list-sync-disable

Organización del cliente

Alternancia opcional. Deshabilita la sincronización de la lista de teléfonos para una organización determinada, incluso si la característica está habilitada a nivel del socio y en la plantilla del cliente.

Aplique esta alternancia solo si quiere deshabilitar la sincronización de listas de teléfonos para una organización específica del cliente. De lo contrario, puede dejarla deshabilitada.


 
Por ejemplo: debe aplicar esta alternancia a cualquier organización que requiera más de 500 contactos.

hidden-personal-contacts-enabled-ga

Usuario

Alternancia opcional. Oculta los contactos personales de las búsquedas de directorio completadas por este usuario.

hidden-org-contacts-enabled-ga

Usuario

Alternancia opcional. Oculta los contactos de la organización de las búsquedas de directorio completadas por este usuario.

Requisitos de configuración previa

Le recomendamos que utilice la siguiente configuración:


En los siguientes ejemplos se asume que está utilizando un servidor XSP. Para los servidores de ADP, reemplace (XSP_CLI) por (ADP_CLI).
  • Velocidad de límite de valores: configure las siguientes propiedades del sistema OverloadControl_(CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectorioTransactionLimit: dedúzcalo en un valor nulo.

    • globalDirectorioTransactionLimit: dedúzcalo en un valor nulo.


    Se recomienda configurar userDirectoryTransactionLimit y globalDirectactionLimit en un valor nulo. Sin embargo, si decide asignar valores, cada uno debe establecerse en al menos cinco veces el valor de transactionLimitPeriodOpciones (que debe ser 1).
  • Límites de transacción: configure los siguientes valores_(CLI/System/CommunicationUtility/DefaultSettings de XSP):

    • userTransactionLimit: de configure como mínimo 100.

    • transactionLimitPeriodSecs: definido en 1.

  • Valores de paginación: defina las propiedades del sistema de paginación_(CLI/Aplicaciones de XSP/Xsi-Acciones/Paginación):

    • defaultPageSize: se establece en 50

    • availableUserMaxLimit: de configuración en 100

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

Además, según su versión de BroadWorks, le recomendamos que aplique las siguientes revisiones del sistema a la implementación de BroadWorks antes de habilitar esta característica:


Para ver la lista completa de requisitos de revisiones que forman el requisito mínimo de Webex para Cisco BroadWorks, consulte Requisitos del software de BroadWorks en la Guía de soluciones de Webex para Cisco BroadWorks.

Habilitar sincronización de directorios (nueva plantilla)

Los administradores de socios pueden habilitar la sincronización de directorios para una plantilla de cliente mientras crean la nueva plantilla. Todas las organizaciones del cliente nuevas que se asignen a esa plantilla tendrán habilitada la sincronización de directorios. Para obtener detalles, consulte "Configurar sus plantillas de cliente" en Configurar la organización de socio en el concentrador del socio en la Guía de soluciones de Webex para CiscoBroadWorks.

Qué hacer a continuación

Asegúrese de que sus usuarios sepan que deben hacer clic en la ficha Contactos en la aplicación de Webex al menos una vez a fin de activar la característica en la aplicación de Webex. Esto solo debe completarse una vez.

Habilitar 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 característica para las organizaciones del cliente que utilizan la plantilla.

1

Inicie sesión en el Partner Hub y elija Configuración.

2

Desplácese hasta Llamadas de BroadWorks y haga clic en Ver plantillas .

3

Seleccione la plantilla del 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 estructuraciones de clientes que utilizan esta plantilla:

  1. Defina habilitar la sincronización de directorios y listas de teléfonos de BroadWorks para todas las organizaciones nuevas de clientes en En .

  2. Haga clic en Guardar.

5

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

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

  2. Marque las casillas de verificación adyacentes para cada organización para la que quiera activar la característica.

  3. Haga clic en Habilitar sincronización.


 

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

  • En el paso 4a, defina la opción Habilitar la sincronización de directorios telefónicos para todas las nuevas organizaciones de clientes y desactive la opción Desactivar para deshabilitar la sincronización de directorios de manera predeterminada para las nuevas organizaciones de clientes que usen esta plantilla.

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

Qué hacer a continuación

Asegúrese de que sus usuarios sepan que deben hacer clic en la ficha Contactos en la aplicación de Webex al menos una vez a fin de activar la característica en la aplicación de Webex. Esto solo debe completarse una vez.

Completar sincronización inmediata

La opción Sincronizar ahora permite al administrador de socios completar una sincronización bajo demanda para una organización determinada del cliente. Esta opción solo se puede seleccionar para organizaciones de clientes individuales; no hay una opción masiva para Sincronizar ahora.

1

Inicie sesión en el Partner Hub (http://admin.webex.com) y elija Configuración.

2

Desplácese hasta Llamadas de BroadWorks y haga clic en Ver plantillas .

3

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

4

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

5

Para la organización del cliente que desea sincronizar, haga clic en los tres puntos en la parte derecha más alejada y seleccione Sincronizarahora.

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

Inicie sesión en el Partner Hub (http://admin.webex.com) y elija Configuración.

2

Desplácese hasta Llamadas de BroadWorks y haga clic en Ver plantillas .

3

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

4

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

5

Marque las casillas de verificación adyacentes para cada organización que desea 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 la sincronización de directorios para las organizaciones de clientes que administran, 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 BroadWorks Enterprises. Hay cuatro API:

  • Enumerar empresas de BroadWorks: utilice este método de API para obtener una lista de empresas en un sitio Proveedor de servicios empresa ylas de cada empresa. id. Debe introducir el spEnterpriseId como se asignó en el aprovisionamiento.

  • Actualizar la sincronización de directorios para una empresa deBroadWorks: introduzca la empresa id para actualizar el estado sic del directorio para esa empresa, habilitar o deshabilitar la sincronización de directorios.

  • Activar la sincronización de directorios para una empresa: utilice este método de API si quiere activar unasincronización inmediata para una empresa determinada id. Para la syncStatus, introduzca el SYNC_NOW Comando.

  • Obtener el estado de sincronización de directorios para unaempresa: introduzca la empresa id y ejecutar para obtener un estado y trackingId de la última sincronización. Puede usar el trackingID para ejecutar análisis adicional a través de herramientas como Kibana y Grafana.

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

Necesita iniciar sesión para leer la especificación API en https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Sincronizar varias empresas con API

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

  • La sincronización de directorios le permite sincronizar solo una empresa a la vez. Si intenta sincronizar más de una empresa, recibirá un error 429.

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

1

Ejecute la API List BroadWorks Enterprises para generar una lista de empresas que desea sincronizar.

  1. Defina startWith en la cadena de inicio del identificador empresarial o del proveedor de servicios.

  2. Haga clic en Ejecutar.

2

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

  1. Introduzca el ID de la empresa.

  2. Configurar syncStatus en SYNC_NOW

  3. Haga clic en Ejecutar.

    Se activa una sincronización inmediata para la empresa. Esta sincronización cuenta con respecto al límite de una sincronización por instancia.
3

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

  1. Introduzca el ID empresarial

  2. Haga clic en Ejecutar.

4

Una vez que finalice la sincronización, complete los pasos del 2 al 4 en la siguiente empresa de la lista. Repita estos pasos hasta sincronizar toda la lista.

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

Los siguientes códigos de error se aplican a la sincronización de directorios.

Código de error

Mensaje de error

600000

Error inesperado de sincronización inesperada de usuarios de directorios externos de Broadworks.

600001

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

600002

La sincronización de usuarios de directorios externos de Broadworks tenía que finalizarse antes de completarse.

600003

La sincronización de usuarios de directorios externos de Broadworks solo se izó parcialmente correctamente. Algunas organizaciones del cliente no se pudieron sincronizar.

600004

La sincronización de usuarios de directorios externos de Broadworks no está habilitada para el Conjunto de configuración.

600005

La sincronización de usuarios externos de Broadworks está en curso para el Conjunto de configuración.

600006

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

600007

No se encuentra la organización de identidad del clienteConfig.

600008

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

600009

No se puede ejecutar la sincronización de usuarios de directorios externos de Broadworks ya que el grupo de Broadworks asociado con CustomerConfig está ocupado

600010

No se puede ejecutar la sincronización de usuarios de directorios externos de Broadworks, 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

No se puede ejecutar la sincronización de usuarios de directorios externos de Broadworks ya 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 de máquinas al almacén de identidades.

600014

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

600015

La sincronización de usuarios externos de Broadworks no encontró ningún usuario que coincida 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 de la empresa/organización.

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.