Zylinc Cloud kan integrere med en Cisco Unified Call Manager (CUCM), som er installeret on-premise i jeres netværk. Det gøres ved at installere en Windows-tjeneste på en server, der har netværksadgang til jeres CUCM.
Når opsætningen er gennemført, abonnerer tjenesten på presence-opdateringer for de brugere, I vælger, og videresender dem til Zylinc Cloud via en krypteret forbindelse, så real-time presence er tilgængelig i jeres Zylinc-løsning.
Opsætningen består af tre dele: forberedelse af jeres server, konfiguration af integrationen i Zylinc Cloud Configuration Manager, og oprettelse af en SIP trunk i jeres CUCM. Denne guide leder jer igennem alle tre.
Forudsætninger
Inden I går i gang, skal følgende være på plads:
- En Windows-server med netværksadgang til jeres CUCM
- .NET 10.0 runtime installeret på den pågældende server – kan hentes fra .NET's officielle downloadside
Firewall
Serveren, hvor Windows-tjenesten kører, skal have tilladelse til udgående forbindelse til:
rabbitmq.zylinc.cloud : 5671
Whitelisting hos Zylinc
Zylinc skal kende den offentlige IP-adresse på den server, hvor I installerer Windows-tjenesten, så den kan åbnes i Zylinc Clouds firewall. Del venligst denne IP med Zylinc – gerne nogle dage i forvejen – så den kan whitelistes, inden I færdiggør opsætningen.
Sådan gør du:
Step 1: Konfigurer SIP Presence i Zylinc Cloud
I Zylinc Cloud Configuration Manager går I til kategorien Presence og åbner siden for SIP presence-konfiguration. Her definerer I indstillingerne for integrationen:
- Enable: tænder eller slukker for al kommunikation med CUCM.
- Filter users on tags: angiv tags for at afgrænse, hvilke brugere der hentes presence-oplysninger for. Feltet kan stå tomt for at abonnere på alle brugere, men vi anbefaler på det kraftigste at anvende et filter for at undgå unødvendig høj belastning på jeres CUCM.
- Address of SIP server (IP or hostname): den lokale IP-adresse eller hostname på jeres CUCM.
- Port for SIP server: den SIP-port, jeres CUCM anvender.
- Local port to bind socket on: den port, Zylinc-tjenesten skal binde sig til. Brug samme værdi, som I senere konfigurerer for SIP trunk'en i CUCM, eller sæt den til nul for en tilfældig port, hvis det understøttes.
- Enable SIP logging: logger SIP-kommunikationen til brug ved fejlfinding. Aktivér kun dette, hvis Zylinc support beder om det.
Step 2: Installer Zylinc Windows-tjenesten
Download den seneste installer (.msi) fra den sti, der vises på konfigurationssiden ovenfor, og installer den på jeres Windows-server. Som standard installeres den i:
| C:\Program Files\Zylinc\SipPresenceProviderOnPrem |
Åbn derefter filen appsettings.json, som ligger i:
| C:\ProgramData\Zylinc\SipPresenceProviderOnPrem\[version]\SipPresenceProviderOnPrem |
Udfyld følgende felter med de forbindelsesoplysninger, Zylinc giver jer:
- GlobalRabbitMq:ConnectionString – connection string'en (adresse med legitimationsoplysninger) til Zylincs Global Message Bus, som Zylinc udleverer.
- GlobalRabbitMq:EnableSSL – sættes til true.
- GlobalRabbitMq:SslServer – sættes til rabbitmq.zylinc.cloud.
Alle andre indstillinger kan bevares, som de er.
Eksempel på appsettings.json:
|
{ // Connection settings to Global RabbitMQ "GlobalRabbitMq": { "ConnectionString": "amqp://username:password@rabbitmq.zylinc.cloud:5671/virtual-host", "EnableSsl": true, "SslServer": "rabbitmq.zylinc.cloud" },
// Console logging settings "ConsoleLogging": { "LogLevel": "Trace" },
// Settings for sending SIP requests in batches "BatchSettings": { "MessagesPerBatch": 30, "BatchPauseInSeconds": 10 } } |
Når I opdaterer tjenesten til en ny version, skal I huske at kopiere denne fil ind i den nye versions mappe.
Step 3: Konfigurer SIP Trunk'en i CUCM
Jeres CUCM skal konfigureres, så den tillader SIP-kommunikation fra den installerede Windows-tjeneste via en point-to-point SIP trunk. Tjenesten anvender hverken brugernavn eller adgangskode til dette – adgangen styres udelukkende gennem trunk-konfigurationen og jeres netværks-/firewall-opsætning.
3.1 Opret en SIP Trunk Security Profile
I CUCM-administrationsportalen opretter I en ny SIP Trunk Security Profile, der tillader at hente presence-oplysninger.
Giv profilen et navn og en beskrivelse, og sørg for at afkrydsningsfeltet “Accept presence subscription” er markeret.
3.2 Opret SIP Trunk
Gå til Device → Trunk, og opret en ny trunk med indstillingerne vist nedenfor, og klik derefter på Next.
Giv SIP trunk'en et navn og en beskrivelse, og vælg den ønskede Device Pool, Media Resource Group og Location.
I feltet SIP Information / Destination / Destination Address indtaster I den lokale IP-adresse (ikke et hostname) på den server, hvor Windows-tjenesten kører. I Destination Port indtaster I den samme lokale port, I konfigurerede i Zylinc Configuration Manager i Trin 1. Under SIP Trunk Security Profile vælger I den profil, I oprettede ovenfor.
Når dette er gjort, kan den installerede tjeneste abonnere på presence-ændringer for de brugere, I har konfigureret, og presence vil vises i jeres Zylinc-løsning.
Godt at vide
- Presence afhænger af en stabil SIP-forbindelse til jeres CUCM – netværksproblemer på begge sider vil påvirke statusopdateringerne.
- Vi anbefaler at filtrere brugere via tags i stedet for at abonnere på alle, for at holde belastningen på jeres CUCM lav.
- SIP logging bør kun aktiveres midlertidigt, og kun når der fejlfindes sammen med Zylinc support.
- SIP presence bruges udelukkende til visning af real-time status – det gemmes ikke til historisk rapportering.