Video Chat and Screen Sharing

This page describes the HipChat Server video chat implementation. 

We replaced AddLive with HipChat Video as our video solution as of 17th January, 2017. To continue using video chat you must have switched to HipChat Video.

See Video chat with your team to find out about the great new features available in HipChat video including group chat and screen sharing!

This page

Related pages

Disable all video chat

If you don't want to use video chat or screen sharing, you can disable it for all users. 

Log in to HipChat Server and go to Server admin > Video

You can also perform this from the CLI by running the hipchat video --disable command. For example:

admin@hipchat:~$ hipchat video --disable
Disabled video
Triggering chef run and service restarts, waiting for completion...
Completed chef and service restart

Turn on HipChat Video 

To use HipChat Video go to Server admin > Video and choose HipChat Video

For HipChat Server 2.0.7 or earlier:

For HipChat Server 2.2.2:

To start a video chat, all participants need will need to be running version 4.26 or later of the HipChat desktop client (Mac, Linux or Windows). 

If you are currently using AddLive for video, HipChat Video will be turned on automatically when you upgrade to HipChat 2.1 or later, or you can choose to switch to HipChat Video now.  

 

  To turn on HipChat Video using the CLI...

For HipChat Server 2.0.7 or earlier, please run:

hipchat video --provider=jitsi

For HipChat Server 2.2.x, please run:

hipchat video --enable



Network requirements

The video conferencing capabilities are implemented using WebRTC, and both the clients and server must have a working internet connection. HipChat Server sets up the connections between the two HipChat clients' users. Once the session is established, audio and video streams using the HipChat Video service hipchat.me.

The following ports need to be open for HipChat Video:

  • TCP port 443 open for connections from HipChat clients and HipChat Server.
  • UDP port 10000 open for HipChat clients.

All video chat is routed through hipchat.me, our Cloud video solution. If this is an issue for your organisation you can disable video chat for all users. Only the clients need connectivity to hipchat.me.

HipChat Server also needs to register with the video service hosted in video.hipchatserver.com to establish a trust - based on a combination of a public/private key and your HipChat Server license. Connectivity to video.hipchatserver.com from the server instance is only needed while turning HipChat Video on or off. Once HipChat Video is set up, we do not communicate with video.hipchatserver.com.

To check connectivity with the keyserver using the CLI, run: 

hipchat video --checkkeyserver

To check if the key server has your server key, run: 

hipchat video --checkpublickey

Security

What is transmitted from HipChat Server? 

  • No user-provided credentials are transmitted. 
  • The full name of the user, their ID (email address) and their avatar URL are transmitted.
  • The domain name of the HipChat Server is transmitted. 

How is information encrypted? 

All signaling communications are encrypted using cipher suites restricted to AES 128 or 256 bit encryption. 

Video and audio data streams are protected using the SRTP protocol. AES CPC 128 bit encryption is used for RTP packet encryption. HMAC SHA1 is used for packet authentication and verification. Encryption keys are generated by the streaming server by session.

Client requirements

To use HipChat Video, all participants must be running version 4.26 or later of the HipChat desktop client (Mac, Linux or Windows), and must have a working internet connection. Video chat is not available in mobile clients.

The Windows and Linux client apps require a graphics driver that provides OpenGL 2.1 or higher.

To use HipChat Video in the web client, browsers will need to allow popups from your HipChat site.  

Safari users will also be prompted to download and install the Temasys WebRTC Plugin before they can join a video chat. This plugin is required by Jitsi, the technology that powers HipChat Video, as Safari does not have native WebRTC support. 

Troubleshooting HipChat Video

If users are reporting that they can't see the video button in their client, or they see an 'unable to join call' error, here's some things to try.

  • Go to Server admin > Video and check that HipChat video is enabled. If you see an error when you try to enable HipChat Video, make sure that HipChat Server can reach https://video.hipchatserver.com.
  • Check which version of the HipChat desktop client the user has installed. They'll need version 4.2.7 or later to use HipChat video.  HipChat video is not available on any mobile clients.
  • Ask the user to log out of their HipChat client completely, then log back in. If they are using the macOS X client, they'll also need to hit Forget this account after they log out.

Additional Troubleshooting Resources

 

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport