Water Mark
19 mars 2021 | vue(s) | personnes ont trouvé ceci utile

Guide de dépannage de Webex pour BroadWorks

Conseils de dépannage pour Webex pour BroadWorks, y compris les sujets de « comment faire », les listes des fichiers journaux et leurs utilisations, et des conseils pour enquêter sur des problèmes spécifiques.

Dépannage de Webex pour BroadWorks

Dépannage de Webex pour BroadWorks

Dépannage de Webex pour BroadWorks

Ce document est destiné aux personnes techniques des organisations de fournisseurs de services qui sont en charge elles-mêmes et leurs clients. Nous prévoyons que vous vous familiariserez avec le dépannage en général, la lecture des journaux et la collaboration avec les cas des abonnés.

L’article est divisé en trois sections principales :

  • Ressources, qui est une liste d’outils, de lecture de documents, de journaux et de contacts dont vous aurez besoin.
  • processus, qui décrit certaines des actions que vous pouvez prendre lors du dépannage d’un problème client.
  • Problèmes spécifiques , qui classent et répertorient les problèmes qui ont été connus pour se produire, comment les repérer et comment vouspouvez éventuellement les résoudre.

Historique des changements

Date

Modifier

Section

Le 8 décembre 2020

Document mis à jour. Rebranding de Webex Teams à Webex (application).

Ajout des codes d’erreur de l’utilisateur final

Problèmes spécifiques

3 novembre 2020

Ajout de la vue Web des paramètres d’appel

Problèmes spécifiques

22 octobre 2020

Nouveau document introduit

Water Mark
19 mars 2021| vue(s) | personnes ont trouvé ceci utile

Ressources

Ressources de dépannage de Webex pour BroadWorks

Contacts


À partir d’octobre 2020, nous migrons l’assistance clientèle BroadSoft vers les processus et outils d’assistance Cisco CX. Ceci signifie que Webex pour les partenaires BroadWorks doit passer de l’utilisation de Xchange pour la gestion des cas à l’utilisation du Gestionnaire de cas d’assistance (SCM).

Nous prévoyons que la migration s’exécute pendant environ 3 mois et jusqu’à la fin de l’année calendaire 2020. L’équipe du CAT BroadWorks/UCaaS commencera à créer des cas d’aide dans CSOne/Lightning au lieu de BroadSoft Jira lorsque vous avez migré sur . Vous devrez peut-être vous référer à des cas dans les deux systèmes au cours de la période de migration.

Voir Legacy BroadSoft Support Transition pour plus de détails.

Fichiers journaux utiles

Nom du journal Source Utile pour le dépannage
Le PSLog Serveur d'applications Approvisionnement de flux
access_log tomcat Xsp Connexion à l’application Webex
XsiActionsLog Xsp Interactions de connexion de l’application Webex avec le proxy IDP Webex, interactions client pour les profils des périphériques
journal du service d’authentification Xsp Connexion à l’application Webex (validation et validation du jeton)
XSLog (Log XSLog) Xsp?

Abonnements mobiles pour les notifications Push

Signalisation des appels

Journal de démarrage de l’application Webex

Windows : \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac :

/Users/{username}/Library/Logs/SparkMacDesktop/current_log

Mobile : Utiliser Envoyer les journaux

Démarrage (séquence)

Vérifications des droits pour l’utilisateur

Initialisation de la bibliothèque BWC pour la connexion à BroadWorks

GetUserProfile &JwT journalisation de la récupération des jetons

Journal de l’application BroadWorks appelant Webex

Client

Windows : \Users\{username}\AppData\Local\CiscoSpark\bwc\current_log.txt

Mac :

/Users/{username}/Library/Logs/SparkMacDesktop/bwc/current_log

Mobile : Utiliser Envoyer les journaux

Tout le trafic SIP pour les inscriptions et les appels

Conserver le trafic alive vers le backend BWKS

Fonctions d’appel mi nécessitant une signalisation (Attente/Reprise, Transfert, etc.)

Journal des médias (Moteur Média Webex)

Client

Windows :

\Users\{username}\AppData\Local\CiscoSpark\media\*.log

Mac :

/Users/{username}/Library/Logs/SparkMacDesktop/media/

Mobile : Utiliser Envoyer les journaux

Journalisation de tous les médias

Codecs négociés pour un appel

Fonctionnalités d’appel mi-appels

Lecture de la liste

Water Mark
19 mars 2021| vue(s) | personnes ont trouvé ceci utile

Processus

Webex pour les processus de dépannage BroadWorks

Escalade d’un problème

Après avoir suivi quelques conseils de dépannage, vous devriez avoir une idée raisonnable de l’endroit où le problème est racine.

1

Collectez le plus d’informations possible à partir des systèmes liés au problème

2

