diff --git a/README.md b/README.md index d5decc7..4ded370 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,110 @@ -# Service AUDIO +# Service audio.chalec.org +Service d'audio-conférence du chaton de Libre en communs basé sur le logiciel libre Mumble : https://www.mumble.info/. + +Responsable: Christian Momon (@cpm) + +/!\/!\/!\/!\/!\/!\/!\ +RÉDACTION EN COURS +/!\/!\/!\/!\/!\/!\/!\ + +# Site web + +Pour l'instant : +- le service Mumble n'a pas besoin de serveur web ; +- décision de ne pas installer une application de client web pour Mumble. + +Cela n'empêchera pas les gens d'essayer d'aller sur la page web https://audio.chalec.org/. + +Donc une page d'information permet d'apporter une réponse à ce cas, par exemple en donnant des informations sur comment se connecter, comment configurer son client, où trouver un client… + +Il s'agit d'une simle page XHTML faite à la main et placée dans `/var/www/audio.chalec.org/`. + +# Service Mumble + +Service d'audio-conférence basé sur le logiciel libre Mumble : https://www.mumble.info/ + +## Installation + +Ouvrir les ports nécessaires : +``` +ufw allow 64738/udp +ufw allow 64738/tcp +``` + +Installer le paquet : +``` +apt-get install mumble-server +``` + +Configurer, notamment le mot de passe de SuperUser : +``` +dpkg-reconfigure mumble-server +``` + +Transmettre le mot de passe à l'équipe. + +## Gestion du certificat + +Utiliser le certificat SSL du site web `audio.chalec.org` pour enrichir le fichier `/etc/mumble-server.ini` : +``` +sslCert=/etc/letsencrypt/live/audio.chalec.org/fullchain.pem +sslKey=/etc/letsencrypt/live/audio.chalec.org/privkey.pem +``` + +Rendre les certificats lisibles par Mumble : +``` +chgrp mumble-server /etc/letsencrypt/archive/audio.chalec.org/privkey* +chmod g+r mumble-server /etc/letsencrypt/archive/audio.chalec.org/privkey* +``` + +À noter que cela suffit même en cas de regénération du certificat. En effet, Certbot a l'intelligence de propager le groupe et les permissions du groupe des certificats précédents ! C'est même indiqué dans la documentation officielle, https://eff-certbot.readthedocs.io/en/stable/using.html : +``` +privkey.pem + Private key for the certificate […] + + Note: As of Certbot version 0.29.0, private keys for new certificate + default to 0600. Any changes to the group mode or group owner (gid) + of this file will be preserved on renewals. +``` + +Redémarrer le service Mumble : +``` +systemctl restart mumble-server +``` + +## Personnalisation + +### Amélioration de la qualité + +Dans le fichier `/etc/mumble-server.ini` : +``` +bandwidth=100000 +``` + +### Modifier le message d'accueil à la connexion +Dans le fichier `/etc/mumble-server.ini` : +``` +welcometext="
Bienvenue sur le service d'audio-conférence de Chalec.
https://audio.a-lec.org/
" +``` + +Pour mettre une image dans le message de bienvenue : +- générer une image assez petite en format png ; +- la convertir en base64 : ` cat chalec-logo.png | base64 -w 0 > t` +- insérer le contenu de `t` dans le code `
` + +### Renommer la racine +Par défaut, la racine est nommée « Root ». Pour la renommer, éditer `/etc/mumble-server.ini` : +``` +registerName=Chalec +``` + +### Salons temporaires +Pour autoriser la création de salons temporaires : +- se connecter en tant que SuperUser +- racine > souris bouton droit > onglet LCA +- cadre permissions : cocher « Créer des temporaires » +- cliquer sur « OK ». + +### Salons par défaut +Pour créer des salons par défaut, se connecter avec le compte `SuperUser` et faire clique-droit sur la racine puis `Ajouter`.