Obrigado pelos seus comentários.

Este artigo destina-se à equipe de suporte técnico de uma organização prestadora de serviços, responsável pelo suporte a si mesma e aos seus clientes. Eles devem estar familiarizados com a resolução de problemas em geral, leitura de registros e trabalho com casos de assinantes.

Este artigo está dividido em três seções principais:

• Recursos — fornece uma lista de ferramentas, material de leitura, registros e contatos que você pode precisar.
• Processos — descreve algumas das ações que você pode tomar ao solucionar um problema do cliente.
• Problemas específicos — categoriza e lista os problemas que já ocorreram, como identificá-los e como você pode resolvê-los.

Arquivos de registro úteis

Lista de leitura

• Portal de conhecimento para parceiros Webex para Cisco BroadWorks
• Guia de Configuração da Plataforma XSP (R23)
• Guia de Gerenciamento de Software BroadWorks (R23)
• Guia de Configuração de Gerenciamento de Dispositivos Cisco BroadWorks (R23)
• Guia de Administração da Interface de Linha de Comando Broadworks Xsp
• Descrição do recurso de token de autenticação há muito tempo autenticada versão 23.0
• Guia de integração da autenticação SAML, R23
• Guia de opções de suporte SSL do Cisco BroadWorks
• Descrição do recurso de suporte do Cisco CI
• Servidor de notificações push (Descrição do recurso)
• Suporte de notificação por push para chamadas Feature Description versão 22.0
• Método de migração do Connect (Android) para o Firebase
• Descrição do recurso de armazenamento de tokens de dispositivo para notificações push do Cisco BroadWorks - Versão 22.0
• Planejador de Capacidade do Sistema Cisco BroadWorks (planilha)
• Guia de Dimensionamento da Plataforma Cisco BroadWorks
• Guia de Engenharia de Sistemas Cisco Broadworks
• Requisitos do suporte de autenticação CI Versão 1.0 MR-7136

Problemas conhecidos e limitações

O artigo Problemas e Limitações Conhecidos contém informações atualizadas sobre problemas conhecidos que identificamos na solução Webex para BroadWorks.

Conector de operacionalidade

O serviço Webex Serviceability aumenta a velocidade com que a equipe de assistência técnica da Cisco pode diagnosticar problemas na infraestrutura. Automatiza as tarefas de encontrar, recuperar e armazenar registros de diagnóstico e informações em um caso de solicitação de serviço. O serviço também aciona análises contra assinaturas de diagnóstico para que o TAC possa identificar e resolver com mais eficiência problemas com seus equipamentos no local.

Para obter detalhes sobre como implantar o conector Serviceability, consulte Guia de Implantação para o Conector Serviceability do Cisco Webex.

Escalar um problema

Após seguir algumas das orientações de resolução de problemas, você deverá ter uma ideia razoável da origem do problema.

Procedimento

1. Reúna o máximo de informações possível dos sistemas relacionados ao problema.
2. Entre em contato com a equipe apropriada da Cisco para abrir um chamado.

Que informações do cliente coletar

Se você acha que precisa abrir um caso ou escalar um problema, colete as seguintes informações ao solucionar os problemas com o usuário:

• Identificador de usuário: Endereço de e-mail do CI ou UUID do usuário (este é o identificador do Webex, mas se você também obtiver o identificador do usuário no BroadWorks, inclua-o nos detalhes do caso).
• Identificador da organização.
• Período aproximado em que o problema ocorreu.
• Plataforma e versão do cliente.
• Enviar ou coletar registros do cliente.
• Anote o ID de rastreamento, caso esteja visível no dispositivo do cliente.

Verifique os detalhes do usuário na Central de Ajuda.

Os administradores parceiros que possuem privilégios de função de Administrador do Help Desk (Básico ou Avançado) podem usar este procedimento para verificar os detalhes do usuário usando a visualização do Help Desk.

Procedimento

1. Faça login no Help Desk.
2. Procure e clique no usuário. Isso abre a tela de resumo do usuário.
3. Clique no nome de usuário para ver a configuração detalhada do usuário. As informações úteis nesta visualização incluem o UUID do usuário, o cluster de identidade comum (CI), o cluster do aplicativo Webex, o comportamento de chamadas e o GUID da conta BroadWorks.
4. Clique em Copiar se precisar usar essas informações em outra ferramenta ou anexá-la a um caso da Cisco.

Visualize a organização do cliente no Help Desk.

Os administradores de parceiros que possuem privilégios de função de Administrador de Help Desk (Básico ou Avançado) podem usar este procedimento para visualizar os detalhes da organização do cliente na visualização do Help Desk.

Procedimento

1. Faça login no Help Desk.
2. Procure e clique no nome da organização do cliente.
3. Role para baixo até ver Visualização do Portal do Cliente e clique em Visualizar NomeDoCliente para ver uma visualização somente leitura da organização do Cliente – incluindo usuários e configuração.

Recupere os registros de usuários do Partner Hub.

Ao solucionar problemas em clientes de desktop e dispositivos móveis, é importante que os parceiros (e o TAC) possam visualizar os registros do cliente.

Procedimento

1. Peça ao usuário para enviar registros. Para obter ajuda, consulte: Aplicativo Webex | Reportar um problema.
2. Peça ao usuário para exportar o ambiente de chamada e enviar o arquivo ced.dat.
3. Obtenha os registros do cliente no Partner Hub ou na Central de Ajuda.

   Opção hub do parceiro:

   1. Entre no Hub de parceiros e encontre a organização do cliente do usuário.
   2. Selecione Solução de problemas.
   3. Selecione Registros.
   4. Procure pelo usuário (por e-mail).
   5. Exibir e baixar os registros do cliente como um arquivo zip.

   Suporte técnico opção:

   1. Faça o sign in para Suporte técnico.
   2. Procure a organização.
   3. Clique na organização (abre a tela de resumo).
   4. Deslize para baixo e clique em Ver cliente.
   5. Selecione Solução de problemas.
   6. Selecione Registros.
   7. Procure pelo usuário (por e-mail).
   8. Exibir e baixar os registros do cliente como um arquivo zip.

Como encontrar a versão do cliente

Procedimento

1. Compartilhar este link com o usuário: https://help.webex.com/njpf8r5
2. Peça ao usuário para enviar o número da versão.

Verificação do cliente para serviço de chamadas

Procedimento

1. Faça login no cliente Webex.
2. Verifique se o ícone de Opções de chamada (um telefone com uma engrenagem acima dele) está presente na barra lateral. Se o ícone não estiver presente, o usuário ainda não estará habilitado para o serviço de chamada no Control Hub.
3. Abra o menu Configurações/Preferências e vá para a seção Serviços telefônicos. Você deve ver o status SSO Da sessão em que você está lo como. (Se for um serviço telefônico diferente, como Webex Calling ,é mostrado, o usuário não está usando o Webex para o Cisco BroadWorks.)

   Esta verificação significa:

   • O cliente caminhou com sucesso os microsserviços Webex necessários.
   • O usuário foi autenticado com êxito.
   • O cliente recebe um token web JSON de longa duração do seu sistema BroadWorks.
   • O cliente recupera o perfil de dispositivo e foi registrado na BroadWorks.

Obtenha registros ou feedback do cliente.

• Consulte a seção Recursos para encontrar registros de clientes específicos nos clientes de desktop Webex ou peça aos usuários para enviarem registros. Para obter ajuda, consulte: Aplicativo Webex | Reportar um problema.
• Solicite aos usuários de aplicativos móveis que enviem os registros de atividades; em seguida, você poderá recebê-los por meio do Partner Hub ou da Central de Ajuda.
  Enviar registros é silencioso. No entanto, se um usuário enviar comentários, ele será para a equipe de devops do aplicativo Webex. Certifique-se de gravar o número de comentários do usuário se você quiser acompanhar com a Cisco. Por exemplo:

  

Obter dados do ambiente de chamada

Os registros de clientes Webex são altamente reacionados para remover informações de identificação pessoal. Você deve exportar os dados do ambiente de chamada do cliente na mesma sessão que você notar o problema.

Procedimento

1. No cliente, clique em Ajuda > Verificador de saúde.
2. Selecione Redefinir banco de dados. Isso aciona uma reinicialização completa do cliente e carrega a tela de login do aplicativo Webex.

Verifique se o Webex deve ser registrado no BroadWorks.

O aplicativo Webex verifica as seguintes informações para determinar se deve se registrar no BroadWorks:

• Direito do usuário ao broadworks-connector.
• Comportamento de chamada para organização e usuário.

Verifique o comportamento de chamada de um usuário e a autorização do conector

