Webapps-common

From SME Server
Jump to navigationJump to search


webbapps-common for SME Server

PythonIcon.png Skill level: easy
The instructions on this page can be followed by a beginner.


Maintainer

Daniel B. from Firewall Services

Description

smeserver-webbapps-common is not really a contrib, it is more a framework like used by many contribs of fws

Requirements

You need the firewall-services repo to install this contribs

Installation 8.x 9.x

This contrib is currently held in the fws repository, You do not need to install it alone, it is a dependency of other package such as tt-rss

However you can use to reconfigure some web application of fws by using

signal-event webapps-update

Configuration

The most important things to know is that you can create a domain by command line. More features will be created compared with the standard virtualhost templates, you have:

  • DocumentRoot to set an arbitrary document root instead of having to choose an ibay
  • RequireSSL to ask the forced SSL communication (default 'disabled', on by 'enabled')
  • Authentication different way to protect your domain
  • Authentication Basic : to ask for a basic auth when reaching this vhost (all valid users of sme server)
  • Authentication LemonLDAP : to ask for a smeserver-lemonldap-ng when reaching this vhost
  • ProxyPassTarget target of the ProxyPassReverse and ProxyPass (default "", enable by an URL)
  • Redirect target of the RedirectMatch permanent (default "", enable by an URL)
  • Rewrite target of the RewriteRule (default "" enable by an URL)
  • AllowHosts 'local' or 'IP,IP,IP...' (default "")
  • ProxyPreserveHost target of the 'ProxyPreserveHost on' (default is no, enabled is yes)
  • ProxyNoKeepAlive target of the 'SetEnv proxy-nokeepalive 1'(default is no, enabled is yes)
  • Alias target of the Alias (alias,target) (default "")
  • SetEnv target of the SetEnv (parameter,parameter) (default "")
  • AllowGroups all groups listed will be granted by LDAP to browse the web directory (group1,group2,group3) (default "")

You can create a domain like this:

db domains set stuff.foo.fr domain Description "My super custom app" Content Primary Nameservers internet TemplatePath WebAppVirtualHost DocumentRoot /opt/stuff RequireSSL enabled
signal-event domain-create stuff.foo.fr

Bugs

Sources for this contribs can be found in Firewall Service's repository [1]