Visão geral da sincronização de diretórios

A sincronização de diretórios garante que os usuários Webex para Cisco BroadWorks possam usar o diretório Webex do aplicativo Webex para chamar qualquer entidade de chamada do servidor BroadWorks. Esse recurso sincroniza informações de chamada BroadWorks que não foram parte do provisionamento de usuários para o diretório Webex.

Webex para o provisionamento de usuários Cisco BroadWorks atualiza o diretório Webex com detalhes de chamadas para Webex para usuários Cisco BroadWorks (número de telefone primário, número de telefone móvel, extensão), mas omiti registros de chamadas externas. No entanto, quando a sincronização do diretório está 1, o recurso também sincroniza os seguintes registros de chamada com o diretório Webex.

  • Usuários de chamada somente BroadWorks (que não estão integrados ao Webex)

  • Entidades de chamadas não-usuário (por exemplo, um telefone sala de conferência, máquina de fax, grupo de busca número)

  • Entradas da Lista de telefones BroadWorks

A tabela a seguir resume os registros de chamada do BroadWorks e mostra como eles são adicionados ao diretório Webex.

Tabela 1. Atualizações de sincronização de diretórios para o Diretório Webex

Registros de chamada broadworks

Descrição

Adicionado ao Diretório Webex via...

Webex para usuários Cisco BroadWorks

Usuários estão habilitados para Webex para Cisco BroadWorks

Provisionamento de usuário (por exemplo, provisionamento fluxoviso)

Usuários de chamada somente BroadWorks

Chamar usuários que não estão integradas ao Webex

Sincronização de diretórios

Entidades de chamada não-usuário

Por exemplo, um telefone sala de conferência celular, uma máquina de fax e um número do grupo de busca

Sincronização de diretórios

Listas telefônicas BroadWorks

Entradas da lista de telefones BroadWorks:

  • Listas telefônicas comuns da empresa

  • Listas telefônicas comuns dos grupos (provedor de serviços grupos ou grupos corporativos)

  • Listas telefônicas pessoais

Sincronização de diretórios (sincronização da lista de telefones)

Para obter mais detalhes sobre o provisionamento de usuários, consulte o Guia de soluções Webex para Cisco BroadWorks .

Condições de sincronização de diretório

  • Os administradores de parceiros devem habilitar a funcionalidade no nível do parceiro. Os administradores parceiros podem ativar ou desativar o recurso para várias organizações de clientes em uma única operação.

  • Por padrão, a sincronização inicial ocorre uma semana após a ativação da sincronização (o tempo escolhido para iniciar a sincronização é aleatória). No entanto, as organizações de clientes podem usar a opção Sincronizar agora para ignorar o período de espera de uma semana e acionar uma sincronização imediata para uma determinada organização do cliente.

  • Por padrão, a sincronização do diretório é executado semanalmente para cada cliente. Cada sincronização ocorre uma semana após a última sincronização, independentemente se a última sincronização foi agendada ou acionada manualmente com o Sync Now.

  • O número máximo de sincronizações simultâneas por grupo BroadWorks é dois: uma sincronização agendada e uma sincronização sob demanda (via API ou GUI do Partner Hub). No entanto, os administradores não podem executar duas sincronizações sob demanda ao mesmo tempo com o mesmo BroadWorks. Esta restrição existe, independentemente de a sincronização ter sido iniciada através da API ou através da opção Sincronizar agora no Hub do parceiro. Além disso, a Webex não agendará duas sincronizações agendadas para executar ao mesmo tempo das mesmas BroadWorks.

  • Se ocorrer uma falha de sincronização, o Webex tenta sincronizar automaticamente a cada 24 horas até a próxima sincronização agendada.

  • A sincronização ignora usuários que não têm um número de telefone.

  • No Partner Hub, você pode visualizar as informações de status de sincronização de um determinado cliente. Além disso, você pode exportar informações detalhadas sobre a última sincronização com um registro CSV. O registro CSV fornece mais detalhes do que a exibição do Control Hub e pode ajudar na solução de problemas, análise e auditoria.

  • O Webex armazena os contatos dos usuários em um formato criptografado. Apenas o usuário que possui o contato tem acesso à chave de descriptografia.

  • Para usuários de chamadas BroadWorks e entidades de chamadas não-usuários, esse recurso sincroniza os seguintes tipos de números de telefone do BroadWorks:

    • Número de telefone principal

    • Número de celular

    • Ramal

    No entanto, a sincronização exclui usuários de chamadas BroadWorks apenas e entidades de chamadas não-usuários da sincronização se nenhum número de telefone primário ou ramal estiver presente.

    A configuração do serviço de privacidade no nível do usuário do BroadWorks não é suportada como parte da sincronização de diretórios.

