Scaricare i registri PRT (Jabber Problem Report) utilizzando il server Web.

Introduzione

In questo documento viene descritto come configurare un server Web su un computer Windows e viene spiegato come trasferire la parte Jabber PRT su un server Web.

Prerequisiti

Cisco raccomanda la conoscenza dei seguenti argomenti.

• Cisco Unified Communications Manager (CUCM)
• Cisco Jabber

Requisiti

Componenti usati

Le informazioni fornite in questo documento si basano sulle seguenti versioni software:

Versione CUCM - 12.5.1.13900-152
Cisco Jabber versione - 12.9.2.54247
Versione di XAMPP (server Web) - 7.4.10

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Configurazione

Esempio di rete

Cisco Jabber > Windows_PC (con software XAMPP per server Web)

Configurazioni

La procedura di configurazione descritta di seguito consente di trasferire la porta Jabber a un server Web utilizzando il protocollo HTTP (Hypertext Transfer - porta 80) e i protocolli HTTPS (Hypertext Transfer Protocol Secure - porta 443).

1. Installazione del software XAMPP sul PC Windows.
2. Configurazione iniziale su XAMPP.
3. Impostazione di una "cartella" per memorizzare le porte Jabber sul server Windows.
4. Creare un "Servizio UC" e assegnarlo al "Profilo di servizio" sul CUCM.
5. Assegnare "Service Profile" all'utente finale di Jabber.
6. Raccolta della parte Jabber - PRT.

Se si desidera configurare il server Web basato su HTTPS (protetto), configurare i passaggi aggiuntivi seguenti.

7. Generare "Server Key" e "Certificate Signing Request" (CSR) in XAMPP.
8. Firmare il CSR utilizzando l'autorità di certificazione (CA) e ottenere il certificato firmato dall'autorità di certificazione.
9. Caricare il certificato e riavviare il servizio Apache.
10. Modificare l'URL nel "Servizio UC"
11. Raccolta della parte Jabber - PRT.

1. Installazione del software XAMPP sul PC Windows.

Scaricare il software XAMPP (per Windows) facendo clic qui.

I passaggi indicati in queste schermate consentono di installare XAMPP sul computer Windows.

Fare clic sul pulsante Avanti nella procedura di installazione guidata.

Selezionare i componenti indicati e fare clic sul pulsante Avanti.

Scegliere la cartella di installazione e fare clic sul pulsante Avanti.

Scegliere la lingua e fare clic sul pulsante Avanti.

Fare clic sul pulsante Avanti.

Fare clic sul pulsante Avanti per procedere con l'installazione.

Installazione in corso.

Fare clic sul pulsante Fine.

2. Configurazione iniziale su XAMPP.

Aprire "Pannello di controllo XAMPP" come amministratore.

Eseguire 'Pannello di controllo XAMPP' come amministratore.

Fare clic sul pulsante Config.

Fare clic sul pulsante Config.

Selezionare le opzioni contrassegnate e fare clic sul pulsante Salva.

Selezionare i componenti indicati e fare clic sul pulsante Salva.

Avviare il servizio Apache facendo clic sul pulsante "X" evidenziato.

Avviare il servizio Apache.

Premere il pulsante Config e fare clic su PHP.

Aprire il file php.

Accertarsi che il valore "upload_max_filesize" sia impostato su 40M.

Impostare il valore di upload_max_filesize su 40M.

Avviare il servizio Apache facendo clic sul pulsante Start.

Fare clic sul pulsante Start per visualizzare il servizio Apache.

I messaggi di stato indicano che il servizio Apache è in esecuzione.

3. Impostazione di una "cartella" per memorizzare le porte Jabber sul server Windows.

Creare una nuova cartella "JabberPRT" nel percorso "C:\xampp\htdocs". Questa cartella viene utilizzata per memorizzare le porte Jabber.
Create anche uno script PHP come mostrato in questa schermata.

Specificare il percorso della cartella in cui archiviare i log PRT di Jabber.

Creare un file "uploadprt.php" nel percorso >> "C:\xampp\htdocs" e scrivere queste righe all'interno del file .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. Creare un "Servizio UC" e assegnarlo al "Profilo di servizio" sul CUCM.

Accedere alla pagina Web di amministrazione di CUCM e selezionare: Gestione utente > Impostazioni utente > Servizio UC.

Crea un nuovo servizio UC.

Aprire 'Servizio UC' nella pagina Web di amministrazione CUCM.

Scegliere "Jabber Client Configuration (jabber-config.xml)" e scegliere i valori appropriati.
Fornire i dettagli del server Web e del file PHP nell'URL, come mostrato in questa schermata.

Sezione : Client

Parametro : PrtLogServerURL

Valore : http://<IP_WebServer/FQDN>:80/uploadprt.php

Configurazione dei dettagli del server Web in Configurazione client Jabber (jabber-config.xml).

Selezionare Gestione utente > Impostazioni utente > Servizio UC.

Assegnare i servizi UC creati al profilo di servizio.

