Introduction

Le service Shellinabox est un outil d'administration à distance par le web. Il est codé en C et s'installe sous la forme d'un démon. Notre installation sera spécifique: le démon ne sera accessible que sur l'interface réseau loopback et son accès via l'extérieur sera géré avec les options de serveur mandataire inverse d'Apache qui permettra un accès sécurisé (TLS+Authentification).

Ce service est critique car il permet d'accéder à distance à un shell sur le serveur.

Pré-requis

• Pour la réinstallation de Shellinabox, une connexion à Internet est indispensable, ne serait-ce que pour télécharger les paquets d'installation.
• Shellinabox est destiné à être installé sur une distribution Debian Wheezy de base.
• Pour effectuer une remise en service de Shellinabox, il est indispensable d'avoir réinstallé un serveur web fonctionnel.

Installation du logiciel

# aptitude install shellinabox

Répertoires concernés

• L'éxécutable de shellinabox est stocké dans /usr/bin/shellinaboxd.
• Les fichiers de configuration de shellinabox est situé dans /etc/shellinabox/. Ce répertoire contient essentiellement les CSS de l'application.
• Il existe un fichier de configuration par défaut qui permet de modifier le comportement du démon shellinabox: /etc/default/shellinabox.

Restaurations

Le seul élément à restaurer est la configuration du service. Se référer à la procédure de restauration générique pour y parvenir.

# restore shellinabox /etc/default/
# chown root:root /etc/default/shellinabox

Normalement, la configuration du service est assurée par cette restauration. En cas de problème avec la sauvegarde, on pourra utiliser le fichier suivant pour configurer le service:

# Should shellinaboxd start automatically
SHELLINABOX_DAEMON_START=1
# TCP port that shellinboxd's webserver listens on
SHELLINABOX_PORT=44200
# Parameters that are managed by the system and usually should not need
# changing:
# SHELLINABOX_DATADIR=/var/lib/shellinabox
# SHELLINABOX_USER=shellinabox
# SHELLINABOX_GROUP=shellinabox
# Any optional arguments (e.g. extra service definitions). Make sure
# that that argument is quoted.
#
# Beeps are disabled because of reports of the VLC plugin crashing
# Firefox on Linux/x86_64.
SHELLINABOX_ARGS="--no-beep --localhost-only --disable-ssl" 

Configuration de l'accès via le serveur Web

Normalement, la restauration du service Apache permet de rendre Shellinabox opérationnel après son installation. Il existe un élément de configuration d'Apache dédié à Shellinabox dont voici la définition juste pour rappel:

  # Configuration Shellinabox
  ProxyRequests Off
  ## Shellinabox sera disponible à l'emplacement /xxxx
  <Location /xxxx>
    ## On active les fonctions de Mandataire inverse
    ProxyPass http://localhost:44200                                                                                                                                                    
    ProxyPassReverse http://localhost:44200                                                                                                                                             
    ## On donne l'accès à cet emplacement à tout Internet
    Order allow,deny
    Allow from all
    ## On restreint l'accès à un utilisateur dédié
    AuthName "Acces Shellinabox"
    AuthType Basic
    AuthUserFile /etc/apache2/webdav-users
    Require user theadminuser
  </Location> 

De plus, Shellinabox nécessite des modules Apache à activer. Ces derniers ont été normalement activés lors de la restauration du service Apache mais les voici pour rappel:

# a2enmod proxy proxy_http

Procédure de vérification du service

• Se connecter sur https://medspx.fr/###### et vérifier qu'une authentification HTTP Basic est bien demandée.
• Se connecter avec un compte utilisateur connu et vérifier que le service fonctionne correctement.