Différences

Ci-dessous, les différences entre deux révisions de la page.

--- admin:chatons:xmpp [2019/10/19 07:12] – Service XMPP mise à jour pitchum
+++ admin:services:xmpp.chapril.org [2020/12/05 11:59] – [Augmenter la verbosité des logs] neox
@@ Ligne 2: / Ligne 2: @@
 ====== Service xmpp.chapril.org ======
-<note important>**TODO**
-  * définir une durée de rétention des données http_upload (1 an pour l'instant)
-  * définir des quotas de stockage des données http_upload (200Mo pour l'instant)
-  * définir les règles de modération à l'inscription (aucune pour l'instant)
-  * personnaliser le message d'accueil reçu automatiquement sur le client XMPP lors de la création du compte
-</note>
 ===== Aspects notables de cette instance XMPP =====
@@ Ligne 25: / Ligne 18: @@
 Lors de l'inscription un captcha simpliste est présenté, limitant ainsi la création de comptes massive par des bots.
-Cela dit le captcha est réellement simpliste et il n'est pas impossible qu'un jour des bots soient capables de le déjouer.
+Cela dit le captcha est réellement simpliste et il n'est pas impossible qu'un jour des bots soient capables de le déjouer, mais la création de compte automatisée est tout de même rendue difficile par la règle [[https://docs.ejabberd.im/admin/configuration/toplevel/#captcha-limit|captcha_limit]], configurée à 10, qui limite le nombre de captcha émis par JID/IP par minute.
 ==== Quotas de stockage ====
-Les données partagées (photos, vidéos, pdf, ...) sont stockées pendant 365 jours maximum.
+Les données partagées (photos, vidéos, pdf, ...) sont stockées pendant 380 jours maximum.
+C'est un peu plus qu'une année et ça peut être utile par exemple à un repas de famille annuel où on aimerait revoir une photo prise l'an passé.
 Chaque compte dispose d'un quota de 200 Mo pour ces données.
@@ Ligne 50: / Ligne 43: @@
   * TCP 5223 : xmpps-client
   * TCP 5269 : xmpp-server
+  * TCP 3478 : _stun et _turn
+  * TCP 5349 : _stuns et _turns
 <note important>**TODO** : clarifier la situation actuelle concernant le routage IPv6</note>
@@ Ligne 58: / Ligne 53: @@
 <note important>**TODO** : détailler la génération de certificats DNS
+En attendant, [[admin:services:mumble.chapril.org#configuration_certificat|la doc correspondante pour mumble]] devrait suffire (à mutualiser peut-être ?)
   * pourquoi du DNS-challenge sur xmpp et du HTTP-challenge sur bastion ?
@@ Ligne 83: / Ligne 80: @@
 _xmpp-client._tcp.chapril.org.         86400   IN      SRV 10 10 5222  xmpp.chapril.org.
 _xmpps-client._tcp.chapril.org.        86400   IN      SRV  5 10 5223  xmpp.chapril.org.
-; un jour peut-être, pour les flux audio/vidéo
+_stun._udp.chapril.org.                86400   IN      SRV 10 10 3478  xmpp.chapril.org.
-;_stun._udp.xmpp.chapril.org.                86400   IN      SRV 10 10 3478  xmpp.chapril.org.
+_stun._tcp.chapril.org.                86400   IN      SRV 10 10 3478  xmpp.chapril.org.
-;_stun._udp.jabber.xmpp.chapril.org.         86400   IN      SRV 10 10 3478  xmpp.chapril.org.
+_stuns._tcp.chapril.org.               86400   IN      SRV 10 10 5349  xmpp.chapril.org.
+_turn._tcp.chapril.org.                86400   IN      SRV 10 10 3478  xmpp.chapril.org.
+_turn._udp.chapril.org.                86400   IN      SRV 10 10 3478  xmpp.chapril.org.
+_turns._tcp.chapril.org.               86400   IN      SRV 10 10 5349  xmpp.chapril.org.
 _xmppconnect.chapril.org.   86400   IN      TXT        "_xmpp-client-xbosh=https://xmpp.chapril.org/bosh"
@@ Ligne 111: / Ligne 111: @@
 <code bash>
 psql -U ejabberd -h localhost ejabberd < /usr/share/ejabberd/sql/pg.new.sql
+</code>
+<note>
+**TODO** lister les principaux éléments de configuration dans le fichier ///etc/ejabberd/ejabberd.yml//
+</note>
+===== Modération =====
+==== Désactiver un compte ====
+Génère un mot de passe aléatoire pour un compte et ferme immédiatement toutes les sessions actives de ce compte .
+(encore jamais testé)
+<code bash>
+sudo -u ejabberd ejabberdctl ban_account <username> chapril.org
+</code>
+Si besoin de réactiver le compte, il faut lui affecter un nouveau mot de passe (il n'est pas possible de restaurer le précédent) et le communiquer à son propriétaire.
+<code bash>
+sudo -u ejabberd ejabberdctl change_password <username> chapril.org <nouveau_mot_de_passe>
+</code>
+==== Supprimer ====
+Pour supprimer définitivement un compte :
+<code bash>
+sudo -u ejabberd ejabberdctl unregister <username> chapril.org
 </code>
@@ Ligne 116: / Ligne 145: @@
 ===== Maintenance =====
+==== Consulter les logs ====
+<code bash>
+tail -f /var/log/ejabberd/ejabberd.log | ccze -A
+</code>
+==== Augmenter la verbosité des logs ====
+Ouvrir le fichier ///etc/ejabberd/ejabberd.yml// et passer le paramètre //loglevel: 3// à 4 ou 5 pour avoir plus d'infos.
+Pour prendre en compte le changement sans redémarrer le service :
+<code bash>
+sudo -u ejabberd ejabberdctl reload_config
+</code>
+Autre possibilité : augmenter temporairement la verbosité avec la commande :
+<code bash>
+sudo -u ejabberd ejabberdctl set_loglevel loglevel
+</code>
+==== Relancer le service ====
+Recharger le service sans interruption (après avoir modifié une configuration par exemple) :
+<code bash>
+sudo -u ejabberd ejabberdctl reload_config
+</code>
+Sinon, quand on n'a pas le choix, stopper et relancer le service (avec quelques secondes d'interruption) :
+<code bash>
+systemctl restart ejabberd
+</code>
+==== Consulter l'état global du service ====
+<note>Les commandes ci-dessous peuvent être utilisées pour créer des sondes de métrologie et/ou de supervision.
+La liste exhaustive des commandes possibles : <code>sudo -u ejabberd ejabberdctl help | less</code>
+</note>
+**Lister les connexions établies avec d'autres serveurs XMPP (aka. connexions s2s)**
+<code bash>
+sudo -u ejabberd ejabberdctl incoming_s2s_number
+sudo -u ejabberd ejabberdctl outgoing_s2s_number
+</code>
+**Nombre de comptes**
+Nombre total de comptes créés et nombre de sessions actives.
+Attention, il peut y avoir plusieurs sessions simultanées pour un même compte.
+<code bash>
+sudo -u ejabberd ejabberdctl registered_users chapril.org | wc -l
+sudo -u ejabberd ejabberdctl connected_users_number
+</code>