Número máximo de telefones BroadWorks e contatos

A sincronização de diretórios também sincroniza entradas da lista de telefones BroadWorks aos Contatos Webex. Entradas sincronizadas são adicionadas a um dos seguintes tipos de contato:

  • Contatos da Organização—Webex armazena esses contatos contra uma organização. Cada usuário pode acessar os contatos da organização para sua organização. O máximo é de até 30000 contatos.

  • Contatos de Usuário—O Webex armazena esses contatos contra um usuário. Apenas o usuário que possui o contato pode acessar a entrada de contato. O máximo é de até 2000 contatos (1500 contatos sincronizados + 500 contatos de entrada manual).

Apenas entradas da Lista de Telefones são adicionadas aos Contatos Webex. Usuários de chamada BroadWorks somente e entidades de chamada não-usuário que estão incluídas na sincronização de diretórios não são adicionadas aos Contatos, a menos que um usuário Webex os adicione aos Contatos manualmente.

A tabela a seguir mapeia os tipos de contato Webex com a fonte de contato (sincronizado de uma lista de telefones BroadWorks ou adicionado manualmente):

Tabela 2. Máximos de sincronização de diretório e fonte

Tipo de contato Webex

Fonte do contato

Máximo

Sincronizado do BroadWorks...

API usado para sincronização

Contatos da organização

Sincronização de diretórios

30000 contatos

Listas telefônicas comuns da empresa

/diretórios/enterprisecommon

Listas de telefones comuns do grupo (para um provedor de serviços grupo)**

/diretórios/groupcommon

Contatos do usuário

Sincronização de diretórios

1500 contatos

Listas telefônicas pessoais

/diretórios/pessoais

Adicionado manualmente pelo usuário

500 contatos

N/D

N/D

Contatos do grupo

Sincronização de diretórios

30000 contatos por grupo

Listas de telefones comuns do grupo (para um grupo Empresarial)**

/diretórios/groupcommon

**Entradas das Listas de telefones comuns do grupo são sincronizadas de forma diferente, dependendo se as BroadWorks estão no modo Empresarial ou provedor de serviços corporativo. O valor do parâmetro isBroadWorksEnterprise (verdadeiro ou falso) determina como a lista é sincronizada:

  • Verdadeiro — Sincronizar como contato do grupo

  • Falso—Sincronizar como contato da organização

As seguintes condições se aplicam em torno de como a Sincronização de diretórios lida com o máximo de contatos:

  • Se uma organização exceder o número máximo permitido de contatos para a sincronização (contatos da organização 30000 ou contatos comuns do grupo 30000 por grupo), a sincronização de diretórios excluirá entradas acima do limite máximo. Não há ordem específica aplicada aos contatos sincronizados ou omitidos.

  • Se um dos seus clientes excede o número máximo permitido de contatos em qualquer uma das categorias, recomendamos que você aumente um caso com a Cisco para que a organização seja excluída da sincronização de diretórios.

  • Contatos manuais são contatos que um usuário adiciona manualmente no aplicativo Webex. Um usuário pode adicionar até 500 contatos manuais. Os contatos manuais estão dentro da categoria de contato de usuário maior no Webex, mas não estão incluídos na sincronização.

  • O limite total combinado para contatos da organização (30000) e contatos de grupo (30000 por grupo) é de 200000.

Atualizações

Segue como o diretório Webex lida com as atualizações:

  • Se o nome do contato muda no BroadWorks, o contato existente é excluído do diretório Webex e um novo contato é criado.

  • Se o número de contato for atualizado no BroadWorks, o Webex atualizará o contato existente no diretório Webex com o novo número.

