Inleiding
Dit document beschrijft hoe u een webserver op een Windows-computer kunt instellen en bevat ook stappen om de Jabber PRT naar een webserver over te brengen.
Voorwaarden
Cisco raadt kennis van de volgende onderwerpen aan.
- Cisco Unified Communications Manager (CUCM)
- Cisco Jabber
Vereisten
Gebruikte componenten
De informatie in dit document is gebaseerd op de volgende softwareversies:
CUCM-versie - 12.5.1.13900-152
Cisco Jabber versie - 12.9.2.54247
XAMPP (Web Server) versie - 7.4.10
De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.
Configureren
Netwerkdiagram
Cisco Jabber > Windows_PC (met webserver XAMPP-software)
Configuraties
Deze configuratiestappen helpen u om de Jabber PRT naar een webserver over te brengen met 'Hypertext Transfer' (HTTP - poort 80) en ook met 'Hypertext Transfer Protocol Secure' (HTTPS - poort 443) protocollen.
1. XAMPP-softwareinstallatie op de Windows-pc.
2. Eerste configuratie op XAMPP.
3. Een 'map' instellen om de Jabber PRT's op de Windows-server op te slaan.
4. Maak een "UC Service" en wijs deze toe aan het "Service Profile" op de CUCM.
5. Wijs het "Serviceprofiel" toe aan de Jabber-eindgebruiker.
6. Het verzamelen van de Jabber - PRT.
Als u een op HTTPS (beveiligd) gebaseerde webserver wilt configureren, dient u deze extra stappen te configureren.
7. Genereert "Server Key" en "Certificate Signing Verzoek" (CSR) op XAMPP.
8. Onderteken de CSR met behulp van certificaatautoriteit (CA) en krijg het CA ondertekende certificaat.
9. Upload het certificaat en start de Apache-service opnieuw.
10. Wijzig de URL op de "UC Service"
11. Het verzamelen van de Jabber - PRT.
1. XAMPP-softwareinstallatie op de Windows-pc.
Download XAMPP software (voor Windows) door hier te klikken.
De stappen die in deze screenshots worden beschreven, helpen u bij het installeren van de XAMPP op de Windows-machine.
Klik op de knop Volgende in de installatiewizard.
Selecteer de genoemde onderdelen en klik op de knop Volgende.
Kies de installatiemap en klik op de knop Volgende.
Kies de taal en klik op de knop Volgende.
Klik op de knop Volgende.
Klik op de knop Volgende om verder te gaan met de installatie.
De installatie is gestart.
Klik op de knop Voltooien.
2. Eerste configuratie op XAMPP.
Open "XAMPP-bedieningspaneel" als beheerder.
Draai het 'XAMPP Control Panel' als beheerder.
Klik op de knop Config.
Klik op de knop Config.
Selecteer de gemarkeerde opties en klik op de knop Opslaan.
Selecteer de genoemde onderdelen en klik op de knop Opslaan.
Start de Apache-service door op de gemarkeerde "X"-knop te klikken.
Start de Apache service.
Druk op de knop Config en klik op PHP.
Open het php-bestand.
Zorg ervoor dat de "upload_max_filesize" waarde is ingesteld op 40M.
Stel de waarde van upload_max_filesize in op 40M.
Start de Apache-service door op de knop Start te klikken.
Klik op de knop Start om de Apache-service te starten.
Statusberichten geven aan dat de Apache-service actief is.
3. Een 'map' instellen om de Jabber PRT's op de Windows-server op te slaan.
Maak een nieuwe map "JabberPRT" binnen de locatie "C:\xampp\htdocs". Deze map wordt gebruikt voor de opslag van de Jabber-poorten.
Maak ook een PHP script zoals in deze screenshot.
Geef de maplocatie op voor het opslaan van de PRT-logbestanden van Jabber.
Maak een bestand "uploadprt.php" binnen de lokatie >> "C:\xampp\htdocs" en schrijf deze regels in het .php bestand
<?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. Maak een "UC Service" en wijs deze toe aan het "Service Profile" op de CUCM.
Log in op de CUCM-webpagina en navigeer: Gebruikersbeheer > Gebruikersinstellingen > UC-service.
Maak een nieuwe UC-service.
Open 'UC Service' op de CUCM-beheerpagina.
Kies "Jabber Client Configuration (jabber-config.xml)" en kies de juiste waarden.
Geef de webserver en PHP file details in de URL zoals getoond in deze screenshot.
Sectie: Klant
Parameter: PortLogServerURL
Waarde: http://<WebServer_IP/FQDN>:80/uploadprt.php
De gegevens van de webserver configureren in Jabber Client Configuration (jabber-config.xml).
Navigeren: Gebruikersbeheer > Gebruikersinstellingen > UCS-service.
Wijs de gemaakte UC-services toe aan het serviceprofiel.
Open 'Serviceprofiel' op de CUCM-beheerpagina.
Wijs de gemaakte Jabber-clientconfiguratie toe aan het 'Serviceprofiel' en klik op de knop Opslaan.
5. Wijs het "Serviceprofiel" toe aan de Jabber-eindgebruiker.
Zorg ervoor dat dit serviceprofiel is gekoppeld aan de Jabber-eindgebruiker.
Wijs het serviceprofiel toe aan de Jabber-eindgebruiker.
6. Het verzamelen van de Jabber - PRT.
Voor het verzamelen van de Jabber PRT, kunt u Jabber kiezen en op de knop "Generate PRT for select" klikken.
Verzamel de Jabber PRT.
Je kan de Jabber PRT vinden op de Web server (de locatie is geconfigureerd in het PHP script).
De webserver bevat het gedownload Jabber PRT-bestand.
Als u een Wireshark-opname uitvoert op de Web Server tijdens een PRT-overdrachtgebeurtenis, ziet u deze informatie.
Wireshark Capture op de webserver toont de PRT-bestandstransacties.
Als u een op HTTPS (beveiligd) gebaseerde webserver wilt configureren, dient u deze extra stappen te configureren.
Deze stappen helpen u bij het installeren van het door de certificaatinstantie (CA) ondertekende certificaat op de WebServer en bovendien zijn er Cisco CallManager (CCM)-configuraties voor het overdragen van de Jabber PRT via TLS1.2.
7. Genereert "Server Key" en "Certificate Signing Verzoek" (CSR) op XAMPP.
Open Shell in het XAMPP-bedieningspaneel (webserver) en typ de opdracht openssl en druk op enter.
Draai de opdracht open via de Shell van het XAMPP-bedieningspaneel.
Genereer serversleutel door de opdracht "gensa -out server.key 2048" uit te voeren.
Voer de opdrachtgenerieke - out server.key 2048 uit
Genereer een aanvraag voor certificaatondertekening (CSR) door deze opdrachten uit te voeren.
genrsa-out server.key 2048
req -new -sha1 -knooppunten -key server.key -out server.csr -days 0000
Verstrek de relevante informatie onder deze velden:
- Landnaam.
- Naam van de staat of provincie.
- Plaatsnaam.
- Naam van de organisatie.
- Organisatorische eenheid
- Benaming.
- E-mailadres.
- Extra kenmerken.
Genereert een aanvraag voor certificaatondertekening (CSR) voor de webserver.
Je vindt de MVO op deze locatie.
C:\xampp\
Locatie van gegenereerde certificaatondertekeningsaanvraag (CSR).
Kopieer de server.csr naar deze maplocatie.
C:\xampp\apache\conf\ssl.csr
Kopieert het CSR-bestand naar een nieuwe maplocatie.
Kopieer het bestand server.key naar de genoemde locatie:-
Van
C:\xampp\apache
in
C:\xampp\apache\conf\ssl.key
Kopieer de server.key naar een nieuwe maplocatie.
8. Onderteken de CSR met behulp van certificaatautoriteit (CA) en krijg het CA ondertekende certificaat.
Ontvang de CSR (server.csr) ondertekend door de CA (LAB CA server - ADFSCAIMP) en ontvang het CA-ondertekende Webserver certificaat "server.crt".
Opmerking: zorg ervoor dat u de cert opslaat in .crt formaat (en niet als .cer of .der). Deze screenshot laat zien hoe u de cert in .crt-indeling kunt opslaan met de Windows CA-server (bij het downloaden van de ondertekende cert)
Onderteken de MVO door de server van de Certificaatinstantie (CA) en krijg het ondertekende certificaat.
Ondertekend certificaat.
9. Upload het certificaat en start de Apache-service opnieuw.
Upload de server.crt op deze locatie.
C:\xampp\apache\conf\ssl.crt
Upload het ondertekende certificaat.
Start na het uploaden van de KEY/CSR/CERT de Apache-service opnieuw op.
Start de Apache-service opnieuw door op de knop Stop & Start te drukken.
Zorg er op de CUCM voor dat het Tomcat-certificaat door dezelfde CA is ondertekend (hier is de CA-server ADFSCAIMP).
Tomcat-certificaat ondertekend door dezelfde CA-server.
10. Wijzig de URL op de "UC Service"
Log in op de CUCM-webpagina en navigeer: Gebruikersbeheer > Gebruikersinstellingen > UC-service.
Wijzig de URL van de webserver dienovereenkomstig zoals in deze sectie UC-service wordt getoond.
Sectie: Klant
Parameter: PortLogServerURL
Waarde: https://<WebServer_FQDN>:443/uploadprt.php
De gegevens van de webserver configureren in Jabber Client Configuration (jabber-config.xml).
11. Het verzamelen van de Jabber - PRT.
Vervolgens genereert u PRT via CCM-pagina.
Verzamel de Jabber PRT.
Van de pakketopname kunt u bevestigen dat het verkeer tussen Jabber en Web Server versleuteld via TLS1.2 (HTTPS-443):
Webserver IP : 10.8.11.2018
Jabber PC IP : 10.201.251.189
Wireshark Capture op de webserver toont dat de PRT-bestandstransacties veilig hebben plaatsgevonden.
Verifiëren
Je kan de Jabber PRT vinden op de Web server (de locatie is geconfigureerd in het PHP script).
De webserver bevat het gedownload Jabber PRT-bestand.
Problemen oplossen
Er is momenteel geen specifieke troubleshooting-informatie beschikbaar voor deze configuratie.
Gerelateerde informatie
Ik hoop dat dit artikel nuttig is!