Configuring VideoStreaming Users

Scenario: In order to display live or recorded video on Desigo CC stations, you must configure video streaming permissions as described here.

 

Reference: This task is performed within step 5: Set up User Accounts and Networking of the main video integration workflow.

 

Worfklow diagram:

 

Prerequisites:

  • The VMS server is installed.
  • The Video extension is installed.

 

Steps:

1 - Create the StreamingUsers Role
  1. Start the VMS Management Client.
  1. In the Site Navigation tree, select Security > Roles.
  1. Right-click inside the Roles pane and select Add Role.
  1. In the Add Role dialog box, enter StreamingUsers in the Name field.
  1. Click OK.
  • The new StreamingUsers role appears in the Roles pane.

 

2 – Set the StreamingUsers Role Permissions
  • The VMS Management Client tool is running.
  1. In the Site Navigation tree, select Security > Roles.
  1. In the Roles pane, select StreamingUsers.
  1. In the Role Settings pane, select the Overall Security tab.
  1. Select the Cameras security group.
  1. Check the following Allow options:
  • Read
  • View Live
  • Playback
  1. Click the Save icon on the top left of the VMS Management Client window.

3 – (Method 1) Associate All Management Platform Windows Users to the StreamingUsers Role in VMS

In order to get VMS streaming video in Desigo CC, the Windows user who launches the Desigo CC client must be assigned to the StreamingUsers role. Therefore, in the VMS, associate all Desigo CC Windows users to the StreamingUsers role as described here.

  1. For each Desigo CC user, on the VMS server computer create an identical Windows account (same UserId and password) to the one that user has on the Desigo CC station.
    NOTE: In a Windows domain, the associated users are automatically distributed on the clients. However, in a Windows workgroup you will need to replicate and then maintain the accounts manually on all GMS and VMS stations (including web clients).
    NOTE: if it is not possible to create the Windows accounts on the VMS computer, see the fallback method below.
  1. In the VMS Management Client tool:
  • In the Site Navigation tree select Security > Roles.
  • In the Roles pane, select StreamingUsers.
  1. In the Role Settings pane, at the bottom, select the Users and Groups tab.
  1. Click Add... Windows user.
  1. Browser for and select the Widows accounts created in step 1 above.
  1. Click OK.
  • The Windows users are assigned to the StreamingUsers role. This will enable these users to see streaming video from their Desigo CC clients.

 

3 – (Method 2) Add Credentials of a Basic StreamingUser in All Management Platform Stations

Use this fallback method to work around policy issues, if it is not possible to create the Windows users on the VMS computer as described above.

Create a User Associated to StreamingUsers Role

  1. In the VMS Management Client tool:
    a. In the Site Navigation tree select Security > Roles.
    b. In the Roles pane, select StreamingUsers.
  1. In the Role Settings pane, at the bottom, select the Users and Groups tab.
  1. Click Add... Basic user.
  1. In the Select Basic Users to add to Role dialog box, click New...
  1. In the New Basic Users dialog box, enter VideoApiStreamingUser in the User name field.
    NOTE: The user name is case sensitive; you need to enter the exact letters of the name.
  1. Enter and confirm a Password in the corresponding fields. Note that the password fields cannot be left blank, and the password can be any string: it will be overwritten by the BT Video API when the service connects.
  1. Click OK.
  • The VideoApiStreamingUser user appears in the Roles Settings list as basic VMS user.

 

Add Credentials of the VideoApiStreamingUser on the Management Platform Station

Next, we will use the Windows Credential Manager to add the VideoApiStreamingUser, created above, to the Desigo CC station where we want to display video streams.

Repeat this procedure for all the Desigo CC stations where you want to display streaming video.

  1. On the Desigo CC station where you want to show video streams, open the Windows Credential Manager as follows:
    a. Select Start > Control Panel.
    b. Select User Accounts > Credential Manager.
  1. Select Windows Credentials.
  1. Click Add a generic credential.
  1. In the Internet or network address field, enter VMS server host name.
  1. In the User name field, enter exactly the following string:
    [BASIC]\VideoApiStreamingUser
  1. In the Password field enter the password you used for creating the VideoApiStreamingUser, above.
  • The credentials of the VideoApiStreamingUser are added to the vault of the Desigo CC computer.
  1. Restart the Desigo CC application.