Etape 0 - Installation des pré-requis

Nous allons installer toute une série de dépendances qui serviront de base pour SSH, VNC et RDP :

sudo apt install libcairo2-dev libjpeg62-turbo-dev libpng-dev libtool-bin libossp-uuid-dev freerdp2-dev libpango1.0-dev libssh2-1-dev libvncserver-dev libssl-dev libwebp-dev make

Etape 1 - installation de la version serveur d'Apache Guacamole

Consultez la page suivante pour trouver la dernière version de Guacamole :

https://guacamole.apache.org/releases/1.1.0/

👨‍🏫 Attention astuce :

Les liens présentés sur la page ne vous mènent pas directement aux fichiers. Ces liens ouvrent une page php qui génère ensuite un téléchargement dans votre navigateur. Vous ne pouvez donc pas faire un clic droit sur les liens pour les copier.

La manipulation à faire est la suivante :

Rendez-vous sur la page contenant les liens
Ouvrez la console de votre navigateur et allez dans network : CTRL+MAJ+I > Network
Cliquez sur un lien et annulez le téléchargement
Regardez dans la console, vous y trouverez les liens de téléchargement direct

Au moment de l'écriture de cet article, le bon lien se trouvent ici pour la version serveur :

https://mirrors.ircam.fr/pub/apache/guacamole/.........

Téléchargez dans le dossier /tmp :

cd /tmp

curl -O .... ou wget ......

tar -xzf guacamole-server-1.1.0.tar.gzcd guacamole-server-1.1.0/./configure --with-init-dir=/etc/init.d

Une fois que vous avez exécuté la commande configure ci-dessus, vous verrez quelles bibliothèques ont été trouvées et ce que le serveur prend en charge.

Make est un logiciel qui construit automatiquement des fichiers, souvent exécutables, ou des bibliothèques à partir d'éléments de base tels que du code source.

makesudo make install

La commande Linux ldconfig crée les liens et le cache nécessaires (à utiliser par l'éditeur de liens d'exécution, ld.so ) vers les bibliothèques partagées les plus récentes trouvées dans les répertoires spécifiés sur la ligne de commande, dans le fichier /etc/ld.so. conf , et dans les répertoires approuvés ( / usr / lib et / lib ). Il vérifie les noms d'en-tête et de fichier des bibliothèques qu'il rencontre pour déterminer quelles versions doivent avoir leurs liens mis à jour; il ignore les liens symboliques lors de la recherche de bibliothèques.

Vous l'utilisez généralement si vous obtenez des erreurs concernant certaines bibliothèques liées dynamiquement qui ne sont pas trouvées lors du démarrage d'un programme alors qu'elles sont réellement présentes sur le système.

sudo ldconfig

Maintenant, le serveur devrait être installé. Vous pouvez le démarrer en exécutant la commande suivante (veuillez noter qu'avec ce guide, vous devez entrer cette commande chaque fois que vous redémarrez votre serveur) :

sudo guacd

Etape 2 - installation de la version client d'Apache Guacamole

Retournez sur la page de téléchargement de guacamole et cherchez cette fois-ci le lien de la version client (guacamole-1.1.0.war).

Téléchargez avec curl ou wget.

Changez le nom du fichier une fois téléchargé :

mv guacamole-1.1.0.war guacamole.war

Copiez-le dans le répertoire webapps d'Apache Tomcat :

sudo cp guacamole.war /opt/tomcat/webapps/

Redémarrez ensuite le serveur Apache Tomcat.

sudo service tomcat restart

Etape 3 - configuration d'Apache Guacamole

Cette partie est basé sur le chapitre 5 du manuel de guacamole. Si vous avez besoin de plus d'informations, consultez ce lien :

https://guacamole.apache.org/doc/gug/configuring-guacamole.html

Tapez les commandes suivantes pour créer le dossier et les fichiers de configuration :

sudo mkdir /etc/guacamolecd /etc/guacamolesudo touch guacamole.propertiessudo touch user-mapping.xml

Configurez le fichier guacamole.properties comme suit :

guacd-hostname: localhostguacd-port: 4822

Configurez le fichier user-mapping.xml comme suit :

<user-mapping> <authorize username="username" password="password"><connection name="ma debian"><protocol>ssh</protocol><param name="hostname">127.0.0.1</param><param name="port">22</param><param name="username">root</param></connection><connection name="windows10"><protocol>à votre avis ? en trois lettre, commence par un R</protocol><param name="hostname">ip à renseigner</param><param name="port">le port rdp c'est le combien ?</param><param name="security">nla</param><param name="ignore-cert">true</param><param name="username">username</param><param name="password">password</param></connection> </authorize> </user-mapping>

Exemple d'entrée utilisateur avec mot de passe généré avec un hachage md5:

<authorize username="USERNAME2" password="319f4d26e3c536b5dd871bb2c52e3178" encoding="md5">

Etape 4 - testez !

Connectez vous à l'application Guacamole avec le lien suivant :

http://ip_du_serveur:8080/guacamole

Votre objectif est de réussir à vous connecter à :

votre debian en root (machine sur laquelle est hébergé Tomcat)
une vm windows que vous avez sous le coude 😉

Fin du TP

Troubleshooting

Si la connexion avec votre windows 10 ne fonctionne pas, essayez la manipulation suivante :

sudo systemctl restart tomcatsudo ldconfigsudo guacd

Puis réessayez de vous connecter dans guacamole à votre windows 10.

Si çà ne fonctionne toujours pas, essayez la manipulation suivante :

sudo guacd -b IP

où IP est l'IP de la machine windows 10.

Jetez également un oeil au log :

/opt/tomcat/logs/catalina.out

Exemple d'erreur dans les logs :

Creation of WebSocket tunnel to guacd failed: java.net.ConnectException

Installation de guacamole serveur et client