Zylinc Cloud kan integrere med en Cisco Unified Call Manager (CUCM), som er installeret on-premise i jeres netværk. Dette gøres ved at installere en lille 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 } } |
When you update the service to a new version, remember to copy this file into the new version's folder.
Step 3: Configure the SIP Trunk in CUCM
Your CUCM must be configured to allow SIP communication from the installed Windows service, using a point-to-point SIP trunk. The service does not use a username or password for this – access is controlled entirely through the trunk configuration and your network/firewall setup.
3.1 Create a SIP Trunk Security Profile
In the CUCM administration portal, create a new SIP Trunk Security Profile that allows retrieving presence information.
Give the profile a name and description, and make sure the “Accept presence subscription” checkbox is checked.
3.2 Create the SIP Trunk
Go to Device → Trunk, and create a new trunk using the settings shown below, then click Next.
Give the SIP trunk a name and description, and choose your desired Device Pool, Media Resource Group, and Location.
In the SIP Information / Destination / Destination Address field, enter the local IP address (not a hostname) of the server running the Windows service. In Destination Port, enter the same local port you configured in Zylinc Configuration Manager in Step 1. For SIP Trunk Security Profile, select the profile you created above.
Once this is done, the installed service will be able to subscribe to presence changes for the users you've configured, and presence will appear in your Zylinc solution.
Good to know
- Presence relies on a stable SIP connection to your CUCM – network issues on either side will affect status updates.
- We recommend filtering users via tags rather than subscribing to everyone, to keep load on your CUCM low.
- SIP logging should only be turned on temporarily, and only when troubleshooting with Zylinc support.
- SIP presence is used for real-time status display only – it is not stored for historical reporting.