XMPP-WEB

De NCad Wiki
Aller à la navigation Aller à la recherche

Présentation

XMPP-WEB est client web léger de messagerie instantané intégrant les fonctionnalités de base du protocole XMPP.

Prérequis

  • Disposer d'un hébergement web avec ses identifiants de connexion SFTP pour le transfert du script XMPP-WEB. Vous pouvez consulter l'article Création d'un Vhost http .
  • Avec un pointage DNS opérationnel sur l'hébergement web mentionné plus haut. Pour cette documentation le domaine utilisé est xmpp-web.domaine.tld. Vous pouvez consulter l'article Création d'une zone DNS sur Bind9 .
  • Disposer d'un serveur de messagerie instantané opérationnel avec un connecteur WEBSOCKET fonctionnel. Vous pouvez consulter l'article Installation d'un serveur Ejabberd

Configuration

Téléchargement du logiciel

  1. Se rendre sur le site web de l’éditeur à l’adresse https://github.com/nioc/xmpp-web.
  2. Depuis la page d’accueil, cliquer sur le bouton Code puis sur le lien Download ZIP.
  3. Extraire le contenu de l’archive .zip.
  4. Transférer son contenu sur le serveur d’hébergement web à la racine /var/www/xmpp-web/0.10.2. Pour cela, ouvrir une connexion SFTP au serveur avec les identifiants xmppweb.
  5. Attribuer les permission lecture+écriture sur tout le dossier pour tout le monde.

Installation

  • Téléchargement de la version 0.10.2 de XMPP-WEB dans le répertoire web :

wget https://github.com/nioc/xmpp-web/releases/download/0.10.2/xmpp-web-0.10.2.tar.gz

  • Extraction de l'archive :

tar -xzvf xmpp-web-0.10.2.tar.gz

  • Mise à jour des droits sur le dossier :

chown www-data ./* -R

Paramétrage

Pour illustrer cette article, nous prenons les paramètres de connexion du serveur de messagerie instantanée Ejabberd de Geocoucou Mail.

  • Editer le fichier de configuration local.js présent à la racine, puis rechercher la ligne :
transports: {
  websocket: 'wss://chat.domain-web.ltd/xmpp-websocket',
},
  • Puis adapter l'url en fonction de l'url du connecteur WEBSOCKET serveur XMPP :
transports: {
  websocket: 'wss://wss.geocoucou.im/ws',
},
  • Rechercher la ligne suivante :
defaultDomain: 'domain-xmpp.ltd',
  • Puis indiquer le domaine de messagerie du service XMPP :
defaultDomain: 'geocoucou.im',
  • Rechercher la ligne suivante :
defaultMuc: null,
  • Puis indiquer le domaine du service de groupes de discussion XMPP :
defaultMuc: 'conference.geocoucou.im',