1. Faça login no Help Desk com suas credenciais de administrador parceiro.
2. Procure o usuário.
3. Clique no usuário e marque a entrada Comportamento de chamada. Ele deve ser "Calling in Webex".

   

4. Clique no nome de usuário para abrir a tela Detalhes do usuário.
5. Desça a página até encontrar a seção entitlements e verifique se broadworks-connector está incluída.

   

   Um usuário do Webex para Cisco BroadWorks não deve ter o direito bc-sp-standard se pretende usar o Webex para Cisco BroadWorks. Este é o direito de uso do "Webex Calling (Broadcloud)", que é uma chamada feita pelo aplicativo Webex através de um serviço de chamadas em nuvem gerenciado pela Cisco.

Verifique o comportamento de chamada da organização

1. Faça login no Help Desk com suas credenciais de administrador parceiro.
2. Procure a organização.
3. Clique na organização e verifique a entrada Comportamento de chamada. Ele deve ser "Calling in Webex".

Analise o PSLog em busca de problemas de provisionamento de usuários.

Use o PSLog do servidor de aplicativo para ver a solicitação HTTP POST para a ponte de provisionamento e a resposta do Webex. Em um caso de trabalho correto, a resposta é 200 OK e após alguns minutos você pode ver o usuário - e a nova org. do cliente, se for o primeiro usuário - foi criada no Webex. Você pode verificar isso pesquisando Suporte técnico pelo endereço de e-mail que você vê no POST.

Antes de começar

Colete um PSLog do servidor de aplicativos durante uma tentativa de provisionamento fluxo remoto com um usuário de teste.

Procedimento

1. Primeiro, verifique o código de resposta HTTP:
   • Qualquer coisa que não seja 200 OK é uma falha de provisionamento de usuário.
   • O código 200 OK ainda pode indicar uma falha se algo relacionado ao perfil do assinante não estiver funcionando nos serviços Webex que estão a montante da ponte de provisionamento.
   • 400 pode conter um nó message na resposta. A ponte de provisionamento não conseguiu processar algo em subscriberProfile. Pode haver algo errado com os detalhes do assinante ou incompatibilidade com uma configuração no modelo.
   • 401 significa que as credenciais de provisionamento inseridas no AS não são igual às inseridas no modelo no Partner Hub.
   • 403 pode indicar algo mal configurado no Servidor de Aplicativo. Verifique o destino da solicitação. ele não deve ser um endereço IP, deve ser a URL da ponte de provisionamento que você pode ver no seu modelo no Partner Hub.
   • 409 indica um conflito entre os dados fornecidos subscriberProfile e os dados existentes do Webex. Pode haver um usuário existente com esse endereço de e-mail. Verifique os colchetes message na resposta.
2. Você também pode verificar o HTTP POST original quanto a valores de suspeita que podem causar falha no provisionamento. O POST contém uma estrutura XML subscriberProfile. Dentro disso, os nós úteis para verificar são:
   • bwuserid: Use isso para encontrar o perfil do assinante se precisar editá-lo no BroadWorks.
   • group: Se o modelo estiver no "Modo de Provedor de Serviços", o nome será convertido para minúsculas e se tornará o nome da organização do cliente que você vê no Partner Hub.
   • serviceProvider: Se o modelo estiver no "modo Enterprise", ele será menor e se tornará o nome da org. do cliente que você vê no Partner Hub.
   • primaryPhoneNumber: Deve existir. O provisionamento falha sem ele.
   • email: Torna-se a ID do usuário no Webex. Deve ser válido e exclusivo para o Webex, caso contrário o provisionamento falha.

     Ignore a estrofe services : ele é criado por AS e aceito, mas não é usado pelo Webex.

Analise os logs XSP para solucionar problemas de login do assinante.

Este fluxo descreve o modo de autenticação BroadWorks. Você pode ver o modo de autenticação no modelo BroadWorks, no Partner Hub. Consulte Configurar os modelos do cliente em https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

O diagrama em escada a seguir mostra a interação entre o usuário, o cliente, os serviços Webex e o sistema BroadWorks, quando o usuário está realizando a autenticação BroadWorks no aplicativo Webex. Além disso, a conexão entre o Webex e o XSP é protegida por MTLS.

A discussão que se segue explica o que você pode esperar ver ao investigar os registros para um logon bem-sucedido.

O usuário interage com o cliente, o cliente interage com os serviços Webex:

