Configuration

The Webis configuration file is located at /etc/acrobits/webis/settings/common.xml. Most configuration options have default values that can be used as they are. The only value that has to be set up during installation is RTP Proxy address, as described in the installation guide.

The following is explanation of sections of the configuration files.

<Webis ProvisioningUri="https://providers.cloudsoftphone.com/export/features/production/%fullcode%" >
  <AlternativeProvisioningUris
    Production="https://providers.cloudsoftphone.com/export/features/production/%fullcode%"
    Beta="https://providers.beta.cloudsoftphone.com/export/features/production/%fullcode%" />
</Webis>

This section tells Webis location where to find the information about your application. %fullcode% parameter is usually your CloudID. This section should not be changed unless Acrobits representative instructs you to do so.

<WebSocketServer Address="" Port="4210" Path="/webis">
</WebSocketServer>

This section tells Webis to listen on all interfaces and addresses on port 4210 and accept requests on /webis path. You can chenge the values if desired but you need to adjust nginx configuration if you change it.

<HttpServer Enabled="Yes" Address="" Port="4280">
    <DigestAuthentication Realm="webis">
        <User Name="admin" Md5NameRealmPassword="00000000000000000000000000000000" />
    </DigestAuthentication>
</HttpServer>

This sections configures internal HTTP server of Webis which provides Webis control panel. The control panel is protected by HTTP digest authentication. To set it up, choose user name (default is admin), realm (webis) and a password (the default configuration does not contain valid password). Configure realm and username directly. For Md5NAmeRealmPassword use the string outputed by the following command:

echo -n username:realm:password | md5sum

For example if you want to keep user name admin, realm webis and set password to mypassword you would run

echo -n admin:webis:mypassword | md5sum

It would output 028c34e01bcb080871c72abec51efdc1 - and you would set 028c34e01bcb080871c72abec51efdc1 as Md5NAmeRealmPassword parameter.

<Sip><AccountDefaultProps></AccountDefaultProps></Sip>

This section sets default values of various configuration options for user’s accounts. See Account XML documentation for possible properties and their values.

<RtpProxy>
    <PortRangeForWeb First="" Last="" />
    <PortRangeForSip First="" Last="" />
    <Addresses>
        <Address Ip="X.X.X.X" PublicIp="Y.Y.Y.Y"/>
    </Addresses>
</RtpProxy>

This section configures RTP Proxy in Webis. Set both addresses to IP address of your server. If your server is behind 1:1 NAT (for example at Amazon AWS), change X.X.X.X to IP address on server’s interface and Y.Y.Y.Y to the public address of your server. You can add additional Address for IPv6 (without PublicIp attribute).

Port ranges are used for RtpProxy. You can limit them if you require. The ports in the range need to be open on your firewall.

<Sentry Enabled="No" Dsn="" ServerName="">

Webis can report problems to Sentry <https://sentry.io/>. If you use Sentry, you can set up Dsn attribute so that the problems are reported.

<Debug Enabled="Yes" FilePath="/var/log/webis/webis.log"/>

The location where Webis writes its debug log. Webis also sends debug output to stderr.

Note

The current version of webis has a bug and does not produce this log. The fixed version will be released shortly.

<WritableDirectory Path="/var/lib/webis" />

The directory where Webis can store data. It needs to be writable by webis. Webis will store logs and pcaps for separate instances when instructed to do so from its http control panel.