Introdução
Este documento descreve como configurar um servidor Web em uma máquina Windows e também possui etapas para transferir a PRT Jabber para um servidor Web.
Pré-requisitos
A Cisco recomenda que você tenha conhecimento destes tópicos.
- Cisco Unified Communication Manager (CUCM)
- Cisco Jabber
Requisitos
Componentes Utilizados
As informações neste documento são baseadas nestas versões de software:
Versão do CUCM - 12.5.1.13900-152
Versão do Cisco Jabber - 12.9.2.54247
XAMPP (Web Server) versão - 7.4.10
As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.
Configurar
Diagrama de Rede
Cisco Jabber > Windows_PC (com software XAMPP de servidor Web)
Configurações
Essas etapas de configuração ajudam a transferir a PRT do Jabber para um servidor Web usando protocolos de 'Transferência de hipertexto' (HTTP - porta 80) e também usando protocolos de 'Protocolo de Transferência de Hipertexto Seguro' (HTTPS - porta 443).
1. Instalação do software XAMPP no PC com Windows.
2. Configuração inicial no XAMPP.
3. Configurando uma 'Pasta' para armazenar as PRTs Jabber no servidor Windows.
4. Crie um "Serviço UC" e atribua-o ao "Perfil de serviço" no CUCM.
5. Atribua o "Perfil de serviço" ao usuário final do Jabber.
6. Coletando o Jabber - PRT.
Se você quiser configurar o servidor Web baseado em HTTPS (seguro), configure essas etapas adicionais.
7. Gere "Server Key" e "Certificate Signing Request" (CSR) no XAMPP.
8. Assine o CSR usando a Autoridade de Certificação (CA) e obtenha o certificado assinado pela CA.
9. Carregue o certificado e reinicie o serviço Apache.
10. Modifique o URL no "Serviço UC"
11. Coletando o Jabber - PRT.
1. Instalação do software XAMPP no PC com Windows.
Faça o download do software XAMPP (para Windows) clicando aqui.
As etapas mencionadas nessas capturas de tela ajudam você a instalar o XAMPP na máquina com Windows.
Clique no botão Avançar no assistente de configuração.
Selecione os componentes mencionados e clique no botão Avançar.
Escolha a pasta de instalação e clique no botão Avançar.
Escolha o idioma e clique no botão Avançar.
Clique no botão Avançar.
Clique no botão Avançar para continuar a instalação.
Instalação em andamento.
Clique no botão Concluir.
2. Configuração inicial no XAMPP.
Abra o "Painel de controle do XAMPP" como um administrador.
Execute o 'Painel de controle do XAMPP' como um administrador.
Clique no botão Config.
Clique no botão Config.
Selecione as opções marcadas e clique no botão Save.
Selecione os componentes mencionados e clique no botão Salvar.
Inicie o serviço Apache clicando no botão "X" destacado.
Inicie o serviço Apache.
Pressione o botão Config e clique em PHP.
Abra o arquivo php.
Verifique se o valor de "upload_max_filesize" está definido como 40M.
Defina o valor de upload_max_filesize como 40M.
Inicie o serviço Apache clicando no botão Iniciar.
Clique no botão Iniciar para ativar o serviço Apache.
As mensagens de status indicam que o serviço Apache está sendo executado.
3. Configurando uma 'Pasta' para armazenar as PRTs Jabber no servidor Windows.
Crie uma nova pasta "JabberPRT" dentro do local "C:\xampp\htdocs". Esta pasta é usada para armazenar as PRTs Jabber.
Crie também um script PHP conforme mostrado nesta captura de tela.
Especifique o local da pasta para armazenar os logs PRT do Jabber.
Crie um arquivo "uploadprt.php" dentro do local >> "C:\xampp\htdocs" e escreva essas linhas dentro do arquivo .php
<?php $uploaddir = 'C:\xampp\htdocs\JabberPRT\\'; $uploadfile = $uploaddir . date('Y_m_d_H_i_s') . basename($_FILES['zipFileName']['name']); move_uploaded_file($_FILES['zipFileName']['tmp_name'], $uploadfile); ?>
4. Crie um "Serviço UC" e atribua-o ao "Perfil de serviço" no CUCM.
Faça login na página da Web de administração do CUCM e navegue: Gerenciamento de usuário > Configurações do usuário > Serviço UC.
Crie um novo serviço UC.
Abra o 'Serviço UC' na página da Web Administração do CUCM.
Selecione "Configuração do cliente Jabber (jabber-config.xml)" e escolha os valores apropriados.
Forneça os detalhes do servidor Web e do arquivo PHP na URL, como mostrado nesta captura de tela.
Seção : Cliente
Parâmetro: PrtLogServerURL
Valor : http://<WebServer_IP/FQDN>:80/uploadprt.php
Configurando os detalhes do servidor Web na configuração do cliente Jabber (jabber-config.xml) .
Navegue: User Management > User Settings > UC Service.
Atribua os serviços UC criados ao Perfil de serviço.
Abra 'Perfil de serviço' na página da Web Administração do CUCM.
Atribua a configuração do cliente Jabber criada ao 'Perfil de serviço' e clique no botão Salvar.
5. Atribua o "Perfil de serviço" ao usuário final do Jabber.
Certifique-se de que esse Service Profile esteja associado ao usuário final do Jabber.
Atribua o perfil de serviço ao usuário final do Jabber.
6. Coletando o Jabber - PRT.
Para coletar a PRT Jabber, você pode escolher Jabber e clicar no botão "Gerar PRT para selecionado".
Colete a PORTA Jabber.
Você pode encontrar o Jabber PRT no servidor Web (a localização é configurada no script PHP).
O servidor Web contém o arquivo Jabber PRT baixado.
Se você executar uma captura Wireshark no Servidor Web durante o evento de transferência de PRT, você verá essas informações.
A captura do Wireshark no servidor Web mostra as transações do arquivo PRT.
Se você quiser configurar o servidor Web baseado em HTTPS (seguro), configure essas etapas adicionais.
Estas etapas ajudam na instalação do certificado assinado por uma Autoridade de Certificação (CA) no Servidor Web e também possui configurações do Cisco CallManager (CCM) para transferência da PRT Jabber via TLS1.2.
7. Gere "Server Key" e "Certificate Signing Request" (CSR) no XAMPP.
Abra o Shell no painel de controle do XAMPP (webserver), digite o comando openssl e pressione enter.
Execute o comando openssl através do Shell do Painel de controle do XAMPP.
Gere a chave do servidor executando o comando "genrsa -out server.key 2048".
Execute o comando genrsa -out server.key 2048
Gere uma CSR (Certificate Signing Request, Solicitação de assinatura de certificado) executando esses comandos.
genrsa -out server.key 2048
req -new -sha1 -nodes -key server.key -out server.csr -days 000
Forneça as informações relevantes nesses campos:
- Nome do país.
- Nome do estado ou província.
- Nome da localidade.
- Nome da Organização.
- Unidade organizacional.
- Nome comum.
- Endereço de e-mail.
- Atributos extras.
Gere uma CSR (Certificate Signing Request, Solicitação de assinatura de certificado) para o servidor Web.
Você pode encontrar o CSR neste local.
C:\xampp\
Local da CSR (Solicitação de Assinatura de Certificado) gerado.
Copie o server.csr para este local de pasta.
C:\xampp\apache\conf\ssl.csr
Copie o arquivo CSR para um novo local de pasta.
Copie o arquivo server.key para o local mencionado:-
De
C:\xampp\apache
Para
C:\xampp\apache\conf\ssl.key
Copie server.key para um novo local de pasta.
8. Assine o CSR usando a Autoridade de Certificação (CA) e obtenha o certificado assinado pela CA.
Obtenha o CSR (server.csr) assinado pela CA (servidor CA do LAB - ADFSCAIMP) e o certificado "server.crt" do Servidor Web assinado pela CA.
Observação: salve o certificado no formato .crt (e não como .cer ou .der). Esta captura de tela mostra como salvar o certificado no formato .crt usando o servidor de CA do Windows (ao baixar o certificado assinado)
Assine o CSR pelo servidor da Autoridade de Certificação (CA) e obtenha o certificado assinado.
Certificado assinado.
9. Carregue o certificado e reinicie o serviço Apache.
Carregue o server.crt neste local.
C:\xampp\apache\conf\ssl.crt
Carregue o certificado assinado.
Após fazer o upload da CHAVE/CSR/CERT, reinicie o serviço Apache.
Reinicie o serviço Apache pressionando o botão Parar e Iniciar.
No CUCM, certifique-se de que o certificado Tomcat seja assinado pela mesma CA (aqui o servidor de CA é ADFSCAIMP).
Certificado Tomcat assinado pelo mesmo servidor de autoridade de certificação.
10. Modifique o URL no "Serviço UC"
Faça login na página da Web de administração do CUCM e navegue: Gerenciamento de usuário > Configurações do usuário > Serviço UC.
Modifique a URL do servidor Web conforme mostrado nesta seção Serviço UC.
Seção : Cliente
Parâmetro: PrtLogServerURL
Valor : https://<WebServer_FQDN>:443/uploadprt.php
Configurando os detalhes do servidor Web na configuração do cliente Jabber (jabber-config.xml) .
11. Coletando o Jabber - PRT.
Depois disso, gere a PRT através da página CCM.
Colete a PORTA Jabber.
A partir da captura de pacotes, você pode confirmar que o tráfego entre o Jabber e o Servidor Web está criptografado via TLS1.2 (HTTPS-443):
IP do servidor Web: 10.88.11.218
IP do PC Jabber: 10.201.251.189
A captura do Wireshark no servidor Web mostra que as transações do arquivo PRT aconteceram com segurança.
Verificar
Você pode encontrar o Jabber PRT no servidor Web (a localização é configurada no script PHP).
O servidor Web contém o arquivo Jabber PRT baixado.
Troubleshooting
Atualmente, não existem informações disponíveis específicas sobre Troubleshooting para esta configuração.
Informações Relacionadas
Espero que este artigo seja útil!