Contactez l’équipe appropriée à Cisco pour ouvrir un cas (voir la section Contacts)

Quelles sont les informations du client à collecter

Si vous pensez avoir besoin d’ouvrir un cas ou de faire escalader un problème, collectez les informations suivantes lors du dépannage avec l’utilisateur :

  • Identificateur de l’utilisateur : Adresse électronique CI ou UUID utilisateur (ceci est l’identificateur Webex, mais si vous obtenez également l’identificateur BroadWorks de l’utilisateur, ce qui vous aidera)

  • Identificateur de l’organisation

  • Période approximative pendant laquelle le problème a été expérimenté

  • Plateforme client et version

  • Envoyer ou collecter des journaux du client

  • Enregistrer l’ID de suivi s’il est affiché sur le client

Vérifier les détails de l’utilisateur dans le bureau d’aide

1

Connectez-vous à https://admin.webex.com/helpdesk.

2

Recherchez et cliquez sur l’utilisateur. Ceci ouvre l’écran de synthèse de l’utilisateur.

3

Cliquez sur le nom d’utilisateur pour voir la configuration détaillée de l’utilisateur.

Les informations utiles dans cette vue incluent le cluster UUID, l’identité commune (IC) de l’utilisateur, le cluster de l’application Webex, le comportement d’appel, le GUID du compte BroadWorks.

4

Cliquez sur Copier si vous devez utiliser ces informations dans un autre outil, ou joignez-les à un cas Cisco.

Afficher l’organisation du client dans le bureau d’assistance

1

Connectez-vous à https://admin.webex.com/helpdesk.

2

Recherchez et cliquez sur le nom de l’organisation du client.

3

Faites défiler jusqu’à ce que vous lisez Affichage du portail du client et cliquez sur Afficher le nom du client pour afficher un affichage en lecture seule de l’organisation du client – y compris les utilisateurs et la configuration.

Récupérer les journaux des utilisateurs à partir de Partner Hub

Lors du dépannage des problèmes de bureau et du client mobile, il est important pour les partenaires (et le CAT) d’afficher les journaux du client.

1

Demandez à l’utilisateur d’envoyer les journaux.

2

Demandez à l’utilisateur d’exporter l’environnement d’appel pour vous envoyer le fichier ced.dat.

3

Obtenez les journaux du client à partir du Hub du partenaire ou du bureau d’aide (voir ci-dessous).

Option Hub partenaire :

  1. Connectez-vous au Hub partenaire et recherchez l’organisation du client de l’utilisateur.

  2. Sélectionnez Dépannage.

  3. Sélectionnez Journaux.

  4. Rechercher l’utilisateur (par courrier électronique).

  5. Afficher et télécharger les journaux du client sous la tant que fichier zip.

Option du bureau d’aide :

  1. Connectez-vous au bureau d’aide.

  2. Rechercher l’organisation.

  3. Cliquez sur l’organisation (ouvre l’écran de synthèse).

  4. Faites défiler vers le bas pour cliquer sur Afficher le client .

  5. Sélectionnez Dépannage.

  6. Sélectionnez Journaux.

  7. Rechercher l’utilisateur (par courrier électronique).

  8. Afficher et télécharger les journaux du client sous la tant que fichier zip.

Comment trouver la version du client

1

Partager ce lien avec l’utilisateur : https://help.webex.com/njpf8r5.

2

Demandez à l’utilisateur de vous envoyer le numéro de version.

Vérification du client pour le service d’appel

1

Connectez-vous au client Webex.

2

Vérifiez que l’icône des Options d’appel (un combiné avec un engrenage au dessus) se trouve sur la barre latérale.

Si l’icône n’est pas présente, l’utilisateur n’est peut-être pas encore activé pour le service d’appel dans Control Hub.

3

Ouvrez le menu Paramètres/Préférences et allez à la section Services téléphoniques. Vous devriez voir le statut Session SSO Vous êtes inscrit(0).

(Si un autre service téléphonique, tel que Webex Calling, est affiché, l’utilisateur n’utilise pas Webex pour BroadWorks.)

Cette vérification signifie :

  • Le client a réussi la traversée des microservices Webex requis.
  • L’utilisateur s’est authentifié avec succès.
  • Votre système BroadWorks a émis un jeton Web JSON depuis longtemps.
  • Le client a récupéré le profil de son périphérique et s’est inscrit dans BroadWorks.

Obtenir les journaux du client ou les commentaires

  • Consultez la section Ressources pour trouver des journaux de clients spécifiques sur les clients de bureau Webex, ou demandez aux utilisateurs d’envoyer les journaux.

  • Demandez aux utilisateurs de clients mobiles d’envoyer les journaux, puis vous pouvez les obtenir via le concentrateur partenaire ou le bureau d’aide.