• O usuário fornece seu endereço de e-mail ao aplicativo Webex (1 no diagrama).
• A CI sabe como redirecionar este usuário para inserir a senha do BroadWorks (via UAP) (2 no diagrama).
• O proxy IDP envia uma solicitação de obter perfil para a interface Xsi no XSP.

No gato macho access_log:

• Procure a solicitação GET para o perfil do assinante, do Webex para a interface Xsi-Actions (2.1 no diagrama). Ela tem a versão Webex ID do usuário. Por exemplo:

  GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

No XsiActionsLog:

• Procure a solicitação GET do perfil do Webex (2.1 no diagrama). Ela tem a versão Webex ID do usuário. Por exemplo:

  Os cabeçalhos incluemGET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profileauthorization: Basic e user-agent: broadworksTeamsClient

• O XSP então faz a autenticação OCI-P Basic contra o BroadWorks (AuthenticationVerifyRequest e AuthenticationVerifyResponse, como qualquer outro aplicativo que faz autenticação básica via Xsi) e também um UserGetRequest e ServiceProviderGetRequest para coletar as informações do assinante.
• A resposta Xsi ao Webex contém um bloco XML Profile contendo o (BroadWorks) userId e outros detalhes (2.2 no diagrama).

Interações dos serviços Webex e cliente:

• O proxy IDP corresponde ao perfil do usuário recebido do BroadWorks e emite uma declaração SAML para o cliente (2.3 no diagrama).
• O cliente troca uma declaração SAML por um token CI (3 no diagrama).
• O cliente verifica se o usuário que se inscreveu tem a autorização de conector broadworks (4 no diagrama). Você pode verificar as permissões de usuário no Help Desk.
• O cliente usa o token CI para solicitar um JSON Web Token (JWT) do proxy IdP (5 no diagrama).
• O proxy IDP valida o token CI no CI.
• O proxy IDP solicita o JWT do serviço de autenticação.

No registro do Serviço de autenticação:

• Procure a solicitação de token do Webex (5.2 no diagrama). Por exemplo: GET /authService/token que tem cabeçalho http_bw_userid e outros.
• O XSP faz OCI-P UserGetLoginInfoRequest, para validar se o ID de usuário fornecido corresponde a um usuário do BroadWorks (5.3 no diagrama). AuthService estabeleceu confiança com a Webex em virtude da conexão mTLS, então pode emitir LLT.
• Procure a resposta (5.4 no diagrama) de LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks … e StatusCode=200 que você pode associar à solicitação original usando o cabeçalho trackingid: CLIENT… .

No XsiActionsLog:

• O cliente pode apresentar o token de longa duração na interface Xsi-Actions para obter o perfil do seu dispositivo (6 no diagrama). Por exemplo: GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device Com os cabeçalhos authorization: Bearer token e user-agent: WebexTeams (variant/version)
• A interface Xsi-Actions envia o token via POST para o serviço de autenticação (configurado para estar na interface de loopback). Por exemplo: 127.0.0.1:80 POST http://127.0.0.1:80/authService/token que você pode correlacionar com o cabeçalho trackingid: CLIENT… no GET e o cabeçalho X-BROADSOFT-CORRELATION-ID : CLIENT… no POST.

No registro do Serviço de autenticação:

• O recibo do POST a partir de Xsi (loopback)

• Um StatusCode=200 de volta para Xsi

• E uma resposta de validação de token, contendo um bloco JSON "token" no corpo.

• Tem relação com o uso do trackingid: CLIENT…

No XsiActionsLog:

• Após receber o código 200 OK do serviço de autenticação, que validou o token do cliente, o aplicativo Xsi-Actions agora envia uma solicitação OCI-P para UserPrimaryAndSCADeviceGetListRequest
• Recebe OCI-P UserPrimaryAndSCADeviceGetListResponse contendo a estrutura XML accessDeviceTable.
• A resposta OCI-P é codificada como resposta Xsi ao cliente, incluindo estrutura XML AccessDevices, que tem o deviceTypes. Por exemplo: Business Communicator – PC e as urls onde o cliente pode recuperar os arquivos de configuração do dispositivo.

Cliente continua como normal:

• Seleciona uma entrada de dispositivo e interage com o DMS para obter o perfil do dispositivo (6 no diagrama).
• Registros no BroadWorks via SBC recuperados na configuração do DMS (7 no diagrama).

Problemas com o Hub de Parceiros

1. O administrador não consegue visualizar as organizações de clientes.