Aprire 'Profilo servizio' nella pagina Web di amministrazione CUCM.

Assegnare la configurazione del client Jabber creata a 'Profilo servizio' e fare clic sul pulsante Salva.

5. Assegnare il "profilo di servizio" all'utente finale Jabber.

Accertarsi che questo profilo del servizio sia associato all'utente finale Jabber.

Assegnare il profilo Service all'utente finale Jabber.

6. Raccolta della parte Jabber - PRT.

Per raccogliere la parte Jabber PRT, potete scegliere Jabber e fare clic sul pulsante "Genera parte per selezionata".

Raccogliere la parte Jabber.

La parte Jabber PRT si trova sul server Web (la posizione è configurata nello script PHP).

Il server Web contiene il file Jabber PRT scaricato.

Se si esegue un'acquisizione Wireshark sul server Web durante un evento di trasferimento PRT, vengono visualizzate queste informazioni.

L'acquisizione di Wireshark sul server Web mostra le transazioni dei file PRT.

Se si desidera configurare il server Web basato su HTTPS (protetto), configurare i passaggi aggiuntivi seguenti.

Questi passaggi facilitano l'installazione di un certificato firmato da CA (Certification Authority) sul server Web e dispongono di configurazioni Cisco CallManager (CCM) per il trasferimento della parte Jabber PRT tramite TLS1.2.

7. Generare "Server Key" e "Certificate Signing Request" (CSR) in XAMPP.

Aprire Shell nel pannello di controllo XAMPP (server Web), digitare il comando openssl e premere invio.

Eseguire il comando openssl tramite la shell del pannello di controllo XAMPP.

Generare la chiave del server eseguendo il comando "genrsa -out server.key 2048".

Eseguire il comando genrsa -out server.key 2048

Generare una richiesta di firma del certificato (CSR) eseguendo questi comandi.

genrsa -out server.key 2048

req -new -sha1 -nodes -key server.key -out server.csr -days 0000

Fornisci le informazioni pertinenti in questi campi:

• Nome del paese.
• Nome della provincia.
• Nome località.
• Nome organizzazione.
• Unità organizzativa.
• Nome comune.
• Indirizzo e-mail
• Attributi aggiuntivi.

Generare una richiesta di firma del certificato (CSR) per il server Web.

Il CSR si trova in questa posizione.

C:\xampp\

Percorso della richiesta di firma del certificato (CSR) generato.

Copiare il file server.csr in questa cartella.

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

Copiare il file CSR in una nuova cartella.

Copiare il file server.key nella posizione indicata:-


Da
C:\xampp\apache

A
C:\xampp\apache\conf\ssl.key

Copiare il file server.key in una nuova cartella.

8. Firmare il CSR utilizzando l'autorità di certificazione (CA) e ottenere il certificato firmato dall'autorità di certificazione.

Ottenere il CSR (server.csr) firmato dalla CA (LAB CA server - ADFSCAIMP) e ottenere il certificato "server.crt" del server Web firmato dalla CA.

Firmare il CSR tramite il server Autorità di certificazione (CA) e ottenere il certificato firmato.

Certificato firmato.

9. Caricare il certificato e riavviare il servizio Apache.

Caricare il file server.crt in questa posizione.

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

Caricare il certificato firmato.

Dopo aver caricato KEY/CSR/CERT, riavviare il servizio Apache.

Riavviare il servizio Apache premendo il pulsante Stop & Start.

Sul CUCM, assicurarsi che il certificato Tomcat sia firmato dalla stessa CA (qui il server CA è ADFSCAIMP).

Certificato Tomcat firmato dallo stesso server CA.

10. Modificare l'URL nel "Servizio UC"

Accedere alla pagina Web di amministrazione di CUCM e selezionare: Gestione utente > Impostazioni utente > Servizio UC.

Modificare l'URL del server Web di conseguenza, come illustrato in questa sezione Servizio UC.

Sezione : Client

Parametro : PrtLogServerURL

Valore : https://<FQDN_WebServer>:443/uploadprt.php

Configurazione dei dettagli del server Web in Configurazione client Jabber (jabber-config.xml).

11. Raccolta della parte Jabber - PRT.

Quindi, generare la parte PRT mediante la pagina CCM.

Raccogliere la parte Jabber.

Dall'acquisizione dei pacchetti è possibile confermare che il traffico tra Jabber e Web Server sia crittografato tramite TLS1.2 (HTTPS-443):

IP server Web: 10.88.11.218
IP Jabber PC: 10.201.251.189

L'acquisizione di Wireshark sul server Web mostra che le transazioni del file PRT sono state eseguite in modo sicuro.

Verifica

La parte Jabber PRT si trova sul server Web (la posizione è configurata nello script PHP).

Il server Web contiene il file Jabber PRT scaricato.

Risoluzione dei problemi

Al momento non sono disponibili informazioni specifiche per la risoluzione dei problemi di questa configurazione.

Informazioni correlate

• Raccogli registri PRT in remoto

Spero che questo articolo sia utile!