Table of Contents

Toolbox setup & user management

Toolbox setup

Views App

Views App (Web) basically routes internal APC TFT connections to the network via the core device's Ethernet port, as Views App (Windows) does. Anyway, configuration process is different to the windows version. This is an example configuration process for having a basic view in your browser.

  1. Open Toolbox software and config file.
  2. InMixer/Console, create a new console and add a new 52-8511 Display. Assign a View. Make sure you have the correct Central Display Group assigned.
  3. Go to <device> node in project tree and select the Web Apps tab (see screenshot below).
  4. In Enable WebApp Modules and APIs section, make sure Views App is checked to enable Views App.
  5. In Views App tab below, Configuration section, all modules suitable for web views are listed. Click the line of the newly created 52-8511 display.
  6. In Module Setup section, make sure Enable Web Access is checked. This will make the display generally available in the web. You can also:
    1. Enter a Browser Caption. This will help you to manage your views, as they can be easily identified later on.
    2. Enter custom Width and Height values (in grid units). The view will be cropped.
    3. Set View only to avoid control of the display via the web (only affects Views App Web)
    4. Set access control (see User Authentication)
  7. Send your configuration to the device
Views App Toolbox configuration.

Assist App

Assist App basically routes internal APC module connections to the network via the core device's Ethernet port using websocket connections.

  1. Open Toolbox software and config file.
  2. InMixer/Console, create a new console and add a new RX2, SX2 or 52/TX Console. Assign a View. Make sure you have the correct Central Display Group assigned.
  3. Go to <device> node in project tree and select the Web Apps tab (see screenshot below).
  4. In Enable WebApp Modules and APIs section, make sure Assist App is checked to enable Assist App.
  5. In Assist App tab below, Configuration section, all modules suitable for web views are listed. Click the line of the newly created console.
  6. In Module Setup section, make sure Enable Web Access is checked. This will make the display generally available in the web. You can also:
    1. Enter a Browser Caption. This will help you to manage your consoles, as they can be easily identified later on.
    2. Set View only to avoid control of the display via the web (only affects Views App Web)
    3. Set access control (see User Authentication)
  7. Send your configuration to the device
Assist App Toolbox configuration.

Snapshots App

  1. Open Toolbox software and config file.
  2. Go to <device> node in project tree and select the Web Apps tab (see screenshot below).
  3. In Enable WebApp Modules and APIs section, make sure Snapshots App is checked to enable Snapshots App.
  4. In Snapshots App tab below, setup the correct user level for the designated function (Basic Access and Backup & Restore, Save Snapshot 0 can be protected). Multi-select is possible.
Snapshtos App Toolbox configuration

Labels App

  1. Open Toolbox software and config file.
  2. Go to <device> node in project tree and select the Web Apps tab (see screenshot below).
  3. In Enable WebApp Modules and APIs section, make sure Labels App is checked to enable Labels App.
  4. In Labels App tab below, setup the correct user level for the designated function (Rename Fader Channels and Rename Global Labels can be protected). Multi-select is possible.
Labels App Toolbox configuration

System App

  1. Open Toolbox software and config file.
  2. Go to <device> node in project tree and select the Web Apps tab (see screenshot below).
  3. In System App tab below, setup the correct user level for the designated function (Configuration and Maintenance and Connection Management can be protected). Multi-select is possible.

Note
For security reasons, System App user rights group assignment behaves different than other web apps. If no user rights group is assigned, the functions will not be accessible. Using Configuration and Maintenance and Connection Management functions without login protection is not possible.

Labels App Toolbox configuration

User authentication

Web Apps offers a username / password protection based on Toolbox' existing administration mechanisms.

To protect a web app:

  1. In Toolbox go to <device> page and open the Web Apps tab.
  2. Views App: Select the display you wish to protect from the list in configuration section. In Module Setup section, set the access levels to assign user permission.
  3. Snapshots App, Labels App: Select the correct user level for the designated function.
  4. Open Web Apps in your browser and click the (login) button in the lower right. Enter your username & password.
  5. If the login button is not visible, click the app icon in the upper right. The navigation overlay will open. Here you can log in / log off.

Note
View Only in Views App is a separate function and is not affected by user rights. If you wish that different user groups have view only or full access, consider using different virtual displays.

Note
A user without the right to see and/or use the view will not see any hint that the function exists.

Automatic login with user token

Login a user directly, e.g. for stand-alone solutions using HTTP GET. Token is the user defined token as from Toolbox. Usage: 

http://[Core-IP]?token=[User-Token]

You can use this GET argument on any point and state of web apps, for example also in Views App: 

http://10.5.12.123/#/views/5?token=1234-1234-1234