Como administrador da sua organização parceira no Webex, você deve ter a função de Administrador completo. Essa função é usada para gerenciar a organização do seu parceiro, inclusive a atribuição de privilégios administrativos para você mesmo e para terceiros. Para gerenciar organizações de clientes, você precisa conceder a si mesmo (ou a outras pessoas) a função de Administrador de Vendas Completo ou Administrador de Vendas. Para obter detalhes, consulte Atribuir funções de conta da organização no Control Hub.

Problemas de provisionamento de usuários

1. IM integrado & Erros P para empresas específicas / clientes

Se você tiver uma combinação de empresas que utilizam diferentes serviços de colaboração em nuvem, por exemplo, UC-One SaaS e Webex para Cisco BroadWorks, você pode ter optado por modificar o adaptador de provisionamento para cada empresa individualmente.

Para verificar o que está configurado para o IM Integrado & P (padrão para empresas, a menos que exista uma configuração mais específica), execute AS_CLI/Interface/Messaging> get. Para os parâmetros de provisionamento de uma empresa específica, abra a empresa e acesse Serviços > IM integrado & P.

Verifique se a configuração IM&P integrada para essa empresa corresponde exatamente ao que é mostrado no modelo de cliente no Partner Hub. As configurações a seguir devem corresponder ou o provisionamento falha para todos os usuários na empresa:

2. IM integrado & Erros P para usuários específicos

