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',
Si la prise en charge des modification n'est pas effective malgré l'enregistrement des modifications, vider le cache du navigateur.

Accès invités

Si le serveur Ejabberd dispose d'un hôte virtuel compatible avec l'authentification anonyme, alors XMPP-WEB pourra être configuré pour offrir un accès invité / anonyme aux utilisateurs.

Pour de plus amples informations sur la configuration de cette fonctionnalité sur le serveur Ejabberd, se reporter à l'article Définir un hôte pour les connexions invitées

  • Editer le fichier de configuration local.js présent à la racine, puis vérifier que le paramètre hasGuestAccess soit définit à true :
 hasGuestAccess: true,
  • Rechercher également le paramètre anonymousHost puis indiquer le nom de l'hôte virtuel configuré pour les connexions anonymes :
 anonymousHost: 'public.geocoucou.im',
Si la prise en charge des modification n'est pas effective malgré l'enregistrement des modifications, vider le cache du navigateur.