The sys admin's daily grind: Shell In A Box

Sea Shells in a Box

Article from Issue 167/2014
Author(s):

At some point, any service that can't run fast enough will be put on the web. So, why not do this for remote login? With a little JavaScript and CSS wizardry, a software tool called "Shell In A Box" sends a shell to the browser.

The web login tool I am looking at today is available in many distributions, or you can download it from the website [1]. I got Shell In A Box to jump onto my Kubuntu lab machine like this:

apt-get -fym install shellinabox

It runs as a service in the background, normally listening on port 4200. When I then surf to localhost:4200, I see the Bash login prompt and can log on and go about my work in the normal way (Figure 1). It doesn't even have to be a full login. I can also redirect the output from programs running in Bash to the web.

Figure 1: With the Shell In A Box web server running on a server, admins can use their browsers to address it; the reward for doing so is a Bash login.

Shell In A Box is easily configurable. Typing

shellinaboxd -t--localhost-only -p 8001--no-beep -s'/htop/:nobody:nogroup:/:htop-d 5'

beams the Htop process monitor into the web. The -t parameter disables SSL encryption, which is enabled by default. Switching this off here is less critical than you might think, because I am only letting Shell In A Box listen locally on 127.0.0.1 – in a box in the true sense of the word. If you don't like the idea of the default port (4200), you can choose a different one; this is handled by -p 8001 in my example. The --no-beep option disables the annoying notification tones.

Miscellaneous Crustaceans

The -s parameter is followed by the actual shell command, whose output you want to display in the browser. You can do this with multiple box shell instances at the same time, which is why I specified a URL (/htop) to distinguish between the instances. To see the output, I thus need to enter a URL of http://127.0.0.1/htop in my browser's address bar. The results look like Figure  2.

Figure 2: The Htop process monitor running in Shell In A Box. Despite being displayed in the browser, hotkeys like M still work.

Besides statically displaying the typical text flow from standard command-line tools, the browser also supports interactive working, assuming that the tools you use have an interactive mode. For example, if you press the M key in the Htop output, the browser shows the processes sorted in descending order by memory requirement, just as in the native command line.

As always in production operations, I would advise caution with the shellinaboxd. If you export your Bash to the web, you should at least insist on HTTPS. The user rights also need to be as conservative as possible, as shown in the Htop example, where I specified nobody:nogroup.

Charly Kühnast

Charly Kühnast is a Unix operating system administrator at the Data Center in Moers, Germany. His tasks include firewall and DMZ security and availability. He divides his leisure time into hot, wet, and eastern sectors, where he enjoys cooking, freshwater aquariums, and learning Japanese, respectively.

Buy this article as PDF

Express-Checkout as PDF
Price $2.95
(incl. VAT)

Buy Linux Magazine

SINGLE ISSUES
 
SUBSCRIPTIONS
 
TABLET & SMARTPHONE APPS
Get it on Google Play

US / Canada

Get it on Google Play

UK / Australia

Related content

  • PHP Shell and Shell in a Box

    Firewalls often block shell access for remote users on a corporate network or at an Internet cafe. Luckily, tools like PHP Shell and Shell in a Box put the shell in a browser window.

  • Charly's Column: Terminator

    Friends are all about friendship – names and appearances typically don’t play any role at all. Sys admin Charly’s friend the Terminator is a convincing example.

  • Charly's Column

    Worms, mail bombs, and users who send multiple megabyte Powerpoint files across the wire give Postfix administrators plenty of reasons to view their charges with a critical eye from time to time.

  • Charly's Column

    Parallel SSH is the name of an easy-to-configure tool that our resident sys admin, Charly, now routinely deploys whenever he needs to launch the same programs, copy the same files, or kill the same processes simultaneously on multiple computers.

  • Charly's Column: Mosh

    Dangling your legs in the sea while enjoying the Mediterranean sunshine can affect the prospect of a good Internet connection; fortunately, Charly knows what to do.

comments powered by Disqus

Direct Download

Read full article as PDF:

Price $2.95

News