Dépannage de problèmes spécifiques avec Webex for 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 existe), exécutez AS_CLI/Interface/Messaging> get. 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 pouvoir 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 Bureau d'assistance 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 Bureau d'assistance.

  • 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 un coup d'œil sur les codes de réponse du service de passerelle d'approvisionnement. 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 de provisioning 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 de provisioning 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 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œud:

  • « 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 aux 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) – elle peut indiquer que votre serveur d'applications a 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-la dans Bureau d'assistance.

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 « Web Access » BroadWorks.

Problèmes de configuration et d'inscription d'appel

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 (comme 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 vers l'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 SSO Session : 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.

Client affiche l'onglet Services téléphoniques mais aucune SSO session

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
  • 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 SSO connexion 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 se signe avec succès à l'application Webex sous Windows, puis se trouve dans l'application Webex sur une autre machine Windows, il n'y a qu'une session de 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 du cadre 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 - the device profile 'Business Communicator - PC' is not found.

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 une analyse plus approfondie, 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 en attente 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, avec des 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 par l'activation automatique en tant que plusieurs utilisateurs en attente existent 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 une Prestataire de service ou Enterprise déjà provisionnée à partir de ce cluster BroadWorks