Cloudy web UI

Introduction

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

(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:

• "7443" - access to the web interface in https://IP_SERVIDOR:7443.