URL de connexion au service de substitution de poste (EM) et EMCC (Extension Mobility Cross Cluster) CUCM 12.X

Introduction

Ce document décrit le nouveau service Uniform Resource Locator(URL) dans Cisco Unified Communication Manager(CUCM) 12.X.

Conditions préalables

Cisco Extension Mobility permet aux utilisateurs d'accéder temporairement à la configuration de leur téléphone IP Cisco Unified, par exemple à l'affichage des lignes, aux services et aux numéros abrégés à partir d'autres téléphones IP Cisco Unified. Extension Mobility prend en charge les téléphones IP Cisco Unified qui exécutent SCCP et SIP.

La fonctionnalité Extension Mobility s'étend sur la plupart des téléphones IP Cisco Unified. Vous pouvez configurer chaque téléphone IP Cisco Unified afin de prendre en charge Cisco Extension Mobility dans la fenêtre Default Device Profile de Cisco Unified Communications Manager Administration. Cela permet aux utilisateurs qui n'ont pas de profil de périphérique utilisateur pour un téléphone IP Cisco Unified particulier d'utiliser Cisco Extension Mobility avec ce téléphone.

Conditions requises

 Cette fonctionnalité a été introduite dans CUCM 12.X.

Components Used

 Version CUCM : 12.0.0.99834-5

 Modèle de téléphone - 88XX

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Configuration

Diagramme du réseau

Configurations

Configuration de l'URL du service de mobilité des numéros de poste (EM) :

Vous connaissez la configuration de l'URL de mobilité de poste pour la connexion normale à « ID utilisateur ».

URL de connexion EM normale :

http:// <ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#

En fonction des paramètres de l'URL du service téléphonique, l'application Extension Mobility sert différents types de page de connexion pour l'utilisateur final.

La connexion EM est désormais disponible en trois types différents :

1. ID utilisateur
2. DN principal
3. ID utilisateur libre-service

Ce tableau vous aide à identifier les différents types de connexion :

1. ID utilisateur (UID) :

Il s'agit de l'URL de service qui permet à l'utilisateur de se connecter avec son ID utilisateur.

Ici, UID est le type de connexion.

http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=UID

Naviguez jusqu’à Device > Device Setting > Phone Services > Add New

Affichage sur le téléphone réel :

 2. DN principal

Vous devez d'abord comprendre ce que signifie le DN principal.

Ainsi, sur la page de configuration de l'utilisateur final, vous avez l'option de définir le DN principal.

Si vous ne définissez pas le DN principal de l'utilisateur et que vous tentez de vous connecter, vous recevez un échec avec cette erreur :

