N2SVCD Configuration - ManageApp

Management Application Configuration

The N2SVCD Management Application provides a simple HTTP server to which operators can connect in order to view the current N2SVCD running configuration. Drilldown links allow operators to monitor in-use resources (e.g. to check connection status, and to review long-running calls in progress).

The following configuration is used to create a Management Application instance. You should only ever require one Management Application instance within the N2SVCD.

When the N2SVCD is running, you can connect your web browser to the N2SVCD Management interface at the address http://<n2svcd-host>:8088/.

<?xml version="1.0" encoding="utf-8"?>
<n2svcd>
  ...
  <applications>
    ...
    <application name="Manager" module="ManageApp">
      <include><lib>../apps/manage/lib</lib></include>
      <parameters>
        <parameter name="http_host" value="10.42.2.154"/>
        <parameter name="http_port" value="8088"/>
        <parameter name="security" value="sha1"/>
        <parameter name="admin_password" value="LSNb2Q/UBFfpT.hd:gdiyvTHqk+lnJqogbloOBzTGIC8"/>
        <parameter name="user_password" value="SuLk1c4I3tAEV4lj:TTHJaIHmkGxQKf+4Z3bZE2d48Cg"/>
      </parameters>
    </application>
    ...
  </application>
  ...
</n2svcd>

The application element attributes for a Manage Application instance are:

Attribute Type Description
name String [Required] A unique name for this application instance.
module String [Required] ManageApp
include.lib String [Required] ../apps/manage/lib
parameters Array [Required] Array of name = value Parameters for this Application instance.
.http_host String IPv4 Host Name or A.B.C.D IPv4 Address on which to listen for management requests.
(Default = 0.0.0.0).
.http_port Integer IPv4 Port Number on which to listen for management requests.
(Default = 8088).
.http_dir String Directory containing static resource files for HTML management interface.
(Default = ../apps/manage/html).
.security String Specifies how passwords are encoded: open (Administrator access granted to all users), closed (All access is denied), plain (Passwords are configured without encryption), sha1 (Passwords are stored as SHA1 hash), bcrypt (Passwords are stored as a Bcrypt hash).
(Default = plain).
.admin_password String The password for the admin user. For security = none this password is not used. For security = plain this is a plaintext password. For other types of security this is the hashed version of the password including a salt prefix.
(Default = No admin Password).
.user_password String The password for the user user. For security = none this password is not used. For security = plain this is a plaintext password. For other types of security this is the hashed version of the password including a salt prefix.
(Default = No user Password).

Generating Hashed Passwords

When using the sha1 and bcrypt methods to store passwords, the value to be written into the database must be generated using the mkpasswd program supplied with the n2svcd daemon. This program is normally installed as /usr/share/n2svcd/bin/mkpasswd.

$ cd /usr/share/n2svcd/bin
$ ./mkpasswd sha1
Password:
Re-Enter:
[Encrypted] = SuLk1c4I3tAEV4lj:TTHJaIHmkGxQKf+4Z3bZE2d48Cg

Example Management Page

An example management page is: