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

A sincronização de diretórios garante que o Webex para os usuários do Cisco BroadWorks possa usar o diretório Webex para ligar para qualquer entidade de chamada do servidor BroadWorks. Quando este recurso é ativado, o diretório de chamada completo do servidor BroadWorks é sincronizado com o diretório Webex. Os usuários podem acessar o diretório do aplicativo Webex e fazer uma chamada para qualquer entidade de chamada do servidor BroadWorks.

A sincronização de diretórios inclui a sincronização de informações de chamadas dos usuários, bem como listas de telefones. Registros da lista de telefones sincronizados são escritos para um dos dois tipos de contato no diretório Webex:

  • Contatos da Organização — Esses contatos são armazenados contra uma organização e estão disponíveis para todos os usuários na organização.

  • Contatos do Usuário— Esses contatos são armazenados contra um usuário e estão disponíveis apenas para o usuário que possui o contato.


Webex para provisionamento Cisco BroadWorks inclui uma sincronização padrão de usuários de mensagens e suas informações de chamada associadas do servidor BroadWorks para o diretório Webex. No entanto, a sincronização de provisionamento padrão omiti os usuários que não enviam mensagens e entidades não-usuários (por exemplo, um telefone sala de conferência de usuário, uma máquina de fax ou número grupo de busca usuário). A aplicação da sincronização de diretórios garante que todas as entidades de chamada são adicionadas ao diretório Webex.

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

  • Os administradores de parceiros devem ativar 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 do cliente podem usar a opção Sincronizar agora para ignorar o período de espera de uma semana e concluir 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 sincronização foi agendada ou acionada manualmente com o Sync Now.

  • Se ocorrer uma falha de sincronização, a sincronização será rea mesmo 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 é mais detalhado do que a exibição do Control Hub e pode ajudar na solução de problemas, análise e auditoria.

  • Os contatos do usuário são armazenados em um formato criptografado apenas com o usuário que possui o contato tendo acesso à chave de descriptografia.

  • Esse recurso sincroniza os seguintes tipos de lista de telefones do servidor BroadWorks:

    • Listas telefônicas comuns da empresa

    • Listas telefônicas comuns do grupo

    • Listas telefônicas pessoais

Máximos de contato e sincronização de diretórios

A seguir estão o número máximo de contatos que a sincronização de diretórios permite para cada tipo de contato Webex:

  • 500 Contatos da Organização

  • 500 contatos de usuário—Para um usuário, o máximo inclui contatos de usuários sincronizados e contatos manuais (contatos que o usuário adiciona manualmente através do aplicativo Webex)

As seguintes condições se aplicam:

  • Se uma organização tiver mais de 500 contatos em qualquer uma das categorias, a sincronização excluirá entradas acima do limite de 500 limites. Não há ordem específica aplicada aos contatos sincronizados ou omitidos.

  • Se um usuário adiciona contatos manualmente no aplicativo Webex, o máximo de contato do Usuário é determinado subtraindo os contatos manuais de contatos de usuários sincronizados. Por exemplo, se um usuário adiciona 100 contatos manualmente no aplicativo Webex, a sincronização de diretórios permite que até 400 contatos de usuários sejam sincronizados com o BroadWorks para esse usuário.

  • Recomendamos que se uma das suas organizações de clientes tiver mais de 500 contatos em qualquer uma das categorias, levante um caso com a Cisco para que a organização seja excluída da sincronização de diretórios.

A tabela a seguir mapeia os tipos de contatos Webex à lista de telefones BroadWorks a partir da qual os registros são sincronizados:

Tabela 1. Tipos de contatos de sincronização de diretórios e fonte de sincronização

Tipo de contato Webex

Sincronizado do BroadWorks...

API usado para sincronização

Contatos da organização

Listas telefônicas comuns da empresa

/directories/enterprisecommon

Listas de telefones comuns do grupo (enquanto provedor de serviços modo)**

/directories/groupcommon

Contatos do usuário

Listas de telefones comuns de grupo (enquanto no modo empresarial)**

/directories/groupcommon

Listas telefônicas pessoais

/directories/personal


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

  • Verdadeiro—Sincronizar como contato da organização

  • Falso—Sincronizar como contato do usuário

Atualizações

Depois que um contato é atualizado no BroadWorks, o seguinte esboço quando a atualização é exibida no aplicativo Webex de um usuário:

  • As atualizações do contato da organização são exibidas no aplicativo Webex após o usuário reiniciar o aplicativo ou após o temporizador de cache local de 72 horas do aplicativo expirar.

  • Atualizações de contato do usuário são exibidas no aplicativo Webex para esse usuário imediatamente.

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 contato existente no diretório Webex será atualizado com o novo número.

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

Alternar requisitos

Existem as seguintes alternâncias de recursos para esse recurso. Certifique-se de entrar em contato com seu Webex para o representante do Cisco BroadWorks para definir essas.

Alternância de recursos

Aplicado a...

Descrição

webex-for-broadworks-phone-list-sync

Parceiro

Alternância obrigatória. Permite a sincronização da lista de telefones para todas as organizações de clientes neste parceiro.

Deve estar habilitado.

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

Organização do cliente

Alternância opcional. Desativa a sincronização da lista de telefones para uma determinada organização, mesmo se o recurso estiver ativado no nível do parceiro e no modelo do cliente.

Aplique essa alternância somente se você quiser desabilitar a sincronização da lista de telefones para uma organização específica do cliente. Caso contrário, você pode deixá-lo desativado.


 
Por exemplo, você deve aplicar essa alternância a quaisquer organizações que requerem mais de 500 contatos.

hidden-personal-contacts-enabled-ga

Usuário

Alternância opcional. Oculta contatos pessoais das pesquisas de diretório concluídas por este usuário.

hidden-org-contacts-enabled-ga

Usuário

Alternância opcional. Oculta os contatos da organização das pesquisas de diretório concluídas por este usuário.

Requisitos de pré-configuração

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 a lista completa de requisitos de patches que formam o requisito mínimo de Webex para o Cisco BroadWorks, consulte os Requisitos do Software BroadWorks no Guia de Solução para o Webex para o CiscoBroadWorks.

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 login no Hub de parceiros 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 Em.

  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 clientes status de sincronização.

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

  3. Clique em Habilitarsincronizaçã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.

Concluir sincronização imediata

A opção Sincronizar agora permite que o administrador do parceiro complete 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

Faça o sign in ao 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 clientes status de sincronização.

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

Faça o sign in ao 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 clientes status de sincronização.

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 são agrupados em BroadWorks Enterprises. Existem quatro APIs:

  • Listar Empresas BroadWorks —Use este método de API para obter uma lista de empresas em um determinado provedor de serviçose o de cada empresa id. Você deve inserir o spEnterpriseId atribuído no provisionamento.

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

  • Acionar a sincronização do diretório para uma empresa— Use este método API se você quiser acionar uma sincronização imediata para uma determinada empresa id. Para a syncStatus, insira o SYNC_NOW Comando.

  • Obter o status de sincronização de diretórios para umaempresa — Insira a empresa id e execute para obter um status e trackingId da última sincronização. Você pode usar o trackingID para executar análises adicionais através de ferramentas como a Kibana e Analyticsana.

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 completar a sincronização de diretórios para várias empresas.

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

  • O tempo que leva para concluir uma sincronização de uma única empresa varia de acordo com o 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 como SYNC_NOW

  3. Clique em Executar.

    Uma sincronização imediata é acionada para a empresa. Essa sincronização é importante para o limite de uma sincronização por instância.
3

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

  1. Inserir a ID da empresa

  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 de usuários do diretório externo Broadworks.

600001

Falha na sincronização de usuários do diretório externo Broadworks.

600002

A sincronização de usuários do diretório externo Broadworks teve que ser encerrada antes da conclusão.

600003

A sincronização de usuários do diretório externo Broadworks teve êxito apenas parcialmente. Algumas organizações de clientes falharam ao sincronizar.

600004

A sincronização de usuários do diretório externo Broadworks não está habilitada para o ConfigSet.

600005

A sincronização de usuários do diretório externo Broadworks está em andamento para o ConfigSet.

600006

Os tópicos de sincronização de usuários do diretório externo Broadworks estão ocupados ou desligados, portanto, não aceitarão mais solicitações de sincronização e tente novamente mais tarde.

600007

A Identidade Org 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 de usuários do diretório externo Broadworks não pode ser executar, pois não há um grupo broadworks associado ao CustomerConfig.

600011

A sincronização de usuários do diretório externo Broadworks não está ativada para aconfição de cliente.

600012

A sincronização de usuários do diretório externo Broadworks não pode ser executado porque a sincronização de diretórios híbridos já está ativada para o CustomerConfig.

600013

A sincronização de usuários do diretório externo Broadworks falhou ao adicionar usuários e contas de máquinas ao armazenamento de identidades.

600014

A sincronização de usuários do diretório externo Broadworks falhou ao tentar se conectar ao grupo Broadworks. Erro da Broadworks - %s.

600015

A sincronização de usuários do diretório externo 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.