Error code : 23
Error message on phone: Login is unavailable(23) / Logout is unavailable(23

Se produit lorsque l'ID utilisateur (UID)/SP (Self-Service User ID) ou DN (Primary Extension) saisi est introuvable dans la base de données

Il s'agit de l'URL du service permettant aux utilisateurs de se connecter avec leur nom de domaine principal.

http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=DN

Naviguez jusqu’à Device > Device Setting > Phone Services > Add New

Affichage sur le téléphone réel :

3.ID utilisateur libre-service

Il s'agit de l'ID utilisé pour gérer le portail Self Care.

Si elle n'est pas configurée sur la page de l'utilisateur final, vous n'êtes pas autorisé à vous connecter à cette URL de service et affiche cette erreur :

Error code : 23
Error message on phone: Login is unavailable(23) / Logout is unavailable(23)

• Se produit lorsque l'ID utilisateur (UID)/SP (Self-Service User ID) ou DN (Primary Extension) saisi est introuvable dans la base de données

URL de service pour l'ID utilisateur libre-service :

http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=SP

Naviguez jusqu’à Device > Device Setting > Phone Services > Add New

Affichage sur le téléphone réel :

Configuration de l'URL du service de cluster croisé de la mobilité des numéros de poste (EMCC) :

Comme l'URL de service EM, nous avons également trois types de connexion EMCC. Voici l'URL du service pour les types de connexion respectifs.

• ID utilisateur : URL de service pour la connexion à EMCC.

  http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=UID

• DN principal :

  http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=DN

• ID utilisateur libre-service :

  http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=SP

Codes d'erreur pour EMCC :

Codes d'erreur courants pour les problèmes de connexion EMCC :

• « Error Code: 47
  Message d'erreur sur le téléphone : Le DN a plusieurs utilisateurs(47)
  
  Se produit lors de la connexion EMCC lorsque le poste (poste principal sous la page de configuration de l'utilisateur final) utilisé pour la connexion est affecté à plusieurs utilisateurs
• « Error Code: 1
  Message D'Erreur Sur Le Téléphone : Connexion indisponible(1) / Déconnexion indisponible(1)
  
  Se produit lorsque le service EM n'a pas pu analyser la demande XML d'EMApp/EMservice ou en raison d'une incompatibilité dans les versions entre les versions d'accueil et celles de CUCM visitées.
• « Error Code: 23
  Message d'erreur sur le téléphone : Connexion indisponible(23) / Déconnexion indisponible(23)
  
  Se produit lorsque l'ID utilisateur (UID)/SP (Self-Service User ID) ou DN (Primary Extension) saisi est introuvable dans la base de données

Note: Si EMCC est configuré entre 12.x et tout CUCM antérieur à 12.x, le processus de connexion ne fonctionne qu'avec l'ID utilisateur (méthode traditionnelle), et non avec DN ou Selfcare ID.

Vérification

Dépannage

Collectez ces journaux pour le problème EM/EMCC :

• Mobilité de poste Cisco
• Application de substitution de poste Cisco
• Journaux de la console téléphonique
• Capture de paquets à partir du téléphone
• Journaux TVS en détail

Snippet for EM APP logs.
========================================================================================
Sample Snippets for Login Type "DN"

2017-08-28 21:07:04,522 INFO  [http-bio-8080-exec-10] EMAppServlet              - EMApp Request# ----->1190
2017-08-28 21:07:04,523 INFO  [http-bio-8080-exec-10] EMAppServlet              - EMAppServlet: Request protocol is :http
2017-08-28 21:07:04,523 INFO  [http-bio-8080-exec-10] EMAppServlet              - EMApp Request parameters: Logout=null Device Name=SEP74A02FC09CDF User Id=null Device Profile=null Refresh=null Remote Host IP Address = 10.106.99.235 Via Header Set = false getClusterInfo = null Lang = en_US Charset=utf-8,;q=0.8 Emcc = true LoginType = DN
2017-08-28 21:07:04,523 INFO  [http-bio-8080-exec-10] CMDatabase                - CMDatabase:checkDeviceAllowsAlternateScript
2017-08-28 21:07:04,551 INFO  [http-bio-8080-exec-10] CMDatabase                - SEP74A02FC09CDF with model 36224 and locale 1 does not support alternate script
2017-08-28 21:07:04,551 INFO  [http-bio-8080-exec-10] EMAppServlet              - Alternate Script for device SEP74A02FC09CDF =
2017-08-28 21:07:04,552 DEBUG [http-bio-8080-exec-10] EMServiceCommunicator     - Posting to EM Service:<query>
  <appInfo>
      <appID>CCMSysUser</appID>
      <appEncryptedCertificate>xxxxxxx</appEncryptedCertificate>
  </appInfo>
  <deviceUserQuery>
      <deviceName>SEP74A02FC09CDF</deviceName>
<loginType>DN</loginType>
     <remoteIPAddr>10.106.99.235</remoteIPAddr>
  </deviceUserQuery>
</query>

==================================================================================

Sample Snippets for Login Type "SP"


2017-08-28 22:06:05,781 INFO  [http-bio-8080-exec-24] EMAppServlet              - EMApp Request# ----->1204
2017-08-28 22:06:05,782 INFO  [http-bio-8080-exec-24] EMAppServlet              - EMAppServlet: Request protocol is :http
2017-08-28 22:06:05,782 INFO  [http-bio-8080-exec-24] EMAppServlet              - EMApp Request parameters: Logout=null Device Name=SEP74A02FC09CDF User Id=null Device Profile=null Refresh=null Remote Host IP Address = 10.106.99.235 Via Header Set = false getClusterInfo = null Lang = en_US Charset=utf-8,;q=0.8 Emcc = true LoginType = SP
2017-08-28 22:06:05,782 DEBUG [http-bio-8080-exec-24] EMServiceCommunicator     - Posting to EM Service:<query>
  <appInfo>
      <appID>CCMSysUser</appID>
      <appEncryptedCertificate>xxxxxxx</appEncryptedCertificate>
  </appInfo>
  <deviceUserQuery>
      <deviceName>SEP74A02FC09CDF</deviceName>
<loginType>SP</loginType>
     <remoteIPAddr>10.106.99.235</remoteIPAddr>
  </deviceUserQuery>
</query>

====================================================================================

Sample Snippets for Login Type "UID"


2017-08-29 14:48:20,657 INFO  [http-bio-8080-exec-1167] EMAppServlet              - EMApp Request# ----->10
2017-08-29 14:48:20,657 INFO  [http-bio-8080-exec-1167] EMAppServlet              - EMAppServlet: Request protocol is :http
2017-08-29 14:48:20,658 INFO  [http-bio-8080-exec-1167] EMAppServlet              - EMApp Request parameters: Logout=null Device Name=SEP402CF4915265 User Id=null Device Profile=null Refresh=null Remote Host IP Address = 10.77.22.225 Via Header Set = false getClusterInfo = null Lang = en Charset=utf-8,utf-8;q=0.8 Emcc = null LoginType = UID
2017-05-29 14:48:20,658 DEBUG [http-bio-8080-exec-1167] EMServiceCommunicator     - Posting to EM Service:<query>

<appInfo>   
    <appID>CCMSysUser</appID>  
    <appEncryptedCertificate>xxxxxxx</appEncryptedCertificate>
</appInfo>
<deviceUserQuery>
    <deviceName>SEP74A02FC09CDF </deviceName>
<loginType>UID</loginType>   
    <remoteIPAddr>10.106.99.235</remoteIPAddr>
</deviceUserQuery>
</query>

2017-08-29 14:48:20,658 INFO  [http-bio-8080-exec-1167] EMServiceCommunicator     - Posting to EM Query Service:https://localhost:8443/emservice/EMServiceServlet