Isso se aplica se você estiver usando o provisionamento de fluxo contínuo e pressupõe que o provisionamento esteja funcionando corretamente. some/most usuários (assim você pode descartar um problema de configuração). Se você estiver vendo a opção Mensagens Instantâneas Integradas & Erros P no BroadWorks, por exemplo, “[Error 18215] Erro de provisionamento com o servidor de mensagens” e “[Error [18211] Erro de comunicação com o servidor de mensagens”, você deve investigar as seguintes causas potenciais:

• O endereço de e-mail do usuário já pode existir CI. Procure o usuário na Central de Ajuda para verificar se o endereço de e-mail dele já está cadastrado. Isso não é necessariamente conclusivo, pois o usuário pode pertencer a uma organização cujos dados você não tem permissão para visualizar na Central de Ajuda.
• O usuário inscreveu-se de forma independente no Webex, antes de ser atribuído ao serviço IM&P integrado. Nesse caso, uma opção é pedir ao usuário que exclua suas contas gratuitas para que ele possa passar a fazer parte da Organização de Clientes que você está provisionando. As instruções estão em https://help.webex.com/5m4i4y
• O usuário não possui um número de telefone principal associado ao seu perfil (todos os assinantes do Webex para Cisco BroadWorks devem ter um DID principal). Consulte o tópico sobre analisar PSLog de AS.

3. Falhas no provisionamento de usuários em resposta à ponte de provisionamento

Se os usuários não estiverem aparecendo no Hub de Controle, isso pode ocorrer poucos minutos após a atribuição do IM Integrado. & P, dê uma olhada nos códigos de resposta do serviço de ponte de provisionamento. Execute um PSLog para ver os códigos de resposta HTTP.

200 OK

Uma resposta 200 OK não significa que o usuário foi provisionado com sucesso. Isso significa que o serviço de provisionamento recebeu a solicitação e enviou com sucesso a solicitação de criação do usuário correspondente para os serviços de upstream. A transação de provisionamento é assíncrona pelo design. O serviço responde com 200 OK porque o processo de criação de usuário pode levar vários minutos e, por motivos de desempenho, não queremos receber várias solicitações para criar o mesmo usuário. No entanto, se o usuário não aparecer na Organização do Cliente após uma resposta 200 OK, isso pode indicar que a criação do usuário falhou nos serviços Webex anteriores ao serviço de provisionamento. Você precisa escalar uma falha de provisionamento que tem uma resposta de 200 OK.

400 Solicitação ruim

Verifique a resposta HTTP, que deve ter mais detalhes sobre possíveis problemas que podem causar essa resposta do serviço de provisionamento. Alguns exemplos do nó:

• "Não é possível confiar no e-mail BroadWorks com a API de provisionamento herdada." O endereço de e-mail associado à falha da solicitação de provisionamento do usuário não é válido ou está inconsateido, mas você afirmou no modelo que os endereços de e-mail podem ser confiáveis. Verifique os perfis de usuários no BroadWorks, especificamente a ID de e-mail.
• A organização do cliente não foi encontrada no banco de dados e a opção para criação de novas organizações também não está habilitada. Essa solicitação de provisionamento com falha deve estar criando uma nova Organização do Cliente em Webex, mas seu modelo está configurado para impedir que novas Organizações de Clientes sejam criadas. Se você deseja permitir que novas organizações, para domínios de e-mail que não combinam com os clientes existentes no Webex, você pode reconfigurar seu modelo no Hub do parceiro e teste novamente a solicitação de provisionamento. No entanto, se você não está esperando que uma nova organização seja criada para este usuário, talvez o endereço de e-mail esteja misto (especificamente a parte do domínio). Verifique a ID de e-mail do usuário em BroadWorks.

403 Proibido

A solicitação de provisionamento não poderá ser concluída até que você corrija a configuração. Nesse caso, você precisará investigar a solicitação e a resposta. Por exemplo, se você vir um endereço de IP como o alvo da solicitação de provisionamento - em vez da URL de ponte de provisionamento apropriada para sua organização (consulte os tópicos de configuração do firewall no Guia de Solução) - ele pode indicar que o servidor de aplicativo está faltando um patch necessário (ap373197).

Verifique se todos os patches necessários foram aplicados ao Servidor de aplicativo e se você concluiu a configuração relacionada para provisionamento fluxo mais bem sucedido.

Conflito 409

A solicitação de provisionamento não pode prosseguir porque há um usuário existente no Webex que corresponde ao endereço de e-mail na solicitação.

4. Usuário já está em CI

Receba o e-mail do assinante da solicitação HTTP POST e pesquise-o Suporte técnico. Você pode não ver o usuário se não for permitido, mas você também pode ver que o usuário está em uma organização "gratuita", por exemplo, "Consumidor". Você pode solicitar que esse usuário exclua sua conta gratuita ou você pode usar um endereço de e-mail diferente para provisioná-lo. Consulte .https://help.webex.com/ndta402

Problemas de login do usuário

1. O portal de ativação do usuário não carrega.

O fluxo de login normal do Webex para o Cisco BroadWorks inclui um Portal de Ativação de Usuário onde os usuários insem suas senhas. Por vezes, este portal não carrega depois de o utilizador ter fornecido o seu endereço de email no ecrã de início de sessão da aplicação Webex. Esse problema pode ser causado no lado do cliente ou no lado do serviço. No lado do cliente, normalmente, isso é causado pelo navegador nativo do cliente ser incompatível de alguma forma com o serviço.

2. Falha no único ponto de partida

• No BroadWorks, verifique se o usuário recebeu os tipos de dispositivo para o aplicativo Webex (consulte a seção Perfis de dispositivo na seção Preparar seu ambiente do Guia de soluções).
• Verifique se o usuário está utilizando a senha correta. Se o modelo que você usou para provisionar a Organização do Cliente do usuário (no Partner Hub) estiver configurado para autenticação BroadWorks, o usuário deverá inserir sua senha de "Acesso Web" do BroadWorks. O usuário também poderá precisar inserir seu ID de usuário do BroadWorks caso seu endereço de e-mail não esteja configurado como um ID de usuário alternativo. Certifique-se de que o usuário digitou corretamente as letras maiúsculas e minúsculas.

Problemas de configuração e registro de chamadas

Após um usuário ser provisionado no Webex e efetuar login com sucesso no aplicativo Webex, o aplicativo se registra no BroadWorks. A seguir, apresentamos a sequência de registro esperada e os sinais resultantes de um registro bem-sucedido (conforme visualizado no aplicativo Webex):

1. Sequência de registro esperada

1. O cliente chama XSI para obter um token de gerenciamento de dispositivos e a URL para o DMS.
2. O cliente solicita seu perfil de dispositivo a partir de DMS, apresentando o token do passo 1.
3. O cliente lê o perfil do dispositivo e recupera as credenciais SIP, endereços e portas.
4. O cliente envia um SIP REGISTER para SBC usando as informações do passo 3.
5. O SBC envia o registro SIP para o AS (o SBC pode realizar uma busca no NS para localizar um AS caso ainda não conheça o usuário SIP).

2. Sinais esperados de um cadastro de cliente bem-sucedido

O ícone Opções de chamada é exibido na interface Webex.

Na guia de serviços de telefone do aplicativo Webex (por exemplo, Configurações > Serviços de telefone no Windows, Preferências > Serviços de telefone no Mac), a mensagem “Sessão SSO: Você está registrado" significa que o aplicativo foi registrado com êxito (para BroadWorks neste caso).

3. O cliente não possui ícone de chamada.

Na maioria das vezes, isso significa que o usuário não tem a licença/autorizações corretas.

Este é um registro sem sucesso. Existem vários motivos pelos quais um cliente do Webex App pode não conseguir se registrar no BroadWorks:

4. Vários serviços de chamada estão sendo testados com os mesmos clientes.

Esse problema conhecido pode ser causado pela alteração do cliente entre os diferentes terminais do retorno de chamada. É mais provável que isso ocorra durante testes de diferentes serviços de chamada oferecidos pelos mesmos clientes do aplicativo Webex. Você pode redefinir o banco de dados do cliente (link) para solucionar esse problema.

5. Configuração incorreta do serviço de autenticação

Verifique o(s) XSP(s) que hospedam o serviço de autenticação em relação ao Guia de solução (consulte Configurar serviços no seu Webex para Cisco BroadWorks XSPs). Especificamente:

• As teclas RSA (que você gera em um XSP) são copiadas para todos os XSPs
• A URL do serviço de autenticação foi fornecida ao recipiente da web em todos os XSPs e inserida corretamente no grupo no Hub do parceiro
• Autenticação externa por certificados está configurada:

  XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get

  allowUserApp = false

  allowClientApp = true

• Ao usar o MTLS, você deve carregar o certificado do cliente Webex nos XSPs (você pode obter o certificado no Partner Hub, na página Configurações do BroadWorks).

6. Configuração insatisfatório das tags BroadWorks

Verifique se você configurou as tags BroadWorks necessárias para o aplicativo Webex. Consulte o Guia de Configuração do Webex para Cisco BroadWorks para obter informações sobre tags de configuração. Certifique-se de que não haja conflitos ou valores incorretos. Especificamente, a tag %SBC_ADDRESS_WXT% deve ser o SBC para o seu registrador SIP para clientes do aplicativo Webex.

7. O cliente de desktop desconecta os serviços telefônicos após uma conexão SSO bem-sucedida.

Esse problema pode ser causado pelo mesmo usuário que está inando a vários clientes no mesmo tipo de plataforma. Por exemplo, se um usuário fizer login com sucesso no aplicativo Webex no Windows e, em seguida, fizer login no aplicativo Webex em outra máquina Windows, haverá apenas uma sessão SSO ativa em uma das máquinas. Isso é por design. Se você absolutamente precisar trabalhar em torno deste problema, você pode configurar o BroadWorks para ter várias instâncias do mesmo tipo de dispositivo, mas elas devem ter endereços SIP exclusivos. Esta configuração está fora do escopo do Webex para Cisco BroadWorks.

8. Dispositivo de mesa não provisionado para o usuário

Esta assinatura é visível no registro do cliente:

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - the device profile 'Business Communicator - PC' is not found.

9. As chamadas recebidas em celulares tocam uma vez ou não podem ser atendidas.

As chamadas recebidas no Webex Mobile tocam apenas uma vez, ou o usuário não consegue atender a chamada. Outros pontos de extremidade para o mesmo usuário podem continuar a tocar.

Como identificar?

Nos registros do cliente móvel Webex, procure pelo código de erro XSI 101002 no fluxo de chamadas push. Por exemplo:

Código de resposta: 400

handlePushCallInfoFailure:BWC:INTERNAL: Chamada push: Status xsi para callID: <callID> Código de erro xsi: 101002

closePushCallWithReason:BWC:INTERNAL: Tente fechar a chamada push com o ID = <callID>, razão = ChamadaAbandonada

Causa:O código de erro 101002 pode indicar que o servidor de aplicativos (AS) retornado na resposta está LocateUser incorreto . Isso pode acontecer quando o usuário migra para um sistema de administração secundário.

Verificações recomendadas:

No ADP ou XSP onde o Push está implantado, execute LocateUser para o usuário afetado:

curl 'http://:80/servlet/LocateUser?url=&returnCompatibleXSP=true&callPRequest=true'

Exemplo: curl 'http://1.1.1.1:80/servlet/LocateUser?url=9721112222@gmail.com&returnCompatibleXSP=true&callPRequest=true'

Resolução: Se LocateUser retornar o AS secundário para o usuário, execute o script migrateUserToDefaultNode.pl no servidor NS primário para migrar os usuários de volta para o servidor de aplicativos primário do cluster.

Faça login no servidor NS via SSH, acesse o diretório /usr/local/broadworks/bw_base/bin e execute:migrateUserToDefaultNode.pl

Exemplo: migrateUserToDefaultNode.pl bwas1

Para obter o valor hostingNE, execute: NS_CLI/System/Device/HostingNE> get

O script primeiro verifica se consegue encontrar a entidade de rede (NE) hospedeira que você fornece como argumento. Após verificar se o NE de hospedagem é válido, ele atualiza o DN, a extensão e o URL para o nó padrão desse NE de hospedagem.

Execute o script durante um período de baixo tráfego, sempre que possível. No entanto, geralmente é aceitável executar o script a qualquer momento, se necessário, para restaurar o serviço para os usuários afetados.

O script não pode ser executado para um único usuário. Ele migra todos os usuários listados na saída LocateUser. Se não conseguir executar o script, exclua e recrie o usuário afetado no BroadWorks para que o usuário seja recriado no AS correto.

Qualquer mensagem SIP enviada do dispositivo do usuário para o AS secundário pode causar a migração do usuário. Normalmente, os usuários retornam ao servidor AS primário após o intervalo padrão de 15 minutos, a menos que as solicitações de entrada continuem a chegar ao servidor AS secundário. Por exemplo, se o SBC não conseguir se conectar ao AS1 e recorrer ao AS secundário, os usuários afetados poderão ser redirecionados para o AS secundário. Dependendo da implementação, um único grupo de troncos ou usuário pode permanecer vinculado ao AS secundário caso o SBC continue apresentando problemas para alcançar o AS primário.

Para obter mais informações, consulte os seguintes documentos:

• Seções 3.4.5 Capacidade de reversão do usuário do servidor de aplicativos e 5.4.5 Reversão automática em Guia de redundância do Cisco BroadWorks

• Descrição dos recursos de aprimoramento do Cisco BroadWorks ASR

Problemas com a visualização da Web nas configurações de chamada

1. Autocuidados button/link Não está aparecendo no aplicativo Webex.

Um sintoma diferente deste problema é quando o botão/link é mostrado, mas clicar nele abre um navegador externo.

• Verifique se o modelo de configuração do cliente necessário está implantado e se as tags CSW estão configuradas corretamente. (Consulte a seção Configurações de chamada Webview no Guia de soluções Webex para Cisco BroadWorks).
• Verifique se o aplicativo Webex está registrado para chamadas no BroadWorks.
• Verifique se o aplicativo Webex é uma versão recente que oferece suporte ao CSWV.

2. Página em branco ou erro após clicar em Autocuidado button/link

Geralmente, esse comportamento no aplicativo Webex indica um problema de configuração ou implantação do aplicativo CSWV no BroadWorks XSP. Colete detalhes para uma investigação mais recente, incluindo registros CSWV, registros de acesso, repositório de config-wxt.xml e arquivo de modelo e, em seguida, levante um caso.

problemas de reivindicação de domínio

Erros de registro do usuário podem ocorrer como resultado de erros que são feitos na reivindicação de domínios. Antes de reivindicar quaisquer domínios, certifique-se de entender o seguinte:

• Os provedores de serviços não devem reivindicar os domínios das organizações de clientes que eles gerenciam. Eles devem reivindicar apenas os domínios dos usuários que estão na provedor de serviços da organização interna do usuário. Reivindicar o domínio de usuários em uma organização separada (mesmo que a provedor de serviços gerencie) pode resultar em erros de registro para os usuários na organização do cliente conforme as solicitações de autenticação de usuário são encaminhados através do provedor de serviços em vez da organização do cliente.
• Se duas organizações de clientes (Empresa A e Empresa B) compartilharem o mesmo domínio e a Empresa A tiver reivindicado o domínio, o registro dos usuários da Empresa B poderá falhar devido ao fato de que as solicitações de autenticação de usuário são roteados através da organização que tem o domínio reivindicado (Empresa A).

  Se você reivindicar quaisquer domínios por erro e precisar remover uma reivindicação, consulte o artigo Gerenciar seus domínios Webex.

Códigos de erro do usuário final

A tabela a seguir descreve os códigos de erro do usuário final que podem ser vistos no portal de ativação do usuário do cliente.

Códigos de erro para a Sincronização de Diretórios

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