Webchannel setup

Editions: Corporate
Versions: 4.4.0+ with Apache2

Webchannels allow you to make a channel or the media it contains publicly available on the Internet from your intranet.

If you want to use the feature, first enable it under Configuration -> Components -> Webchannel.

Then you can define each channel as a webchannel, if desired.

To do this, open the channel settings and activate the "Webchannel" option and enter the domain under which the webchannel should be accessible outside your intranet.

ViMP Webchannel

The configuration in ViMP is now complete.

Now you only have to make sure that the registered domain also points to the webchannel. To do this, perform the following steps:

1. Set up a new virtual host for the webchannel in your Apache configuration (e.g. webchannel.myvimp.com), where the DocumentRoot directory must point to the web folder of your ViMP instance (e.g. /var/www/vimp/web).

2. Enable proxy and proxy_http with the following commands:

a2enmod proxy
a2enmod proxy_http

3. Set up a rewrite condition for HTTPS. To do this, insert the following lines directly after the closed </Directory> tag in the previously created host entry (replace the domain accordingly):

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://webchannel.myvimp.com/$1 [L,R=301]

This rule ensures that a connection that is not secure is redirected to HTTPs first.

4. Set up the proxy settings in the previously created host (http://webchannel.myvimp.com):

<Proxy>
Order Deny,Allow
Allow from all
</Proxy>
ProxyPass / https://www.myvimp.com/
ProxyPassReverse / https://www.myvimp.com/

5. Finally, enable the new vHost and restart the Apache web server:

a2ensite <name_of_the_vhost_config_file>
service apache2 restart

6. Now configure your firewall accordingly that accesses to your ViMP server are possible over the defined domain. Then you can open the appropriate webchannel from the internet over the indicated domain.

 

Below is a sample vHost configuration for a webchannel (exemplified with a Let's Encrypt SSL configuration):

<VirtualHost *:80>

# Replace the e-mail address in the following line with your own e-mail address
ServerAdmin admin@myvimp.com

# Replace /var/www/vimp in the following line with your individual ViMP installation path
DocumentRoot "/var/www/vimp/web"

# Replace webchannel.myvimp.com in the following line with your individual domain
ServerName webchannel.myvimp.com

# Replace /var/www/vimp in the following line with your individual ViMP installation path
<Directory "/var/www/vimp/web">
Options +FollowSymLinks -SymLinksIfOwnerMatch
AllowOverride All
RewriteEngine On
Require all granted
</Directory>
RewriteEngine On
RewriteCond %{HTTPS} off
# Replace webchannel.myvimp.com in the following line with your individual domain
RewriteRule ^(.*)$ https://webchannel.myvimp.com/$1 [L,R=301]

<Proxy>
Order Deny,Allow
Allow from all
</Proxy>
# Replace www.myvimp.com in the following lines with your individual domain
ProxyPass / https://www.myvimp.com/
ProxyPassReverse / https://www.myvimp.com/
Header set Access-Control-Allow-Origin *
Header set Access-Control-Allow-Headers *

# Replace the path in following lines with your individual log paths
ErrorLog /var/www/log/apache2/error.webchannel.log
CustomLog /var/www/log/apache2/access.webchannel.log combined

</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>

# Replace the e-mail address in the following line with your own e-mail address
ServerAdmin admin@myvimp.com

# Replace /var/www/vimp in the following line with your individual ViMP installation path
DocumentRoot "/var/www/vimp/web"

# Replace webchannel.myvimp.com in the following line with your individual domain
ServerName webchannel.myvimp.com

# Replace /var/www/vimp in the following line with your individual ViMP installation path
<Directory "/var/www/vimp/web">
Options +FollowSymLinks -SymLinksIfOwnerMatch
AllowOverride All
RewriteEngine On
</Directory>

Header set Access-Control-Allow-Origin *
Header set Access-Control-Allow-Headers *

# Replace the path in following lines with your individual log paths
ErrorLog /var/www/log/apache2/error.webchannel.log
CustomLog /var/www/log/apache2/access.webchannel.log combined

# Replace the following certificate paths with your individual certificates
SSLCertificateFile /etc/letsencrypt/live/webchannel.myvimp.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/webchannel.myvimp.com/privkey.pem
Include /etc/letsencrypt/options-ssl-apache.conf
</VirtualHost>
</IfModule>

 

Last update on 2021/06/02 by Admin.

Go back