Genetec Sipelia and CyberGate

this guide describes how to connect genetec sipelia (from now on referred to as 'sipelia') to cybergate, the cybertwice service that connects intercom systems to microsoft teams after completing this configuration, intercoms connected to sipelia — and the sipelia security desk — can make audio and video calls to microsoft teams users and answer incoming calls from teams how cybergate connects sipelia to microsoft teams microsoft teams is the hub for team collaboration in microsoft office 365 that integrates the people, content, conversations, and tools your team needs via the cybergate application that runs in microsoft azure, you can connect your genetec sipelia environment to your microsoft teams environment intercoms connected to sipelia can set up calls with audio and video to microsoft teams users and answer incoming calls from teams using the teams desktop client, teams desk phone, or teams smartphone app cybergate is a subscription based software as a service (saas) hosted in azure with cybergate there is no need to set up a hosting environment no need to download or install any software from cybertwice or a 3rd party no need to install additional virtual machines no need for a session border controller (sbc) or extra licenses for your existing sbc no need to get additional public switched telephone network (pstn) like phone numbers for your session initiation protocol (sip) intercoms for instructions on how to purchase and configure the cybergate service, see our cybergate purchase and setup # what this guide covers connecting sipelia to cybergate enables you to make calls from intercoms connected to sipelia, or directly from the sipelia security desk, to teams users the configuration consists of three parts, covered in order in this guide configure cybergate in the cybergate management portal configure sipelia to connect it to cybergate complete the final steps in the cybergate management portal this manual also contains an appendix, install the cybergate app , describing the installation and usage of the cybergate app for microsoft teams use the cybergate app for microsoft teams to open the door of the intercom by simply clicking on an open door button see the status of your intercom and call the intercom from teams by clicking on just one button set your availability status in a configured cybergate multi ring group with one click installation of the cybergate app for microsoft teams is highly recommended prerequisites before you start, make sure that cybergate is purchased in the azure marketplace or microsoft appsource (see the cybergate purchase and setup manual https //support cybertwice com/knowledgebase php?article=6 ) cybergate is activated after purchasing (see the activation instructions in the manual https //support cybertwice com/knowledgebase php?article=6 ) consent is provided in the cybergate management portal (see the consent instructions in the manual https //support cybertwice com/knowledgebase php?article=6 ) the public wide area network (wan) ip address used by sipelia to access cybergate is whitelisted in the cybergate management portal (see the whitelisting instructions in the manual https //support cybertwice com/knowledgebase php?article=6 ) cybergate has as many licenses as there are devices that will connect to teams via sipelia configure cybergate in the management portal the connection between sipelia and cybergate runs over a so called sip trunk this sip trunk has to be added to cybergate and configured first sipelia is able to call one or multiple users simultaneously in teams it uses the cybergate multi ring group feature to be able to do so follow the steps below to add and configure the sip trunk and to configure the required multi ring groups add and configure the sip trunk log in to the cybergate management portal https //admin cybergate cybertwice com navigate to the sip trunk menu click the blue add sip trunk button provide the following information add sip trunk name name the sip trunk (in this example sipelia) click add after adding the sip trunk, click the blue edit button to edit the newly created sip trunk provide the credentials that cybergate uses to authenticate itself to sipelia update sip trunk outgoing authentication username define a username used to authenticate cybergate to sipelia outgoing password define a password used to authenticate cybergate to sipelia click update add a multi ring group navigate to the multi ring menu click the blue add multi ring group button provide the following information add multi ring group name name the multi ring group (in this example 5001 ) description a name of the multi ring group that describes the user that will be called click add after creating the multi ring group, add the required teams users to this multi ring group you can add as many multi ring groups as you have destinations to call in this guide, we'll use this particular multi ring group in the configuration of sipelia the configuration of the cybergate management portal is complete continue with the sipelia configuration configure sipelia the configuration of sipelia for use with cybergate consists of four steps create a sip trunk in sipelia create a dial plan rule create a range of extensions for cybergate add an account to security center sipelia create a sip trunk in sipelia under the sip trunking tab, click the + sign to add a sip trunk give the sip trunk a name (optional) enable transport layer security (tls) (optional) if using tls, use sip port 5061 under outbound requests , enter the incoming username and incoming password from the sip trunk you configured in the cybergate management portal (the update sip trunk screen, described in add and configure the sip trunk # ) enable registration to the trunk (optional) under inbound requests , enable authenticate requests for additional security authentication on incoming calls must be enabled under the general tab of sipelia for this security feature to work enable allow registration under inbound requests , enter the outgoing authentication username and outgoing password you defined in the update sip trunk screen of the cybergate management portal (see add and configure the sip trunk # ) click ok click apply the trunk state should be green, indicating that it is online create a dial plan rule under dial plans , use one of the available templates modify the rule accordingly configure the direction to be the cybergate sip trunk click ok click on the green dot (•) to activate the rule click apply create a range of extensions for cybergate create a range of extensions that is defined within your dial plan in order to call teams users or user groups go to the extension ranges section under the server tab click the + sign to add a range select a start and an end for your extension range (optional) add a description add a password add an account to security center sipelia to identify the teams user(s) in the sipelia address book, you must add the multi ring group(s) created in cybergate as sip intercom(s) in security center sipelia from the config tool homepage, select the sipelia plugin role at the bottom of the page, click add intercom enter a name and click add click the voip tab and assign a sip extension and a password to your sip teams virtual user group to communicate with other sip endpoints within sipelia, every sip intercom or user in security center must have a unique sip extension assigned to it assign the extension in one of two ways auto assign (recommended) click auto assign and choose the existing designated range of sip extensions for teams users the sip intercom is automatically assigned to the next available sip extension in the range and the correct password for the range is populated assign sip extension manual assign the extension manually by entering sip extension the extension number of the sip intercom password the password for the extension this password was specified when creating the extension range each sip extension within a given range has its password automatically set to match the default password for that range under server , select the sip trunk name previously created for the sip trunk with cybergate click apply repeat steps 1 to 5 for each multi ring group created in cybergate verify the sipelia configuration the virtual intercoms for the teams multi ring groups should display an online status with a green dot in security desk each created virtual intercom has an extension assigned to it dialing this extension using sipelia will trigger an outgoing call to cybergate within cybergate, this same extension corresponds with a multi ring group and the users in this multi ring group will be called complete the final steps in the cybergate management portal after the sipelia configuration is complete, calls can be made to teams users via cybergate all device(s) registered to sipelia (including security desk users) used to call teams destinations via cybergate will be added to cybergate automatically all devices that are added to cybergate will need corresponding licenses in cybergate so, for instance, if you use 5 devices to call teams destinations, you will need 5 cybergate licenses once all devices are created, one step must be taken download and run the (powershell) feature configuration script in the cybergate management portal the feature configuration script enables display names to appear in the teams environment and is required to enable outgoing calls from teams to the device(s) in sipelia navigate to the basic devices menu to see all detected devices in cybergate and to download the feature configuration script run the feature configuration script in powershell this will also remove the exclamation marks in the basic devices menu in the cybergate management portal