Cloudy web UI

From Guifi - Media-pool Common Repository

Revision as of 20:12, 12 May 2015 by Conxuro (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Introduction

The Cloudy web User Interface (UI) uses an application called cDistro [1].

(Add what it is)


Configuration

The cDistro configuration is placed in /etc/cdistro.conf

By default it has the following format:

#cdistro config
SERVER="/usr/bin/php"
OPTS=""
BINDIP="0.0.0.0"
PORT="7000"
DOCROOT="/var/local/cDistro"
# SSHAUTH=1 <- check user with ssh2 connection http://www.php.net/manual/en/function.ssh2-auth-password.php (Require: libssh2-php)
SSHAUTH=1
# LOGIN="root"
## PASSWORD = md5(md5('secret')) => php -r 'echo md5(md5("secret"))."\n";'
#PASSWORD="7022cd14c42ff272619d6beacdc9ffde"
PORT_SSL=7443


SERVER

The path of the PHP executable.

Example:

  • "/usr/bin/php" - in the case of Cloudy (Debian).


OPTS

PHP options.

(Add references or more info and an example)


BINDIP

The IP address where the service will be listening.

Example:

  • "127.0.0.1" - will accept only petitions from localhost.
  • "0.0.0.0" - will accept petitions from any address.


PORT

The port opened by the service to listen to requests.

Example:

  • "7000" - opens the port 7000.


DOCROOT

The path of the cDistro application.

Example:

  • "/var/local/cDistro" - in the case of Cloudy.


SSLAUTH

Parameter that allows authentication via SSH2 in the application, i.e., to use the credentials that the SSH server of the system allows.

Can be 0 or 1.

Example:

  • "1" - actives this option.
  • "0" - disables this option (will require to define user and password).


LOGIN

The username to authenticate against the application.

Should be a string without spaces.

Example:

  • "cloudy" - this user can log-in with the password of PASSWORD.


PASSWORD

The password of the user defined in LOGIN.

Should be a hash over a hash MD5 (hexadecimal), i.e., a hash of the password hash: md5(md5("PASSWORD")).


Example:

  • "46d934e0f59ff1e2272f9f5f7950e5d9" - the hash of the string "PASSWORD".

Examples of how to generate that hash in a terminal:

$ php -r 'echo md5(md5("PASSWORD"))."\n";'
46d934e0f59ff1e2272f9f5f7950e5d9
$ printf "PASSWORD" | md5sum | awk '{printf $1}' | md5sum | awk '{print $1}'
46d934e0f59ff1e2272f9f5f7950e5d9


PORT_SSL

Port that Cloudy will use in the web interface with HTTPS (if SSL is enabled).

Example:


References

  1. cDistro git repository: http://dev.cloudy.community/Guifi.net/web-interface
Personal tools