Faça download dos registros do relatório de problemas do Jabber (PRT) usando o servidor Web.

Atualizado:7 de fevereiro de 2024
ID do documento:221644

Linguagem imparcial

O conjunto de documentação deste produto faz o possível para usar uma linguagem imparcial. Para os fins deste conjunto de documentação, a imparcialidade é definida como uma linguagem que não implica em discriminação baseada em idade, deficiência, gênero, identidade racial, identidade étnica, orientação sexual, status socioeconômico e interseccionalidade. Pode haver exceções na documentação devido à linguagem codificada nas interfaces de usuário do software do produto, linguagem usada com base na documentação de RFP ou linguagem usada por um produto de terceiros referenciado. Saiba mais sobre como a Cisco está usando a linguagem inclusiva.

Sobre esta tradução

A Cisco traduziu este documento com a ajuda de tecnologias de tradução automática e humana para oferecer conteúdo de suporte aos seus usuários no seu próprio idioma, independentemente da localização. Observe que mesmo a melhor tradução automática não será tão precisa quanto as realizadas por um tradutor profissional. A Cisco Systems, Inc. não se responsabiliza pela precisão destas traduções e recomenda que o documento original em inglês (link fornecido) seja sempre consultado.

    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.

    Click the Next button in the setup wizard.Clique no botão Avançar no assistente de configuração.

    Select the mentioned components and click the Next button.Selecione os componentes mencionados e clique no botão Avançar.

    Choose the installation folder and click the Next button.Escolha a pasta de instalação e clique no botão Avançar.

    Choose the language and click the Next button.Escolha o idioma e clique no botão Avançar.

    Click the Next button.Clique no botão Avançar.

    Click the Next button to proceed with installation.Clique no botão Avançar para continuar a instalação.

    Installation is in progress.Instalação em andamento.

    Click the Finish button.Clique no botão Concluir.

    2. Configuração inicial no XAMPP.

    Abra o "Painel de controle do XAMPP" como um administrador.

    Run the 'XAMPP Control Panel' as an administrator.Execute o 'Painel de controle do XAMPP' como um administrador.

    Clique no botão Config.

    Click on the Config button.Clique no botão Config.

    Selecione as opções marcadas e clique no botão Save.

    Select the mentioned components and click the Save button.Selecione os componentes mencionados e clique no botão Salvar.

    Inicie o serviço Apache clicando no botão "X" destacado.

    Start the Apache service.Inicie o serviço Apache.

    Pressione o botão Config e clique em PHP.

    Open the php file.Abra o arquivo php.

    Verifique se o valor de "upload_max_filesize" está definido como 40M.

    Set the value of upload_max_filesize to 40M.Defina o valor de upload_max_filesize como 40M.

    Inicie o serviço Apache clicando no botão Iniciar.

    Click the Start button to bring up the Apache service.Clique no botão Iniciar para ativar o serviço Apache.

    Status messages display that the Apache service is running.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.

    Specify the folder location to store the Jabber's PRT logs.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

    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.

    Open 'UC Service' on the CUCM Administration web page.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

    Configuring the Web Server's details in Jabber Client Configuration (jabber-config.xml) .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.

    Open 'Service Profile' on the CUCM Administration web page.Abra 'Perfil de serviço' na página da Web Administração do CUCM.

    Assign the created Jabber Client Configuration to the 'Service Profile' and click the Save button.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.

    Assign the Service profile to the Jabber End User.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".

    Collect the Jabber PRT.Colete a PORTA Jabber.

    Você pode encontrar o Jabber PRT no servidor Web (a localização é configurada no script PHP).

    The Web server contains the downloaded Jabber PRT file.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.

    Wireshark capture on the Web server shows the PRT file transactions.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.

    Run the command openssl via the Shell of the XAMPP Control panel.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".

    Run the command genrsa -out server.key 2048Execute 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.

    Generate a Certificate Signing Request (CSR) for the Web Server.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\

    Generated Certificate Signing Request (CSR) location.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

    Copy the CSR file to a new folder location.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

    Copy the server.key to a new folder location.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.

    note-icon

    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)

    Sign the CSR by Certificiate Authority (CA) server and get the signed certificate.Assine o CSR pelo servidor da Autoridade de Certificação (CA) e obtenha o certificado assinado.

    Signed Certificate.Certificado assinado.

    9. Carregue o certificado e reinicie o serviço Apache.

    Carregue o server.crt neste local.

    C:\xampp\apache\conf\ssl.crt

    Upload the signed certificate.Carregue o certificado assinado.

    Após fazer o upload da CHAVE/CSR/CERT, reinicie o serviço Apache.

    Restart the Apache service by pressing the Stop & Start button.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).

    Tomcat certificate signed by the same CA server.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

    Configuring the Web Server's details in Jabber Client Configuration (jabber-config.xml) .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.

    Collect the Jabber PRT.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

    Wireshark capture on the Web server shows the PRT file transactions happened securely.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).

    The Web server contains the downloaded Jabber PRT file.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!

    Histórico de revisões

    Revisão Data de publicação Comentários
    1.0
    07-Feb-2024
    Versão inicial
    TAC Authored

    Colaborado por engenheiros da Cisco

    • Ramesh Balakrishnan

    Este documento lhe foi útil?

    FeedbackFeedback

    Contate a Cisco

    Este documento se refere a estes produtos