Depois que um administrador atualiza um contato no BroadWorks, as seguintes condições se delineam quando a atualização é exibida no aplicativo Webex de um usuário:

  • Se a atualização for para um usuário de chamada somente BroadWorks ou uma entidade de chamada não-usuário, a atualização será exibida no aplicativo Webex de um usuário imediatamente após a sincronização do diretório subsequente.

  • Se a atualização for para uma entrada na lista de telefones BroadWorks:

    • Para contatos de usuário—As atualizações são exibidas no aplicativo Webex do usuário imediatamente após a sincronização de diretório subsequente.

    • Para contatos de grupo - as atualizações são exibidas no aplicativo Webex dos usuários imediatamente após a sincronização de diretório subsequente.

    • Para contatos da organização— O diretório Webex é atualizado na sincronização de diretório subsequente, mas os usuários não verão a alteração no aplicativo Webex até que reiniciem o aplicativo Webex ou até o temporizador de cache de 72 horas local expirar.

As atualizações do Webex para o Cisco BroadWorks informações do usuário são tratadas como parte dos processos de provisionamento.
O Control Hub contém uma opção para adicionar ou editar contatos no nível da organização no Control Hub através de um arquivo CSV. Os administradores de parceiros e administradores de clientes com acesso do Control Hub podem acessar esta opção. No entanto, a atualização de contatos via Control Hub não é suportada pelo Webex para o Cisco BroadWorks. Atualizações de contato aplicadas no Control Hub não sincronizam com o BroadWorks e não estão disponíveis para pesquisas de diretórios de telefones de mesa.

Pré-requisitos de sincronização de diretório

Recomendamos que você use as seguintes configurações:

