概要
このドキュメントでは、Cisco Unified Communication Manager(CUCM)12.Xの新しいサービスUniform Resource Locator(URL)について説明します。
前提条件
Cisco Extension Mobilityを使用すると、ユーザはCisco Unified IP Phoneの設定(ラインアピアランス、サービス、他のCisco Unified IP Phoneからの短縮ダイヤルなど)に一時的にアクセスできます。エクステンションモビリティは、SCCPおよびSIPを実行するCisco Unified IP Phoneをサポートします。
エクステンションモビリティ機能は、ほとんどのCisco Unified IP Phoneで使用できます。Cisco Unified IP Phoneを設定して、Cisco Unified Communications Manager Administrationの[Default Device Profile]ウィンドウでCisco Extension Mobilityをサポートできます。これにより、特定のCisco Unified IP Phoneのユーザデバイスプロファイルを持たないユーザは、その電話機でCisco Extension Mobilityを使用できます。
要件
この機能はCUCM 12.Xで導入されました。
使用するコンポーネント
CUCM バージョン:12.0.0.99834-5
電話モデル – 88XX
このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期(デフォルト)設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。
設定
ネットワーク図
設定
エクステンションモビリティサービスURLの設定(EM):
「ユーザID」に対する通常のログイン用のエクステンションモビリティURLの設定に慣れています。
通常のEMログインURL:
http:// <ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#
PhoneサービスURLのパラメータに基づいて、Extension Mobilityアプリケーションは、エンドユーザにさまざまなタイプのログインページを提供します。
EMログインは、次の3つのタイプで使用できます。
- ユーザ ID
- プライマリDN
- セルフサービスユーザID
次の表は、さまざまなログインタイプを識別するのに役立ちます。
1.ユーザーID (UID):
これは、ユーザがユーザIDでログインできるサービスURLです。
ここで、UIDはログインタイプです。
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=UID
[Device] > [Device Setting] > [Phone Services] > [Add New]に移動します
実際の電話機の外観:
2.プライマリDN
まず、「プライマリDNの意味」について理解する必要があります。
したがって、[End user configuration]ページで[Primary DN]をオプションで設定できます。
ユーザのプライマリDNを設定せずにログインしようとすると、次のエラーが表示されます。
Error code : 23
Error message on phone: Login is unavailable(23) / Logout is unavailable(23
入力したユーザーID (UID) /セルフサービスユーザーID (SP)またはプライマリ内線番号(DN)がデータベースに見つからない場合に発生します
これは、ユーザがPrimay DNでログインできるようにするサービスURLです。
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=DN
[Device] > [Device Setting] > [Phone Services] > [Add New]に移動します
実際の電話機の外観:
3.セルフサービスユーザID
これは、セルフケアポータルを管理するために使用されるIDです。
エンドユーザページで設定されていない場合、このサービスURLにログインすることは許可されず、次のエラーが表示されます。
Error code : 23
Error message on phone: Login is unavailable(23) / Logout is unavailable(23)
- 入力したユーザーID (UID) /セルフサービスユーザーID (SP)またはプライマリ内線番号(DN)がデータベースに見つからない場合に発生します
セルフサービスユーザIDのサービスURL:
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=SP
[Device] > [Device Setting] > [Phone Services] > [Add New]に移動します
実際の電話機の外観:
Extension Mobility Cross Cluster Service URL Configuration(EMCC):
EMサービスURLと同様に、EMCCログインには3つのタイプがあります。各ログインタイプのサービスURLを次に示します。
- ユーザ ID:これは、EMCCにログインするためのサービスURLです。
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=UID
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=DN
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=SP
EMCCのエラーコード:
EMCCログインに関する一般的なエラーコード:
- Error Code:47
電話のエラーメッセージ:DNに複数のユーザがある(47)
ログインに使用する内線番号(エンドユーザ設定ページのプライマリ内線番号)が複数のユーザに割り当てられると、EMCCログインで発生します
- Error Code:1
電話のエラーメッセージ: ログインできません(1) /ログアウトできません(1)
EMサービスがEMApp/EMservice OrからのXML要求を解析できなかった場合に発生します。ホームバージョンと訪問先CUCMバージョンのバージョンが一致しません。
- Error Code:23
電話のエラーメッセージ: ログインできません(23)/ログアウトできません(23)
入力したユーザーID (UID) /セルフサービスユーザーID (SP)またはプライマリ内線番号(DN)がデータベースに見つからない場合に発生します
注:EMCCが12.xから12.xより前の任意のCUCMの間で設定されている場合、ログインプロセスはユーザID(従来の方法)でのみ動作し、DNやセルフケアIDでは動作しません。
確認
トラブルシュート
EM/EMCC問題に関する次のログを収集します。
- Cisco Extension Mobility
- Cisco Extension Mobilityアプリケーション
- 電話機のコンソール ログ
- 電話機からのパケットキャプチャ
- TVSログインの詳細
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