Webchannel setup

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.


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 another SSL vhost for your domain:

<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>
systemctl restart apache2

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>

       <Proxy>
           Order Deny,Allow
           Allow from all
       </Proxy>
       
       SSLProxyEngine On
       ProxyPass / https://webchannel.meinvimp.com/
       ProxyPassReverse / https://webchannel.meinvimp.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

       LimitRequestBody 0
 
       # 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>