Shellinabox

From SME Server
Jump to navigation Jump to search


Smeserver-shellinabox for SME Server 8 and 9

This contrib is made to help the managing of the command line with a terminal in your web browser. This contribs is tested with chrome and IE, it seems that with Firefox you can have issues with certain characters, especially if your keyboard is not in English. This is the official website to report issues on shellinabox

Maintainer

stephdl Stéphane de Labrusse AKA Stephdl

Description

The purpose is to have in the server-manager an ajax web based emulator instead to use putty or a terminal. The RPM comes from epel...This contribs is done either for sme8 or sme9

Requirements

You need to enable the stephdl and epel repositories

Installation

Remember to first configure the required stephdl and epel repositories, then issue the following command on the SME Server shell:

yum install smeserver-shellinabox --enablerepo=stephdl,epel

The 'official' way is to perform

signal-event post-upgrade;  signal-event reboot

but if you don't want to reboot your server, do

signal-event console-save

or

signal-event shellinaboxd

now you can use the contrib in the server-manager or with the url https://sme-host_or_ip/shell

Go to the panel of shellinabox on Server Manager (ssh via a web browser) and use the credentials of root to login, think to test the right clic, you will find other options.

this is the default DB value

# config show shellinaboxd 
shellinaboxd=service
   FixedIP=                  #You can precise which IP can connect (You have to set PublicAccess to IP)
   Name=shell                #You can change this folder if you want
   PublicAccess=local        #local=localnetwork,global=internet,IP=one IP allowed,none=no access
   ShellUsers=               #SME users allowed to use shellinabox only through the apache authentication, use coma to separate users : user1,user2,user3
   TcpPort=1870              #You can change the port if you want
   WebAuth=disabled          #Force or not the apache authentication : enabled/disabled
   status=enabled            #enabled or disabled
  • Admin or ShellUsers are real users of server-manager with their credentials (used only for the http authentication).
  • HTTPS is always forced.
  • The Apache authentication is only forced if the PublicAccess is not set to local, you have to authenticate throught apache with admin or using ShellUsers.
  • If you want you can force the apache authentication with the DB WebAuth (set it to enabled to enforce).

for example :

config setprop shellinaboxd PublicAccess global
signal-event shellinaboxd

Uninstall

yum remove smeserver-shellinabox; signal-event console-save

Bugs

For now there is no entry on bugzilla, please direct your issue to stephdl Stéphane de Labrusse AKA Stephdl