Envoyer les journaux est silencieux. Cependant, si un utilisateur envoie un commentaire, il va à l’équipe devops de l’application Cisco Webex. Assurez-vous d’enregistrer le numéro de commentaires de l’utilisateur si vous souhaitez en assurer le suivi avec Cisco. Par exemple :

Obtenir les données de l’environnement d’appel

Les journaux du client Webex sont fortement ressurables pour supprimer des informations personnellement identifiables. Vous devez exporter les données d’environnement d’appel à partir du client dans la même session que vous remarquez le problème.

1

Dans le client, cliquez sur l’image de profil, puis cliquez sur Aide > Exporter les données d’environnement d’appel.

2

Enregistrez le fichier ced.dat pour résoudre les problèmes d’appel de cet utilisateur.

Important : Se déconnecter ou redémarrer le client effacera le cache interne. Si vous exportez ced.dat après cela, les données exportées ne correspondront à aucun journal qui a été envoyé avant le cache.

Réinitialiser la base de données Webex

1

Sur le client cliquez sur Aide > Contrôle d’état.

2

Sélectionnez Réinitialiser la base dedonnées .

Ceci déclenche une réinitialisation complète du client et charge l’écran de connexion de l’application Webex.

Vérifier que Webex doit s’inscrire dans BroadWorks

L’application Webex vérifie les informations suivantes pour déterminer si elle doit s’inscrire à BroadWorks :

  • Droit de l’utilisateur à broadworks-connector

  • Comportement d’appel pour l’organisation et l’utilisateur

Vérifier le comportement d’appel d’un utilisateur et l’accès au connecteur

  1. Connectez-vous au Bureau d’aide (https://admin.webex.com/helpdesk) avec vos identifiants d’administrateur partenaire.

  2. Rechercher l’utilisateur.

  3. Cliquez sur l’utilisateur et vérifiez l’entrée Comportement d’appel. Cela devrait être « Appel dans Webex ».

  4. Cliquez sur le nom d’utilisateur pour ouvrir l’écran Détails de l’utilisateur.

  5. Faites défiler pour trouver la section des droits et vérifiez quebroadworks-connector est inclus.


    Un utilisateur de Webex pour BroadWorks ne doit PAS avoir le droit bc-sp-standard s’il prévoit d’utiliser Webex pour BroadWorks. Ceci est le droit pour « Webex Calling (BroadCloud) » qui est l’appel de l’application Webex via un service d’appel géré par Cisco sur le Cloud.

Vérifier le comportement d’appel de l’organisation

  1. Connectez-vous au Bureau d’aide (https://admin.webex.com/helpdesk) avec vos identifiants d’administrateur partenaire.

  2. Rechercher l’organisation.

  3. Cliquez sur l’organisation et vérifiez l’entrée Comportement d’appel. Cela devrait être « Appel dans Webex ».

AnalyseZ PSLog pour les problèmes de provisioning des utilisateurs

Utilisez le PSLog du serveur d’applications pour voir la requête HTTP POST vers le pont de provisioning et la réponse de Webex.

Dans un cas de travail correct, la réponse est 200 OK et après quelques minutes vous pouvez voir l’utilisateur - et le nouvel organisme du client s’il s’agit du premier utilisateur – a été créé dans Webex.

Vous pouvez vérifier ceci en recherchant le Bureau d’aide pour trouver l’adresse électronique que vous voyez dans le POST.

Avant de commencer

Collectez un PSLog du serveur d’application au cours d’une tentative de provisioning de flux avec un utilisateur test.

1

La première chose à vérifier est le code de réponse HTTP :

  • Tout ce qui est autre que 200 OK est un échec de provisioning des utilisateurs.

  • 200 OK peut toujours indiquer un échec si quelque chose concernant le profil de l’abonné ne fonctionne pas dans la partie en haut des services Webex du pont de provisioning.

  • 400 peuvent contenir un nœud de message dans la réponse. Le pont de provisioning n’a pas pu traiter quelque chose dans l’abonnéProfile. Il peut y avoir un problème avec les détails de l’abonné, ou l’incompatibilité avec un paramètre dans le modèle.

  • 401 signifie que les identifiants de provisioning entrés sur l’AS ne correspondent pas à ceux entrés dans le modèle dans le Hub partenaire.

  • 403 peut indiquer un erreur de configuration sur le serveur d’applications. Vérifiez la cible de la demande. ne doit pas être une adresse IP, il doit s’agit de l’URL du pont de provisioning que vous pouvez voir sur votre modèle dans partner hub.

  • 409 indique un conflit entre l’abonné fourniProfile et les données Webex existantes. Il peut y avoir un utilisateur existant avec cette adresse électronique. Vérifiez le message dans la réponse.

2

Vous pouvez également vérifier le POST HTTP d’origine pour trouver les valeurs suspectes qui pourraient causer l’échec du provisioning.

Le POST contient une structure subscriberProfile XML. À l’intérieur, les nodes utiles à vérifier sont :

  • bwuserid: Utilisez ceci pour trouver le profil de l’abonné si vous devez le modifier dans BroadWorks.

  • groupe: Si le modèle est en « mode Fournisseur de service », il est inférieur et devient le nom de l’organisation Client que vous voyez dans le Hub partenaire.

  • Fournisseur de service: Si le modèle est en « mode Entreprise », il est en bas de page et devient le nom de l’organisation Client que vous voyez dans le Hub partenaire.

  • Numéro de téléphone principal: Doit exister. Le provisioning échoue sans .

  • courrierélectronique : Devient l’ID utilisateur dans Webex. Doit être valide et unique pour Webex, sinon le provisioning échoue.


 

Ignorer les services qu’il vous a été dit : il est créé par AS et accepté mais non utilisé par Webex.

Analysez les journaux XSP pour dépanner la connexion de l’abonné

Ce flux décrit le mode d’authentification BroadWorks. Vous pouvez voir le mode d’authentification sur le modèle BroadWorks, dans Partner Hub. Voir Configurer vos modèles clients danshttps://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

Le diagramme en échelle suivant montre l’interaction entre l’utilisateur, le client, les services Webex et le système BroadWorks, lorsque l’utilisateur fait l’authentification BroadWorks dans l’application Webex. De plus, la connexion entre Webex et le XSP est sécurisée par MTLS.

La discussion qui suit explique ce que vous pouvez voir lorsque vous enquêtez sur les journaux pour une connexion réussie.

Figure 1. Authentification BroadWorks et configuration du périphérique

L’utilisateur interagit avec le client, le client interagit avec les services Webex :

  • L’utilisateur fournit son adresse électronique à l’application Webex (1 en diagramme).

  • CI sait qu’il doit rediriger cet utilisateur pour saisir son mot de passe BroadWorks (via UAP) (2 dans le diagramme).

  • Le proxy IDP envoie une demande de profil à l’interface Xsi sur le XSP.

Dans la access_log :

  • Recherchez la demande GET pour le profil de l’abonné, de Webex vers l’interface Xsi-Actions (2.1 avec diagramme). Il a l’ID utilisateur Webex. P. ex.

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

Dans le XsiActionsLog :

  • Recherchez la demande get profil de Webex (2.1 dans le diagramme). Il a l’ID utilisateur Webex. P. ex.

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

    Les en-têtes incluent l’autorisation : Agent de base et utilisateur : broadworksÉteamsClient

  • Le XSP fait ensuite l’authentification de base OCI-P contre BroadWorks (AuthenticationVerifyRequest et AuthenticationVerifyResponse, comme toute autre application authentification de base via Xsi) et également un UserGetRequest et ServiceProviderGetRequest pour collecter les informations de l’abonné.

  • La réponse Xsi à Webex contient un bloc de profil XML contenant l’userId (BroadWorks) et d’autres détails (2.2 dans le diagramme).

Interactions avec les clients et les services Webex :

  • Le proxy IDP correspond au profil utilisateur reçu de BroadWorks et rencontre des problèmes avec l’assertion SAML au client (2.3 dans le diagramme)

  • Les clients échangent l’assertion SAML pour un jeton CI (3 en diagramme)

  • Le client vérifie que l’utilisateur connecté a le droit broadworks-connector (4 dans le diagramme). Vous pouvez vérifier les droits des utilisateurs dans le Bureau d’aide)

  • Le client utilise le jeton CI pour demander un jeton Web JSON (JWT) sur le proxy IDP (5 dans le diagramme)

  • Le proxy IDP valide le jeton CI à IC

  • Le proxy IDP demande JWT du service d’authentification

Dans le journal authentificationService :

  • Recherchez la demande de jeton de Webex (5.2 dans le diagramme), par exemple :

    OBTENIR /authService/jeton

    qui a http_bw_userid en-tête et autres personnes.

  • Le XSP fait OCI-P UserGetLoginInfoRequest , pour valider que l’id utilisateur fourni correspond à un utilisateur de BroadWorks (5.3 dans le diagramme). AuthService a établi un confiance avec Webex en vertu de la connexion mTLS, il en sera de même pour le LLT.

  • Recherchez la réponse (5.4 dans le diagramme) de LongLivedTokenManager - Généré par le jeton, objet : bwksUserId@example.com, émetteur : BroadWorks...

    et StatusCode=200 que vous pouvez associer à la demande initiale en utilisant le trackingid : CLIENT... En-tête.

Dans le XsiActionsLog :

  • Le client est maintenant en mesure de présenter le jeton long-vers l’interface Xsi-Actions pour obtenir le profil de son périphérique (6 dans le diagramme). P. ex.:

    OBTENIR /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device

    Avec l’autorisation des en-têtes : Jeton d’ours et agent utilisateur : WebexTeams(variante/version)

  • L’interface Xsi-Actions posait le jeton sur le service authservice (configuré pour se trouver sur l’interface de boucle), par exemple : 127.0.0.1:80 POST http://127.0.0.1:80/authService/token

    que vous pouvez corréler avec le trackingid : CLIENT... en-tête dans le GET et leX-BROADSOFT-CORRELATION-ID : CLIENT... en-tête dans le POST .

Dans le journal authentificationService :

  • La réception du POST de Xsi (boucle)

  • Un Code de statut=200 retour à Xsi

  • Et une réponse de validation de jeton, avoir un bloc « jeton » JSON dans le corps.

  • Lié(s) en utilisant l’id de suivi : Client...

Dans le XsiActionsLog :

  • Après avoir reçu 200 OK d’authservice, qui validait le jeton du client, l’application Xsi-Actions envoie maintenant une demande OCI-P pour UserPrimaryAndSCADeviceGetListRequest

  • Reçoit la réponse OCI-P UserPrimaryAndSCADeviceGetListResponse contenant lastructure accessDeviceTable XML.

  • La réponse OCI-P est encodée en tant que réponse Xsi au client, incluant la structure AccessDevices XML, qui a le périphériqueTypes par exemple Business Communicator – PC et les URL où le client peut récupérer les fichiers de configuration du périphérique.

Le client continue normalement :

  • Sélectionne une entrée de périphérique et interagit avec DMS pour obtenir le profil du périphérique (6 en diagramme)

  • S’enregistre dans BroadWorks via SBC récupéré dans la configuration à partir de DMS (7 dans le diagramme)

Water Mark
19 mars 2021| vue(s) | personnes ont trouvé ceci utile

Problèmes spécifiques

Dépannage de problèmes spécifiques avec Webex pour BroadWorks

Problèmes avec le hub partenaire

L’administrateur ne peut pas voir les organisations des clients

En tant qu’administrateur de votre organisation partenaire dans Webex, vous devez avoir le rôle d’administrateur complet. Ce rôle est utilisé pour gérer votre organisation partenaire, incluant l’attribution des privilèges administratifs à vous-même et aux autres personnes. Pour gérer les organisations des clients, vous devez vous octroyer (ou octroyer à d’autres personnes) le rôle d’administrateur des ventes complet ou le rôle d’administrateur des ventes. Voir .https://help.webex.com/fs78p5

Problèmes de provisioning de l’utilisateur

Erreurs MI&P intégrées pour des entreprises/clients spécifiques

Si vous avez un ensemble d’entreprises utilisant différents services de collaboration sur le Cloud, par exemple UC-One SaaS et Webex pour BroadWorks, vous avez peut-être opté pour la modification de l’adaptateur de provisioning par entreprise.

Pour vérifier ce qui est configuré pour la MI intégrée & P (par défaut pour les entreprises, à moins qu’un paramètre plus spécifique n’existe), exécutez AS_CLI/Interface/Messagerie> obtenir. Pour les paramètres de provisioning d’une entreprise spécifique, ouvrez l’entreprise et allez dans Services > MI intégrée &P.

Vérifiez que la configuration IM&P intégrée pour cette entreprise correspond exactement à ce qui est affiché dans le modèle client dans partner hub. Les paramètres suivants doivent correspondre, ou le provisioning échoue pour tous les utilisateurs de l’entreprise :

Paramètre BroadWorks Enterprise INTEGRATED IM&P

Paramètre du modèle du client Partner Hub

URL du serveur de messagerie

Provisioning URL

Nom d’utilisateur du serveur de messagerie

Nom du compte de provisioning

Mot de passe du serveur de messagerie

Mot de passe du compte de provisioning, confirmer le mot de passe

Erreurs MI&P intégrées pour des utilisateurs spécifiques

Ceci s’applique si vous utilisez le provisioning par branchement et suppose que le provisioning fonctionne pour certains/la plupart des utilisateurs (pour vous aider à exclure un problème de configuration).

Si vous voyez des erreurs de messagerie instantanée intégrée &P dans BroadWorks, par exemple, « [Erreur 18215] Erreur de provisioning avec le serveur de messagerie » et « [Erreur de communication 18211] avec le serveur de messagerie », vous devez rechercher les causes potentielles suivantes :

  • L’adresse électronique de l’utilisateur pourrait déjà exister l’IC. Recherchez les utilisateurs dans le bureau d’aide pour vérifier si leur adresse électronique est déjà là. Ceci n’est pas nécessairement une permission, car l’utilisateur existe peut-être dans une organisation dont vous n’êtes pas autorisé à voir les données dans le bureau d’aide.

  • L’utilisateur s’est inscrit indépendamment à Webex, avant d’être affecté au service intégré MI&P. Dans ce cas, l’une des options consiste à ce que l’utilisateur supprime son compte gratuit pour qu’il puisse faire partie de l’organisation du client que vous provisionniez. Les instructions se font sur https://help.webex.com/5m4i4y.

  • Les utilisateurs n’ont pas de numéro de téléphone principal attribué à leur profil (tous les abonnés de Webex pour BroadWorks doivent avoir un DID principal). Voir le sujet sur l’analyse PSLog à partir de AS.

Échecs de l’approvisionnement des utilisateurs en réponse à partir du pont de provisioning

Si les utilisateurs ne s’affichent pas dans Control Hub, quelques minutes après l’attribution de la MI&P intégrée, ont accès aux codes de réponse du service de passerelle de provisioning. Exécutez un PSLog pour consulter les codes de réponse HTTP.

200 OK

Une réponse 200 OK ne signifie pas que l’utilisateur a été provisionné avec succès. Le service d’approvisionnement a reçu la demande et a réussi à soumettre la demande de création de l’utilisateur correspondante aux services en cours d’approvisionnement.

La transaction d’approvisionnement est asynchrone de par sa conception. Le service répond 200 OK car le processus de création de l’utilisateur peut prendre plusieurs minutes et, pour des raisons de performance, nous ne souhaitons pas recevoir plusieurs demandes pour créer le même utilisateur.

Cependant, si l’utilisateur ne s’affiche plus dans l’organisation du client après une réponse de 200 OK, il peut indiquer que la création de l’utilisateur a échoué dans la partie en cours des services Webex en cours de mise en service du service de provisioning.

Vous devez escalader une erreur de provisioning qui a une réponse 200 OK.

Mauvaise demande 400

Consultez la réponse HTTP qui devrait avoir plus de détails sur les problèmes potentiels qui pourraient causer cette réponse du service de provisioning. Quelques exemples de <message> nœuds :

  • « Nous ne pouvons pas faire confiance à BroadWorks email avec l’API de provisioning héritée. »

    L’adresse électronique associée à la demande de provisioning de l’utilisateur non valide n’est pas valide, ou est mal type, mais vous avez omis dans le modèle que les adresses électroniques peuvent être digne de confiance. Vérifiez les profils des utilisateurs dans BroadWorks, en particulier l’id de messagerie électronique.

  • « L’organisation du client n’est pas trouvée dans la base de données et le drapeau de création d’une nouvelle organisation n’est également pas activé. »

    Cette demande de provisioning qui a échoué doit créer une nouvelle organisation client dans Webex, mais votre modèle est configuré pour empêcher la création de nouvelles organisations des clients. Si vous souhaitez autoriser de nouvelles organisations, pour les domaines de messagerie électronique qui ne correspondent pas à ceux des clients existants dans Webex, alors vous pouvez reconfigurer votre modèle dans Partner Hub et retester la demande de provisioning. Cependant, si vous ne vous attendez pas à ce qu’une nouvelle organisation soit créée pour cet utilisateur, peut-être que l’adresse électronique est mal type (en particulier la partie du domaine). Vérifiez l’id de l’utilisateur dans BroadWorks.

403 Interdit

La demande de provisioning n’a aucune chance de réussir. Vous devrez enquêter sur la demande et la réponse dans ce cas. Par exemple, si vous voyez une adresse IP comme cible de la demande de provisioning – au lieu de l’URL appropriée du pont de provisioning pour votre organisation (voir les sujets de configuration du pare-feu dans le Guide de solution) – il est possible que votre serveur d’applications ne manque pas un correctif requis (ap373197).

Vérifiez que tous les patchs requis sont appliqués au serveur d’applications et que vous avez terminé la configuration connexe pour un approvisionnement réussi.

Conflit 409

La demande de provisioning ne peut pas continuer car il y a un utilisateur existant dans Webex qui correspond à l’adresse électronique dans la demande.

Utilisateur déjà dans IC

Obtenez l’adresse électronique de l’abonné à partir de la demande HTTP POST et recherchez-le dans le bureau d’aide.

Vous ne pouvez pas voir l’utilisateur si vous n’avez pas l’autorisation, mais vous pouvez également voir que l’utilisateur est dans une organisation « gratuite », par exemple « Consommateur ».

Vous pouvez demander à cet utilisateur de supprimer son compte gratuit, ou vous pouvez utiliser une adresse électronique différente pour les provisioner. Voir .https://help.webex.com/ndta402

Problèmes de connect des utilisateurs

Le portail d’activation de l’utilisateur ne se charge pas

La procédure normale de signature de Webex pour BroadWorks inclut un portail d’activation des utilisateurs où les utilisateurs saisissent leurs mots de passe. Ce portail ne se charge parfois pas après que l’utilisateur ait fourni son adresse électronique dans l’écran de se connectant à l’application Webex.

Ce problème peut être causé du côté du client ou du côté du service. Du côté du client, cela est généralement dû au fait que le navigateur natif du client est incompatible d’une manière ou d’une autre avec le service.

Échec de l' sign-on unique

  • Dans BroadWorks, vérifiez que les types de périphériques ont été attribués à l’utilisateur pour l’application Webex (voir la section Profils des périphériques dans la section Préparer votre environnement du Guide de solution).

  • Vérifiez que l’utilisateur utilise le mot de passe correct : Si le modèle que vous avez utilisé pour provisioniser l’organisation cliente de l’utilisateur (dans le Partner Hub) est configuré pour l’authentification BroadWorks, l’utilisateur doit saisir son mot de passe BroadWorks « Web Access ».

Problèmes de configuration et d’inscription des appels

Après qu’un utilisateur ait été intégré dans Webex et qu’il s’est bien connecté à l’application Webex, l’application s’enregistre dans BroadWorks. Voici la séquence d’inscription attendue et les signes qui en résultent d’une inscription bonne (tel que observé dans l’application Webex) :

Séquence d’inscription attendue

  1. Le client appelle XSI pour obtenir un jeton de gestion de périphérique et l’URL vers le DMS

  2. Le client demande le profil de son périphérique à partir de DMS en présentant le jeton à partir de l’étape 1

  3. Le client lit le profil du périphérique et récupère les identifiants, les adresses et les ports SIP

  4. Le client envoie un SIP REGISTER à SBC en utilisant les informations de l’étape 3

  5. SBC envoie le SIP REGISTER au AS (SBC peut effectuer une recherche dans le NS pour localiser un AS si SBC ne sait pas déjà l’utilisateur SIP.)

Signes attendus d’une inscription réussie au client

L’icône Options d’appel s’affiche dans l’interface Webex.

Dans l’onglet Services téléphoniques de l’application Webex (par exemple Paramètres > Services téléphoniques sous Windows, Préférences > Services téléphoniques sur Mac), le message « Session SSO : Vous êtes inscrit(e) » signifie que l’application a été enregistrée avec succès (à BroadWorks dans ce cas).

Le client n’a pas d’icône d’appel

La plupart du temps ceci signifie que l’utilisateur n’a pas les licences/autorisations correctes.

Le client affiche l’onglet Services téléphoniques mais aucune session SSO

L’inscription a échoué. Il existe plusieurs raisons pour lesquelles l’enregistrement d’un client de l’application Webex échouerait avec BroadWorks :

Plusieurs services d’appel testés avec les mêmes clients

Ce problème connu peut être causé par le changement du client entre les différentes extrémités de retour d’appel. Il est probablement produit au cours des essais de différents services d’appel offerts via (le même) clients de l’application Webex. Vous pouvez réinitialiser la base de données du client (lien) pour remédier à ce problème.

Mauvaise configuration du service d’authentification

Cochez la/les XSP(s) hébergeant le service d’authentification par rapport au Guide de solution (voir Configurer les services sur votre site Webex pour les XSP BroadWorks). Spécifiquement :

  • Les clés RSA (que vous générez sur un XSP) sont copiées sur tous les XSP

  • L’URL du service d’authentification a été fournie au conteneur Web sur tous les XSP et correctement entrée dans le cluster dans Partner Hub

  • L’authentification externe par certificat est configurée :

    XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get 
     
     allowUserApp = 
     false allowClientApp = true (vrai)
  • Lorsque vous utilisez MTLS, vous devez télécharger le certificat du client Webex sur les XSP (vous pouvez obtenir le certificat à partir de Partner Hub, sur la page paramètres BroadWorks)

Mauvaise configuration des balises BroadWorks

Vérifiez que vous avez configuré les balises BroadWorks requises pour l’application Webex (voir la section Balises BroadWorks requises pour Webex dans le Guide de solution) et qu’il n’y a aucun conflit ou valeurs incorrectes.

Plus précisément, la balise %SBC_ADDRESS_WXT% doit être le SBC pour votre inscription SIP pour les clients de l’application Webex.

Le client de bureau déconnecte les services téléphoniques après une connexion SSO réussie

Ce problème peut être causé par le même utilisateur qui se est créé un compte sur plusieurs clients sur le même type de plateforme. Par exemple, si un utilisateur réussissent à se momenter dans l’application Webex sous Windows, puis se trouve dans l’application Webex sur une autre machine Windows, il n’y a qu’une session SSO active sur l’une des machines. Ceci est voulu.

Si vous devez absolument contourner ce problème, vous pouvez configurer BroadWorks pour avoir plusieurs instances du même type de périphérique, mais elles doivent avoir des adresses SIP uniques. Cette configuration ne fait pas partie de la portée de Webex pour BroadWorks.

Le périphérique de bureau n’est pas provisionné pour l’utilisateur

Cette signature est visible dans le journal du client (\bwc\) :

<Error> [0x70000476b000] BroadWorksConfigDownloader.cpp:106 onAccessDeviceListSucceeded:BWC:SCF : ConfigDownload - le profil du périphérique « Business Communicator - PC » non trouvé.

Problèmes de la vue Web des paramètres d’appel

Bouton Self Care/Le lien ne s’affiche pas dans l’application Webex

Un symptôme différent de ce problème est lorsque le bouton/lien est affiché, mais cliquer dessus ouvre un navigateur externe.

  • Vérifiez que le modèle de configuration client requis est déployé et que les balises CSW sont correctement définies. (Voir la Section Paramètres d’appel Webview dans le Guide de la solutionWebex pour BroadWorks).

  • Vérifiez que l’application Webex est enregistrée pour l’appel dans BroadWorks.

  • Vérifiez que l’application Webex est une version récente qui prend en charge CSWV.

Page blanche ou erreur après avoir cliqué sur bouton/lien Self Care

Généralement, ce comportement dans l’application Webex indique un problème de configuration ou de déploiement avec l’application CSWV sur BroadWorks XSP.

Collectez des détails pour plus d’investigation, incluant les journaux CSWV, les journaux d’accès, le répertoire config-wxt.xml et le fichier du modèle, puis déposez un cas.

Codes d’erreur de l’utilisateur final

Le tableau suivant décrit les codes d’erreur de l’utilisateur final qui peuvent être vus dans le portail d’activation des utilisateurs du client.


Ceci n’est pas une liste exhaustive de codes d’erreur. Le tableau liste uniquement les codes d’erreur existants pour lesquels l’application Webex n’indique actuellement pas de direction claire à l’utilisateur.
Tableau 1. Codes d’erreur de l’utilisateur final

Code d'erreur

Message d'erreur

200010

Échec de la validation des identifiants en tant qu’utilisateur non autorisé de broadworks

200018

Échec de la validation des identifiants car l’utilisateur est bloqué

200019

Échec de la validation des identifiants en tant qu’ajout d’utilisateur lors de l’activation automatique

200022

Échec de l’envoi du courrier électronique en tant qu’utilisateur non authentifié

200026

Échec de la validation de l’adresse électronique en raison d’une erreur de pré-vérification ou d’un état incorrect de l’utilisateur pour PartnerOrgUUID : {partnerOrgUUID} , BroadoworksUUID : {broadworksUUID} , ConfigSetUUID : {configSetUUID}

200039

Échec de la validation de l’adresse électronique en tant qu’emailId déjà utilisé dans une autre organisation

200040

Échec de la validation de l’adresse électronique en tant que configSet ne correspond pas à configConfig dans le client

200041

Échec de la validation de l’adresse électronique car l’utilisateur a déjà droit à un autre service en conflit, droits conflictuelles

200042

Échec de la validation de l’adresse électronique car l’adresse électronique est déjà associée à un autre broadworks UserId

200043

Échec de la validation de l’adresse électronique car le mappage de la config client de l’utilisateur est incorrect

200044

Échec de la validation de l’adresse électronique en tant qu’utilisateurId est déjà en cours d’utilisation sur ce cluster broadworks

200045

Échec de l’ajout de l’utilisateur via l’activation automatique car l’utilisateur fait déjà partie d’une autre organisation

200046

Échec de l’ajout de l’utilisateur via l’activation automatique en tant que plusieurs utilisateurs en attente existe avec la même broadworksUserId sous le même cluster de broadworks

200047

Échec de l’ajout de l’utilisateur via l’activation automatique en tant qu’utilisateurId est déjà en cours d’utilisation sur ce cluster broadworks

200048

Échec de l’ajout de l’utilisateur via l’activation automatique car l’adresse électronique a déjà été provisionée avec un autre BroadWorks userId

200049

Échec de l’ajout de l’utilisateur via l’activation automatique en tant qu’utilisateurId est déjà en cours d’utilisation sur ce cluster broadworks

200050

Échec de l’ajout de l’utilisateur via l’activation automatique en tant que provisioningID ne correspond pas à l’id de provisioning attendu de l’entreprise de l’abonné

200051

Échec de l’ajout de l’utilisateur via l’activation automatique en tant que spEnterpriseId spécifié dans cette demande est en conflit avec un fournisseur de service ou une entreprise déjà provisionnée à partir de ce cluster BroadWorks

Cet article était-il utile ?

Articles connexes

Vu(s) récemment

×