URL do serviço de login do CUCM 12.X Extension Mobility(EM) e Extension Mobility Cross Cluster (EMCC)

Introduction

Este documento descreve o novo serviço Uniform Resource Locator (URL) no Cisco Unified Communication Manager (CUCM) 12.X.

Prerequisites

O Cisco Extension Mobility permite que os usuários acessem temporariamente sua configuração do Cisco Unified IP Phone, como aparências de linha, serviços e discagens rápidas de outros Cisco Unified IP Phones. A Mobilidade de Ramal oferece suporte a Cisco Unified IP Phones que executam SCCP e SIP.

A funcionalidade de mobilidade de ramal se estende à maioria dos telefones IP Cisco Unified. Você pode configurar cada telefone IP Cisco Unified para oferecer suporte ao Cisco Extension Mobility na janela Default Device Profile na Cisco Unified Communications Manager Administration. Isso permite aos usuários que não têm um perfil de dispositivo de usuário para um telefone IP Cisco Unified específico para usar o Cisco Extension Mobility com esse telefone.

Requirements

 Este recurso foi apresentado no CUCM 12.X.

Componentes Utilizados

 Versão do CUCM: 12.0.0.99834-5

 Modelo do telefone - 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. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Configurar

Diagrama de Rede

Configurações

Configuração de URL do serviço de Mobilidade de Ramal (EM):

Você está familiarizado com a configuração do URL de mobilidade de ramal para login normal para "ID de usuário".

URL de login do EM normal:

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

Com base no parâmetro na URL do serviço de telefone, o Aplicativo de Mobilidade de Ramal atende a diferentes tipos de página de login para o usuário final.

O login EM está agora disponível em três tipos diferentes:

1. ID do usuário
2. DN principal
3. ID de usuário de autoatendimento

Esta tabela ajuda a identificar os diferentes tipos de login:

1. ID de usuário (UID):

Esta é a URL do serviço que permite que o usuário faça login com sua ID de usuário.

Aqui, UID é o tipo de login.

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

Navegue até Device > Device Setting > Phone Services > Add New

Como é no telefone real:

 2. DN principal

Primeiro, você precisa entender o que significa DN primário?

Assim, na página de configuração do usuário final, você tem a opção definida como DN primário.

Se você não definir o DN principal para o usuário e tentar fazer login, você receberá uma falha com este erro:

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

Ocorre quando a ID de usuário (UID)/ID de usuário de autoatendimento (SP) ou ramal principal (DN) inserida não é encontrada no banco de dados

Esta é a URL do serviço para permitir que os usuários façam login com seu DN principal.

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

Navegue até Device > Device Setting > Phone Services > Add New

Como é no telefone real:

3.ID de usuário de autoatendimento

Essa é a ID usada para gerenciar o portal de autoatendimento.

Se ele não estiver configurado na página do usuário final, você não terá permissão para fazer logon neste URL de serviço e fornecerá este erro:

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

• Ocorre quando a ID de usuário (UID)/ID de usuário de autoatendimento (SP) ou ramal principal (DN) inserida não é encontrada no banco de dados

URL de serviço para a ID de usuário de autoatendimento:

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

Navegue até Device > Device Setting > Phone Services > Add New

Como é no telefone real:

Configuração de URL do serviço entre clusters da Mobilidade de Ramal (EMCC):

Assim como a URL de serviço da EM, também temos três tipos para login da EMCC. Aqui está o URL do serviço para os respectivos tipos de login.

• ID do usuário: Este é o URL do serviço para login no 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 de usuário de autoatendimento:

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

Códigos de erro para EMCC:

Códigos de erro comuns para problemas de login do EMCC:

• Código de erro: 47
  Mensagem de erro no telefone: DN tem vários usuários(47)
  
  Ocorre no login EMCC quando a Extensão (Extensão principal na página de configuração do usuário final) usada para logon é atribuída a vários usuários
• Código de erro: 1
  Mensagem de erro no telefone: O login está indisponível(1) / O logoff não está disponível(1)
  
  Ocorre quando o serviço EM não pôde analisar a solicitação XML do EMApp/EMservice ou devido a uma incompatibilidade nas versões entre a casa e a visita às versões do CUCM.
• Código de erro: 23
  Mensagem de erro no telefone: Login indisponível(23) / Logoff indisponível(23)
  
  Ocorre quando a ID de usuário (UID)/ID de usuário de autoatendimento (SP) ou ramal principal (DN) inserida não é encontrada no banco de dados

Note: Se o EMCC estiver configurado entre o CUCM 12.x e qualquer CUCM anterior à 12.x, o processo de login funcionará somente com a ID do usuário (modo tradicional), não com DN ou ID do Cuidados Pessoais.

Verificar

Troubleshoot

Colete estes registros para o problema EM/EMCC:

• Mobilidade de ramal da Cisco
• Aplicativo Cisco Extension Mobility
• Registros do console do telefone
• Captura de pacotes do telefone
• Login TVS em detalhes

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