Os exemplos abaixo presumem que você está usando um servidor XSP. Para servidores ADP, substitua (XSP_CLI) por (ADP_CLI).

  • Valores limite de tarifas—De definidas as seguintes propriedades do sistema de SobrecargaControle (XSP_CLI/Aplicativos/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit—Definir para um valor nulo.

    • Diretório globalTransmissão de transferência — Definida com um valor nulo.

    Recomenda-se que você de definir o usuárioDirectoryTransactionLimit e globalDirectoryTransactionLimit para um valor nulo. No entanto, se você decidir atribuir valores, cada um deverá ser definido como pelo menos cinco vezes o valor de transactionLimitPeriodSeconds (que deve ser 1).

  • Limites de transação—De configurar os seguintes valores (XSP_CLI/System/CommunicationUtility/DefaultSettings):

    • userTransactionLimit — De definida para pelo menos 100.

    • transactionLimitPeriodSecs —Definido para 1.

  • Valores de paging—Definir as propriedades do sistema de paging (XSP_CLI/Aplicativos/Xsi-Ações/Paging):

    • defaultPageSize— Definir para 50

    • disponívelUserMaxLimit —Definido para 100

  • Interface CTI—Certifique-se de carregar os certificados de CA Webex no armazenamento de confiança da interface CTI e permitir a autenticação do cliente na interface CTI.

Além disso, dependendo da versão do BroadWorks, recomendamos que você aplique os seguintes patches de sistema à implantação do BroadWorks antes de ativar esse recurso:

Para obter a lista completa dos requisitos de patch que formam o requisito mínimo do Webex para o Cisco BroadWorks, consulte Requisitos de software BroadWorks no Guia de soluções do Webex para o Cisco BroadWorks .

Habilitar sincronização de diretórios (novo modelo)

Os administradores de parceiros podem ativar a Sincronização de diretórios para um modelo de cliente ao criar o novo modelo. Todas as novas organizações de clientes atribuídas a esse modelo terão a sincronização de diretórios ativada. Para obter detalhes, consulte "Configurar os modelos do cliente" em Configurar a organização do parceiro no Hub de parceiros no Guia de solução do Webex para o Cisco BroadWorks.

O que fazer em seguida

Certifique-se de que seus usuários saibam que eles devem clicar na aba Contatos no aplicativo Webex pelo menos uma vez para ativar o recurso no aplicativo Webex. Isso precisa ser concluído apenas uma vez.

Habilitar sincronização de diretórios (modelo existente)

Os administradores parceiros podem concluir os seguintes passos para ativar a Sincronização de diretórios dentro de um modelo de cliente existente para habilitar o recurso para as organizações do cliente que usam o modelo.
1

Faça o sign in ao Partner Hub e escolha Configurações.

2

Role até Chamada BroadWorks e clique em Exibir modelos.

3

Selecione o modelo de cliente apropriado e role até BroadWorks Directory Sync.

4

Para habilitar a sincronização de diretórios por padrão para novas adições de clientes que usam este modelo:

  1. De definir a configuração Ativar a sincronização do diretório BroadWorks e lista de telefones para que todas as novas organizações de clientes alternem para Ativado.

  2. Clique em Salvar.

5

Para habilitar a sincronização de diretórios para organizações de clientes existentes que usam este modelo:

  1. Clique em Mostrar lista de status de sincronização de clientes.

  2. Marque as caixas de seleção adjacentes para cada organização para a qual você deseja ativar o recurso.

  3. Clique em Habilitar sincronização.

Se você quiser desabilitar a sincronização de diretórios, siga o procedimento acima e:

  • Na etapa 4a, de configurar a opção Ativar sincronização de diretórios de telefone para todas as novas organizações de clientes alternar para Desativar para desabilitar a sincronização de diretórios por padrão para novas organizações de clientes que usam esse modelo.

  • Na etapa 5c, clique em Desabilitar sincronização para desativar o recurso para organizações existentes.

O que fazer em seguida

Certifique-se de que seus usuários saibam que eles devem clicar na aba Contatos no aplicativo Webex pelo menos uma vez para ativar o recurso no aplicativo Webex. Isso precisa ser concluído apenas uma vez.

Iniciar sincronização imediata

A opção Sincronizar agora permite que o administrador do parceiro acione uma sincronização sob demanda para uma determinada organização do cliente. Essa opção pode ser selecionada apenas para organizações de clientes individuais — não há opção em massa para Sincronizar agora.
1

Inicie sessão no Partner Hub ( http://admin.webex.com) e escolha Configurações .

2

Role até Chamada BroadWorks e clique em Exibir modelos.

3

Selecione o modelo de cliente apropriado e role até BroadWorks Directory Sync.

4

Clique em Mostrar lista de status de sincronização de clientes.

5

Para a organização do cliente que você deseja sincronizar, clique nos três pontos à direita e selecione Sincronizar agora.

6

Clique em Atualizar para ver os resultados de sincronização.

Exportar registros de sincronização para CSV

Os administradores de parceiros podem exportar informações detalhadas sobre a última sincronização com um arquivo CSV. O CSV contém uma exibição mais detalhada do registro de sincronização do que a GUI do Control Hub e pode ajudar na solução de problemas e análises.
1

Inicie sessão no Partner Hub ( http://admin.webex.com) e escolha Configurações .

2

Role até Chamada BroadWorks e clique em Exibir modelos.

3

Selecione o modelo de cliente apropriado e role até BroadWorks Directory Sync.

4

Clique em Mostrar lista de status de sincronização de clientes.

5

Marque as caixas de seleção adjacentes para cada organização que você deseja incluir na exportação.

6

Clique em Exportar resultados.

APIs públicas para sincronização de diretórios

As APIs públicas estão disponíveis em developer.webex.com que permitem que administradores parceiros atualizem as configurações de Sincronização de diretórios para as organizações de clientes que gerenciam, para acionar uma sincronização imediata ou obter informações de status de sincronização. Os métodos de sincronização de diretórios estão agrupados em BroadWorks Enterprises:

  • List BroadWorks Enterprises —Use este método de API para obter uma lista de empresas em um determinado provedor de serviços e em cada empresa id . Você deve entrar no spEnterpriseId conforme atribuído no provisionamento.

  • Atualizar sincronização de diretório para uma empresa BroadWorks —Insira o id da empresa para atualizar o status de syc de diretório para essa empresa, ativando ou desativando a sincronização de diretório.

  • Trigger Directory Sync para uma empresa —Use este método de API se desejar acionar uma sincronização imediata para uma determinada empresa id . Para o syncStatus , digite o SYNC _ NOW comando.

  • Obter status de sincronização de diretório para uma empresa —Insira o Enterprise id e execute para obter um status e trackingId da sincronização mais recente. Você pode usar o trackingID para executar análises adicionais através de ferramentas como Kibana e Grafana.

Além disso, os administradores podem usar a Sincronização de diretórios de trigger para uma API de usuário único para acionar uma sincronização de diretório sob demanda para um único usuário.

Para documentação api detalhada, consulte https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Você precisa fazer o sign in para ler a especificação da API em https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Sincronizar várias empresas com a API

Conclua este procedimento para usar as APIs públicas para acionar a sincronização de diretório de várias empresas.

  • A sincronização de diretórios permite sincronizar apenas uma única empresa de um grupo Broadworks por vez através de uma sincronização sob demanda. Se você tentar sincronizar mais de uma empresa, você receberá um erro 429

  • O tempo que leva para acionar uma sincronização para uma única empresa varia dependendo do tamanho da empresa.

1

Execute a lista BroadWorks Enterprises API para gerar uma lista de empresas que você deseja sincronizar.

  1. Definir startWith para a sequência inicial do identificador de empresa ou provedor de serviço.

  2. Clique em Executar.

2

Execute o Trigger Directory Sync para uma API Empresarial na primeira empresa da lista.

  1. Insira a ID da empresa.

  2. Definir syncStatus para SYNC _ NOW

  3. Clique em Executar.

    Uma sincronização imediata é acionada para a empresa. Essa sincronização é importante para a única sincronização sob demanda por limite de Broadworks.
3

Aguarde alguns segundos e execute a API Obter status de sincronização de diretórios para obter o status de sincronização.

  1. Insira o Enterprise id

  2. Clique em Executar.

4

Após a conclusão da sincronização, complete as etapas 2 a 4 na próxima empresa da lista. Repita estes passos até que você tenha sincronizado toda a lista.

Códigos de erro para sincronização de diretórios

Os seguintes códigos de erro se aplicam à sincronização de diretórios.

Código do erro

Mensagem de erro

600000

Erro inesperado de Sincronização do Usuário do Diretório Externo do Broadworks.

600001

Falha na Sincronização do usuário do diretório externo do BroadWorks.

600002

A Sincronização do usuário do diretório externo do BroadWorks teve que ser encerrada antes da conclusão.

600003

A Sincronização do usuário do diretório externo do Broadworks foi bem-sucedida apenas parcialmente. Algumas Organizações de clientes falharam ao sincronizar.

600004

A Sincronização do usuário do diretório externo do BroadWorks não está habilitada no ConfigSet.

600005

A Sincronização do usuário do diretório externo do BroadWorks está em andamento no ConfigSet.

600006

As threads de Sincronização do usuário do diretório externo do BroadWorks estão ocupadas ou desligando, por isso, não aceitarão mais solicitações de sincronização. Tente novamente mais tarde.

600007

A Organização da identidade do CustomerConfig não foi encontrada.

600008

O CustomerConfig não foi encontrado na organização parceira.

600009

A sincronização de usuários do diretório externo Broadworks não pode ser executar, pois o grupo broadworks associado ao CustomerConfig está ocupado

600010

A Sincronização do usuário do diretório externo do BroadWorks não pode ser executada porque não há um grupo do Broadworks associado ao CustomerConfig.

600011

A Sincronização do usuário do diretório externo do BroadWorks não está ativada no CustomerConfig.

600012

A Sincronização do Usuário do Diretório Externo do Broadworks não pode ser executada já que a sincronização do Diretório Híbrido já está ativada para o CustomerConfig.

600013

A Sincronização do usuário do diretório externo do BroadWorks falhou ao adicionar usuários e contas de máquina ao armazenamento de identidade.

600014

Falha de Sincronização do Usuário do Diretório Externo do Broadworks ao tentar conectar ao grupo Bradworks. Erro da Broadworks - %s.

600015

A Sincronização do Usuário do Diretório Externo do Broadworks não encontrou nenhum usuário correspondente no armazenamento de identidade.

600017

A sincronização da lista de telefones BroadWorks falhou ao sincronizar todos os contatos de usuários e empresas/organizações.

600018

A sincronização da lista de telefones BroadWorks falhou para usuários na empresa/organização.

600019

A sincronização da lista de telefones BroadWorks falhou ao sincronizar contatos de empresas/organizações.

600020

A sincronização de usuários do diretório externo BroadWorks não pode ser desativada porque a sincronização deconfiguração do cliente está em andamento.

600022

A sincronização de usuários individuais do diretório externo BroadWorks não é possível, uma vez que a empresa não tem usuário provisionado.

600023

A sincronização de usuários individuais do diretório externo BroadWorks não é possível porque o usuário já existe nesta organização.

600024

Não é possível sincronização de usuários individuais do Diretório externo BroadWorks porque nenhum usuário correspondente foi encontrado no BroadWorks.

600025

A sincronização de usuários do diretório externo BroadWorks falhou ao atualizar o conta de usuário em CI.

600026

A sincronização de usuários do diretório externo BroadWorks falhou ao atualizar a conta de máquina em CI.

600027

Não é possível sincronização de usuários individuais do Diretório externo BroadWorks porque vários usuários foram encontrados no BroadWorks.

600028

A sincronização de usuários individuais do diretório externo BroadWorks não é possível porque pelo menos uma sincronização de diretório empresarial deve ter sido concluída.

600029

A sincronização de usuários do diretório externo BroadWorks falhou, uma vez que a empresa não possui usuários provisionados.

Alterar histórico

A tabela a seguir resume as atualizações deste artigo.

Data

Revisão

14 de fevereiro de 2023

Seção Maximums de sincronização de diretório e fonte atualizada.

10 de dezembro de 2022

Atualizado o termo Concluir sincronização imediata para Sincronização do diretório de disparo

19 de julho de 2022

Esclarecimentos e correções às informações de visão geral:

  • Visão geral da sincronização de diretórios atualizada para esclarecer as diferentes sincronizações envolvidas e como o diretório Webex é atualizado para cada uma.

  • Lista de Telefones BroadWorks atualizada e Máximos de Contato para esclarecer que apenas as listas de telefone são sincronizadas com Contatos.

  • Correções de atualizações para esclarecer quanto tempo leva para o aplicativo Webex exibir registros atualizados.

09 de maio de 2022

  • Na Visão geral da sincronização dodiretório, nota corrigida na tabela Directory Sync Maximums e Source . Nota também atualizada sobre o provisionamento fluxo contínuo.

  • Edições e correções gramaticais

07 de abril de 2022

  • Nota adicionada à seção Atualizações no Visão geral da sincronização de diretórios em torno da limitação de aplicação de edições de contato no nível da organização no Control Hub.

28 de março de 2022

  • Reinserir o conteúdo faltando em Habilitar sincronização de diretórios (novo modelo) .

  • Adicionou informações sobre os máximos de sincronização. Você pode executar uma sincronização agendada e uma sincronização de API simultaneamente do mesmo grupo.

  • Adicionadas informações sobre a sincronização do diretório de gatilho para uma API de usuário único.

24 de março de 2022

Adicionada lista de tipos de números de telefone sincronizados nas Condições de sincronização do diretório. A sincronização agora inclui números de telefone celular.

16 de março de 2022

  • Adicionado novos códigos de erro.

  • Adicionada declaração de descrição introdutiva para uma melhor usabilidade das pesquisas na Web.

17 de dezembro de 2021

  • Pequenas edições estruturais para corrigir o problema com o TOC faltando.

16 de dezembro de 2021

  • Artigo atualizado com valores máximos aumentados para contatos do Usuário.

08 de dezembro de 2021

  • A seção adicionada , Sync and Contact Maximums , para esclarecer como a Sincronização de diretórios deriva o número máximo de contatos de Organização e Usuário.

  • Formatação da tabela revisada em Códigos de Erro para sincronização de diretórios para uma melhor readabilidade.